View a markdown version of this page

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 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>