本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 的可用磁碟空間
+ 已安裝 [Microsoft Visual C\$1\$1 Redistributable for Visual Studio](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022)，適用於 Windows 64 位元。

## 安裝 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. 選擇 **Install (安裝)**。

1. 完成安裝時，請選擇**完成**。

## 設定驅動程式組態選項的方法
<a name="odbc-v2-driver-ways-to-set-options"></a>

若要控制 Windows 中 Amazon Athena ODBC 驅動程式的行為，您可以使用下列方式設定驅動程式組態選項：
+ 在 **ODBC 資料來源管理員**中設定資料來源名稱 (DSN) 時。
+ 透過在下列位置新增或變更 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;
```