macOS - Amazon Athena
macOS 系统要求在 macOS 上安装 ODBC 数据连接器在 macOS 上配置数据来源名称
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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://DOC-EXAMPLE-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>