AWS athena documentation change
Summary
Updated macOS ODBC driver installation paths and configuration procedures. Changed package names, unified driver paths across architectures, simplified environment variable setup, and provided explicit file copy commands.
Security assessment
Changes involve path updates, command corrections, and configuration simplifications without addressing vulnerabilities or security features. No security fixes, CVE references, or authentication changes are present.
Diff
diff --git a/athena/latest/ug/odbc-v2-driver-getting-started-macos.md b/athena/latest/ug/odbc-v2-driver-getting-started-macos.md index 1edf46874..f979733d1 100644 --- a//athena/latest/ug/odbc-v2-driver-getting-started-macos.md +++ b//athena/latest/ug/odbc-v2-driver-getting-started-macos.md @@ -46 +46 @@ Use the following procedure to download and install the Amazon Athena ODBC drive - > pkgutil --pkgs | grep athenaodbc + > pkgutil --pkgs | grep athena.odbc @@ -48 +48 @@ Use the following procedure to download and install the Amazon Athena ODBC drive -Depending on your system, the output can look like one of the following. +If the driver installed successfully, the output resembles the following. @@ -50,7 +50,2 @@ Depending on your system, the output can look like one of the following. - com.amazon.athenaodbc-x86_64.Config - com.amazon.athenaodbc-x86_64.Driver - -or - - com.amazon.athenaodbc-arm64.Config - com.amazon.athenaodbc-arm64.Driver + com.amazon.athena.odbc.Runtime + com.amazon.athena.odbc.Documentation @@ -63 +58,3 @@ or -After the driver is installed, you can find example `.odbc.ini` and `.odbcinst.ini` files in the following locations: +After the driver is installed, you can find example `odbc.ini.example` and `odbcinst.ini.example` files in the following location: + + * `/opt/amazon/athena-odbc/share/athena-odbc/` @@ -65 +61,0 @@ After the driver is installed, you can find example `.odbc.ini` and `.odbcinst.i - * Intel processor computers: `/opt/athena/odbc/x86_64/ini/` @@ -67 +62,0 @@ After the driver is installed, you can find example `.odbc.ini` and `.odbcinst.i - * ARM processor computers: `/opt/athena/odbc/arm64/ini/` @@ -69,0 +65 @@ After the driver is installed, you can find example `.odbc.ini` and `.odbcinst.i +Copy the example files to a configuration directory and remove the `.example` extension. Use these files as a starting point for configuring the Amazon Athena ODBC driver and data source name (DSN). @@ -72 +68,3 @@ After the driver is installed, you can find example `.odbc.ini` and `.odbcinst.i -Use the `.ini` files in this location as examples for configuring the Amazon Athena ODBC driver and data source name (DSN). + sudo mkdir -p /opt/amazon/athena-odbc/etc/athena-odbc + sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbc.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini + sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbcinst.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini @@ -78 +76 @@ By default, ODBC driver managers use the hidden configuration files `.odbc.ini` -To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC driver manager, perform the following steps. +To specify the path to the `odbc.ini` and `odbcinst.ini` files using the iODBC driver manager, perform the following steps. @@ -82,13 +80 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - 1. Set `ODBCINI` to the full path and file name of the `odbc.ini` file. - - * For macOS computers that have Intel processors, use the following syntax. - - export ODBCINI=/opt/athena/odbc/x86_64/ini/odbc.ini - - * For macOS computers that have ARM processors, use the following syntax. - - export ODBCINI=/opt/athena/odbc/arm64/ini/odbc.ini - - 2. Set `ODBCSYSINI` to the full path and file name of the `odbcinst.ini` file. - - * For macOS computers that have Intel processors, use the following syntax. + 1. Set `ODBCINI` to the full path and file name of the `odbc.ini` file, as in the following example. @@ -96 +82 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini + export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini @@ -98 +84 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - * For macOS computers that have ARM processors, use the following syntax. + 2. Set `ODBCSYSINI` to the full path of the directory that contains the `odbcinst.ini` file, as in the following example. @@ -100 +86 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini + export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc @@ -110 +96 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. + LogPath=/opt/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required. @@ -114,4 +100 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - # For ARM: - Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib - # For Intel: - # Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib + Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib @@ -133,6 +116,2 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - # For ARM: - Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib - Setup=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib - # For Intel: - # Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib - # Setup=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib + Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib + Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib @@ -154 +133 @@ To specify the path to the `.odbc.ini` and `.odbcinst.ini` files using the iODBC - Driver: 2.0.2.1 (Amazon Athena ODBC Driver) + Driver: 2.x.y.z (Amazon Athena ODBC Driver)