AWS Security ChangesHomeSearch

AWS athena: Document LogLevel validation and LogPath requirement

Service: athena · 2026-10-30 · Documentation low

File: athena/latest/ug/odbc-v2-driver-logging-options.md · Type: logging

Summary

Adds notes that unrecognized LogLevel values fail the connection with SQLSTATE HY000, empty values are treated as unset, LogPath is required when logging is enabled, and that DSN/connection-string LogLevel is only validated while the effective level comes from the registry or odbc.ini.

Security assessment

The change clarifies validation and precedence rules for the driver's diagnostic log level and log path. It concerns client-side debug logging configuration rather than security audit logging, and no vulnerability or CVE is referenced.

Evidence

+A value that the driver does not recognize causes the connection to fail with SQLSTATE `HY000`. An empty value is treated as not set. If the level in the registry or `odbc.ini` is anything other than `OFF`, `LogPath` must also be set. Otherwise the connection fails with the message "LogLevel enables logging but LogPath is missing".

Diff

diff --git a/athena/latest/ug/odbc-v2-driver-logging-options.md b/athena/latest/ug/odbc-v2-driver-logging-options.md
index 5532293..5e3f22f 100644
--- a//athena/latest/ug/odbc-v2-driver-logging-options.md
+++ b//athena/latest/ug/odbc-v2-driver-logging-options.md
@@ -40,0 +41,4 @@ The following log levels are available:
+A value that the driver does not recognize causes the connection to fail with SQLSTATE `HY000`. An empty value is treated as not set. If the level in the registry or `odbc.ini` is anything other than `OFF`, `LogPath` must also be set. Otherwise the connection fails with the message "LogLevel enables logging but LogPath is missing".
+
+The driver accepts `LogLevel` in a DSN or connection string but only validates the value. The logging level in effect is the one set in the Windows registry or `odbc.ini`.
+
@@ -55,0 +60,2 @@ Specifies path to the file where the ODBC driver logs are stored. You can use th
+At the `ERROR` and `WARN` levels, the driver creates the log file when it writes the first message.
+