AWS aurora-dsql documentation change
Summary
Minor wording updates and clarifications throughout the document, including changing 'execute' to 'run', 'does not' to 'doesn't', and adding more descriptive link texts. Clarifies that Query Editor doesn't support clusters with blocked public access or VPC endpoints.
Security assessment
Changes are editorial improvements without addressing vulnerabilities. The mention of public access restrictions is a clarification of existing limitations, not a new security feature or vulnerability fix.
Diff
diff --git a/aurora-dsql/latest/userguide/getting-started-query-editor.md b/aurora-dsql/latest/userguide/getting-started-query-editor.md index f9b19cfd5..7dbe8a9af 100644 --- a//aurora-dsql/latest/userguide/getting-started-query-editor.md +++ b//aurora-dsql/latest/userguide/getting-started-query-editor.md @@ -9 +9 @@ PrerequisitesWorking with the Query Editor -With the Aurora DSQL Query Editor, you can securely connect to your Aurora DSQL clusters and run SQL queries directly from the AWS Management Console without installing or configuring external clients. It provides an intuitive workspace with built-in syntax highlighting, auto-completion, and intelligent code assistance. You can quickly explore schema objects, develop and execute SQL queries, and view results, all within a single interface. +With the Aurora DSQL Query Editor, you can securely connect to your Aurora DSQL clusters and run SQL queries directly from the AWS Management Console without installing or configuring external clients. It provides an intuitive workspace with built-in syntax highlighting, auto-completion, and intelligent code assistance. You can quickly explore schema objects, develop and run SQL queries, and view results, all within a single interface. @@ -15 +15 @@ This topic walks you through the steps to connect to a cluster, run queries, vie -The Query Editor is available in all Regions where Aurora DSQL is supported. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). +The Query Editor is available in all Regions where Aurora DSQL is supported. For more details about regional availability, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). @@ -19 +19 @@ The Query Editor is available in all Regions where Aurora DSQL is supported. For -Before you begin, ensure that you meet the following requirements: +Before you begin, make sure that you meet the following requirements: @@ -21 +21 @@ Before you begin, ensure that you meet the following requirements: - * You have at least one Aurora DSQL cluster available. For more information, see [Step 1: Create an Aurora DSQL single-Region cluster](./getting-started.html#getting-started-create-cluster). + * You have at least one Aurora DSQL cluster available. For more details about creating clusters, see [Step 1: Create an Aurora DSQL single-Region cluster](./getting-started.html#getting-started-create-cluster). @@ -23 +23 @@ Before you begin, ensure that you meet the following requirements: - * Your cluster endpoint is publicly accessible. The Query Editor does not currently support clusters that have public access blocked by resource-based policies or clusters managed through VPC endpoints. For more information, see [Blocking public access with resource-based policies in Aurora DSQL](./rbp-block-public-access.html) and [Managing and connecting to Amazon Aurora DSQL clusters using AWS PrivateLink](./privatelink-managing-clusters.html). + * Your cluster endpoint is publicly accessible. The Query Editor doesn't support clusters that have public access blocked by resource-based policies or clusters managed through VPC endpoints. For more details about access restrictions, see [Blocking public access with resource-based policies in Aurora DSQL](./rbp-block-public-access.html) and [Managing and connecting to Amazon Aurora DSQL clusters using AWS PrivateLink](./privatelink-managing-clusters.html). @@ -25 +25 @@ Before you begin, ensure that you meet the following requirements: - * Your IAM user or role has the required permissions to access and connect to the cluster. For more information, see [Using database roles and IAM authentication](./using-database-and-iam-roles.html). + * Your IAM user or role has the required permissions to access and connect to the cluster. For more details about permissions, see [Using database roles and IAM authentication](./using-database-and-iam-roles.html). @@ -47 +47 @@ Alternatively, from the **Clusters** page, select the cluster you want to query -Work and connection state are not saved. If you navigate away from the Aurora DSQL console, close the browser tab, or sign out, your connections, query text, and results are lost. +Work and connection state aren't saved. If you navigate away from the Aurora DSQL console, close the browser tab, or sign out, your connections, query text, and results are lost. @@ -55 +55 @@ Work and connection state are not saved. If you navigate away from the Aurora DS - 2. (Optional) Connect to multiple clusters or to the same cluster using different roles. + 2. (Optional) Connect to multiple clusters or to the same cluster by using different roles. @@ -76 +76 @@ The Cluster Explorer displays all available cluster connections and lets you bro - 4. Choose **Run** to execute the query. + 4. Choose **Run** to run the query. @@ -89 +89 @@ After the query runs, review the output in the **Results panel** at the bottom o -To get the query execution plan, run `EXPLAIN ANALYZE` or `EXPLAIN ANALYZE VERBOSE` to get additional insights into query performance. For more information, see [Reading Aurora DSQL EXPLAIN plans](./reading-dsql-explain-plans.html). +To get the query execution plan, run `EXPLAIN ANALYZE` or `EXPLAIN ANALYZE VERBOSE` to get additional insights into query performance. For more details about execution plans, see [Reading Aurora DSQL EXPLAIN plans](./reading-dsql-explain-plans.html). @@ -93 +93 @@ To get the query execution plan, run `EXPLAIN ANALYZE` or `EXPLAIN ANALYZE VERBO -The `EXPLAIN ANALYZE VERBOSE` command surfaces DPU usage estimates, including Compute, Read, Write, and Total DPU values, providing immediate visibility into the resources consumed by individual SQL statements. +The `EXPLAIN ANALYZE VERBOSE` command surfaces DPU usage estimates including Compute, Read, Write, and Total DPU values, providing immediate visibility into the resources consumed by individual SQL statements.