AWS athena: Document AWS Glue endpoint override for Athena ODBC v2 driver
Summary
Adds a new 'AWS Glue endpoint override' section documenting the GlueEndpointOverride connection parameter used for multi-catalog browsing, including error behavior and a note that the Windows DSN dialog drops the parameter.
Security assessment
The change documents an endpoint-override configuration option for the Glue client. Endpoint overrides can redirect client traffic, which has network-security implications, but the text is purely a feature/config reference with no mention of a vulnerability, CVE, or hardening guidance.
Evidence
+GlueEndpointOverride | Optional | `none` | `GlueEndpointOverride=glue.us-west-1.amazonaws.com;`
Diff
diff --git a/athena/latest/ug/odbc-v2-driver-endpoint-overrides.md b/athena/latest/ug/odbc-v2-driver-endpoint-overrides.md index 61cf199..d6b67a6 100644 --- a//athena/latest/ug/odbc-v2-driver-endpoint-overrides.md +++ b//athena/latest/ug/odbc-v2-driver-endpoint-overrides.md @@ -7 +7 @@ -Athena endpoint overrideAthena streaming endpoint overrideAWS STS endpoint overrideLake Formation endpoint overrideSSO endpoint overrideSSO OIDC endpoint overrideSSO Admin endpoint overrideS3 endpoint overrideSageMaker endpoint override +Athena endpoint overrideAthena streaming endpoint overrideAWS STS endpoint overrideLake Formation endpoint overrideAWS Glue endpoint overrideSSO endpoint overrideSSO OIDC endpoint overrideSSO Admin endpoint overrideS3 endpoint overrideSageMaker endpoint override @@ -42,0 +43,12 @@ LakeFormationEndpointOverride | Optional | `none` | `LakeFormationEndpointOverri +## AWS Glue endpoint override + +The `ClientConfiguration.endpointOverride` method uses this value to override the default HTTP endpoint for the AWS Glue client that the driver uses for multi-catalog browsing. For more information, see [AWS Client configuration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html) in the _AWS SDK for C++ Developer Guide_. + +If a call to list AWS Glue catalogs fails for a reason other than an access-denied or entity-not-found error, such as throttling, catalog functions fail with SQLSTATE `HY000` and a message that begins with `[AmazonAthena][GlueClientError]`. To avoid the AWS Glue call for the top-level catalog list, set `UseSingleCatalogAndSchema=1`. For more information, see [Use single catalog and schema](./odbc-v2-driver-advanced-options.html#odbc-v2-driver-advanced-options-use-single-catalog-and-schema). + +The Windows ODBC Data Source Administrator dialog box has no field for this parameter, and saving a DSN from that dialog box removes the parameter. Set this parameter in your connection string or directly in your DSN. + +**Connection string name** | **Parameter type** | **Default value** | **Connection string example** +---|---|---|--- +GlueEndpointOverride | Optional | `none` | `GlueEndpointOverride=glue.us-west-1.amazonaws.com;` +