View a markdown version of this page

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 athena.odbc

    如果驱动程序安装成功，输出将类似于以下内容。

    com.amazon.athena.odbc.Runtime
com.amazon.athena.odbc.Documentation

在 macOS 上配置数据来源名称

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

  • /opt/amazon/athena-odbc/share/athena-odbc/

将示例文件复制到配置目录并移除 .example 扩展。使用这些文件作为配置 Amazon Athena ODBC 驱动程序和数据来源名称（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
注意

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

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

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

  1. 将 ODBCINI 设置为 odbc.ini 文件的完整路径和文件名，如下例所示。

    export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini

  2. 将 ODBCSYSINI 设置为 odbcinst.ini 文件所在目录的完整路径，如下例所示。

    export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc

  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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.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)]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.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.x.y.z (Amazon Athena ODBC Driver) 

SQL>