AWS athena documentation change
Summary
Restructured PostgreSQL connector documentation to emphasize Glue connections as the recommended approach, added details about using Glue connections, and reorganized legacy connection information under a new 'Legacy connections' section. Also adjusted section heading levels throughout the document.
Security assessment
The changes focus on documentation structure and recommending Glue connections, but there is no specific mention of security vulnerabilities or new security features. The SSL section remains unchanged in content, only its heading level was adjusted.
Diff
diff --git a/athena/latest/ug/connectors-postgresql.md index a4219218f..8b6788cb1 100644 --- a/athena/latest/ug/connectors-postgresql.md +++ b/athena/latest/ug/connectors-postgresql.md @@ -68 +68 @@ Athena data source connectors created on December 3, 2024 and later use AWS Glue -The parameter names and definitions listed below are for Athena data source connectors created prior to December 3, 2024. These can differ from their corresponding [AWS Glue connection properties](https://docs.aws.amazon.com/glue/latest/dg/connection-properties.html). Starting December 3, 2024, use the parameters below only when you [manually deploy](./connect-data-source-serverless-app-repo.html) an earlier version of an Athena data source connector. +### Glue connections (recommended) @@ -70 +70,14 @@ The parameter names and definitions listed below are for Athena data source conn -### Connection string +We recommended that you configure a PostgreSQL connector by using a Glue connections object. + +To do this, set the `glue_connection` environment variable of the PostgreSQL connector Lambda to the name of the Glue connection to use. + +Use the following command to get the schema for a Glue connection object. This schema contains all the parameters that you can use to control your connection. + + + aws glue describe-connection-type --connection-type POSTGRESQL + +### Legacy connections + +The parameter names and definitions listed below are for Athena data source connectors created without an associated Glue connection. Use the following parameters only when you [manually deploy](./connect-data-source-serverless-app-repo.html) an earlier version of an Athena data source connector or when the `glue_connection` environment property is not specified. + +#### Connection string @@ -77 +90 @@ Use a JDBC connection string in the following format to connect to a database in -### Using a multiplexing handler +#### Using a multiplexing handler @@ -87 +100 @@ Record handler | `PostGreSqlMuxRecordHandler` -#### Multiplexing handler parameters +##### Multiplexing handler parameters @@ -102 +115 @@ Property | Value -#### Providing credentials +##### Providing credentials @@ -137 +150 @@ Currently, the PostgreSQL connector recognizes the `user` and `password` JDBC pr -#### Enabling SSL +##### Enabling SSL @@ -156 +169 @@ To enable SSL, modify the string as follows. -### Using a single connection handler +#### Using a single connection handler @@ -166 +179 @@ Record handler | `PostGreSqlRecordHandler` -#### Single connection handler parameters +##### Single connection handler parameters @@ -180 +193 @@ Property | Value -### Spill parameters +#### Spill parameters