macOS - Amazon Athena
macOS 系统要求在 macOS 上安装 ODBC 数据连接器在 macOS 上配置数据来源名称

macOS

若想使用 macOS 客户端计算机访问 Amazon Athena，则需要安装 Amazon Athena ODBC 驱动程序。

macOS 系统要求

安装该驱动程序的每台 macOS 计算机都必须满足以下要求。

  • 使用 macOS 版本 14 或更高版本。

  • 有 100MB 可用磁盘空间。

  • 使用版本 3.52.16 或更高版本的 iODBC。

在 macOS 上安装 ODBC 数据连接器

参照以下过程下载并安装适用于 macOS 操作系统的 Amazon Athena ODBC 驱动程序。

下载并安装适用于 macOS 的 Amazon Athena ODBC 驱动程序

  1. 下载 .pkg 包文件。

  2. 双击 .pkg 文件。

  3. 按照向导中的步骤安装驱动程序。

  4. 在许可协议页面上，按继续，然后选择同意。

  5. 选择安装。

  6. 在安装完成时，选择完成。

  7. 输入以下命令，验证是否已安装驱动程序：

    > pkgutil --pkgs | grep athenaodbc

    输出因系统而异，具体内容如下。

    com.amazon.athenaodbc-x86_64.Config
com.amazon.athenaodbc-x86_64.Driver

    或者

    com.amazon.athenaodbc-arm64.Config
com.amazon.athenaodbc-arm64.Driver

在 macOS 上配置数据来源名称

安装好驱动程序后，可以在以下位置找到示例 .odbc.ini 和 .odbcinst.ini 文件：

  • 英特尔处理器计算机：/opt/athena/odbc/x86_64/ini/

  • ARM 处理器计算机：/opt/athena/odbc/arm64/ini/

使用此位置中的 .ini 文件作为配置 Amazon Athena ODBC 驱动程序和数据来源名称（DSN）的示例。

注意

默认情况下，ODBC 驱动程序管理器使用位于主目录中的隐藏配置文件 .odbc.ini 和 .odbcinst.ini。

要使用 iODBC 驱动程序管理器指定 .odbc.ini 和 .odbcinst.ini 文件的路径，请执行以下步骤。

使用 iODBC 驱动程序管理器指定 ODBC .ini 文件位置

  1. 将 ODBCINI 设置到 odbc.ini 文件的完整路径和文件名。

    • 对于配备了英特尔处理器的 macOS 计算机，请使用以下语法。

      export ODBCINI=/opt/athena/odbc/x86_64/ini/odbc.ini

    • 对于配备了 ARM 处理器的 macOS 计算机，请使用以下语法。

      export ODBCINI=/opt/athena/odbc/arm64/ini/odbc.ini

  2. 将 ODBCSYSINI 设置到 odbcinst.ini 文件的完整路径和文件名。

    • 对于配备了英特尔处理器的 macOS 计算机，请使用以下语法。

      export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini

    • 对于配备了 ARM 处理器的 macOS 计算机，请使用以下语法。

      export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini

  3. 如果想要使用数据来源名称（DSN）连接到数据存储，请配置 odbc.ini 文件来定义数据源名称（DSN）。设置 odbc.ini 文件中的属性，以便创建指定数据存储连接信息的 DSN，如下例所示。

    [ODBC Data Sources]
athena_odbc_test=Amazon Athena ODBC (x64) 

[ATHENA_WIDE_SETTINGS] # Special DSN-name to signal driver about logging configuration.
LogLevel=0             # set to 1 to enable ODBC driver logs
UseAwsLogger=0         # set to 1 to enable AWS-SDK logs
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
# 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
AwsRegion=us-west-1
Workgroup=primary
Catalog=AwsDataCatalog
Schema=default
AuthenticationType=IAM Credentials
UID=
PWD=
S3OutputLocation=s3://amzn-s3-demo-bucket/

  4. 配置 odbcinst.ini 文件，如下例所示。

    [ODBC Drivers]
Amazon Athena ODBC (x64)=Installed 

[Amazon Athena ODBC (x64)]
# 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

  5. 安装并配置 Amazon Athena ODBC 驱动程序后，使用 iodbctest 命令行工具来验证连接，如下例所示。

    username@ % iodbctest
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.1623.0502 

Enter ODBC connect string (? shows list): ? 

DSN                              | Driver
------------------------------------------------------------------------------
athena_odbc_test                 | Amazon Athena ODBC (x64) 

Enter ODBC connect string (? shows list): DSN=athena_odbc_test;
Driver: 2.0.2.1 (Amazon Athena ODBC Driver) 

SQL>