# Windows
<a name="odbc-v2-driver-getting-started-windows"></a>

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

## Windows 系统要求
<a name="odbc-v2-driver-system-requirements-windows"></a>

在可以直接访问 Amazon Athena 数据库的客户端计算机上安装 Amazon Athena ODBC 驱动程序，而无需使用 Web 浏览器。

所用的 Windows 系统必须满足以下要求：
+ 你具有管理员权限
+ 以下操作系统之一：
  + Windows 11、10 或 8.1
  + Windows Server 2019、2016 或 2012
  + 支持的处理器架构：x86\$164（64 位）
+ 至少 100 MB 可用磁盘空间
+ 已安装适用于 64 位 Windows 的 [Microsoft Visual C\$1\$1 Redistributable for Visual Studio](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022)。

## 安装 Amazon Athena ODBC 驱动程序
<a name="odbc-v2-driver-installing"></a>

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

1. [下载](odbc-v2-driver.md#odbc-v2-driver-download) `AmazonAthenaODBC-2.x.x.x.msi` 安装文件。

1. 启动安装文件，然后选择**下一步**。

1. 要接受许可协议条款，选中复选框，然后选择**下一步**。

1. 要更改安装位置，选择**浏览**，浏览到所需的文件夹，然后选择**确定**。

1. 要接受安装位置，选择**下一步**。

1. 选择**安装**。

1. 在安装完成时，选择**完成**。

## 设置驱动程序配置选项的方法
<a name="odbc-v2-driver-ways-to-set-options"></a>

要在 Windows 中控制 Amazon Athena ODBC 驱动程序的行为，可通过以下方式设置驱动程序配置选项：
+ 配置数据来源名称（DSN）时，在 **ODBC 数据来源管理器**程序中。
+ 通过在以下位置添加或更改 Windows 注册表项：

  ```
  HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME
  ```
+ 在以编程方式连接时，通过在连接字符串中设置驱动程序选项。

## 在 Windows 上配置数据来源名称
<a name="odbc-v2-driver-configuring-dsn-on-windows"></a>

在下载并安装 ODBC 驱动程序后，必须将数据来源名称（DSN）条目添加到客户端计算机或 Amazon EC2 实例。SQL 客户端工具将使用此数据来源连接和查询 Amazon Athena。

**创建系统 DSN 条目**

1. 在 Windows 的**开始**菜单中，右键单击 **ODBC 数据来源（64 位）**，然后选择**更多**、**以管理员身份运行**。

1. 在 **ODBC 数据来源管理器**中，选择**驱动程序**选项卡。

1. 在**名称**列中，确认是否存在 **Amazon Athena ODBC（x64）**。

1. 请执行以下操作之一：
   + 要为计算机上的所有用户配置驱动程序，选择**系统 DSN** 选项卡。由于使用不同账户加载数据的应用程序可能检测不到来自其他账户的用户 DSN，因而建议使用系统 DSN 配置选项。
**注意**  
要使用**系统 DSN** 选项，需要管理权限。
   + 要仅为您的用户账户配置驱动程序，选择**用户 DSN** 选项卡。

1. 选择**添加**。随即打开**新建数据来源**对话框。

1. 选择 **Amazon Athena ODBC（x64）**，然后选择**完成**。

1. 在 **Amazon Athena ODBC 配置**对话框中，输入以下信息。有关这些选项的详细信息，请参阅 [主要 ODBC 2.x 连接参数](odbc-v2-driver-main-connection-parameters.md)。
   + 在**数据来源名称**中，输入要用于识别数据来源的名称。
   + 对于**描述**，输入描述以帮助您识别数据来源。
   + 在**区域**中，输入要在其中使用 Athena 的 AWS 区域 名称（例如，** us-west-1**）。
   + 在**目录**中，输入 Amazon Athena 目录的名称。默认为 **AwsDataCatalog**，供 AWS Glue 使用。
   + 在**数据库**中，输入 Amazon Athena 数据库的名称。默认为**默认**。
   + 对于**工作组**，输入 Amazon Athena 工作组的名称。默认为**主要**。
   + 对于 **S3 输出位置**，输入 Amazon S3 中存储查询结果的位置（例如 **s3://amzn-s3-demo-bucket/**）。
   + （可选）对于**加密选项**，选择一个加密选项。默认值为 `NOT_SET`。
   + （可选）对于 **KMS 密钥**，根据需要选择加密 KMS 密钥。

1. 要指定用于 IAM 身份验证的配置选项，选择**身份验证选项**。

1. 输入以下信息：
   + 对于**身份验证类型**，选择 **IAM 凭证**。这是默认值。有关可用身份验证类型的更多信息，请参阅 [身份验证选项](odbc-v2-driver-authentication-options.md)。
   + 对于**用户名**，输入用户名。
   + 对于**密码**，输入密码。
   + 对于**会话令牌**，如果要使用临时 AWS 凭证，则输入会话令牌。有关临时凭证的更多信息，请参阅《*IAM 用户指南*》中的[将临时凭证用于 AWS 资源](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)。

1. 选择**确定**。

1. 在 **Amazon Athena ODBC 配置**对话框的底部，选择**测试**。如果客户端计算机成功连接到 Amazon Athena，则**连接测试**框会报告**连接成功**。否则，该框将报告**连接失败**并显示相应的错误信息。

1. 要关闭测试连接，选择**确定**。现在，您创建的数据来源在数据来源名称列表中显示。

## 在 Windows 上使用无 DSN 连接
<a name="odbc-v2-driver-dsn-less-connection"></a>

您可以使用无 DSN 连接来连接到没有数据来源名称（DSN）的数据库。以下示例显示了连接到 Amazon Athena 的 Amazon Athena ODBC（x64）ODBC 驱动程序的连接字符串。

```
DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation=
s3://amzn-s3-demo-bucket/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;
```