

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

# 變更 Athena 引擎版本
<a name="engine-versions-changing"></a>

Athena 偶爾會發行新的引擎版本，以提供改進的效能、功能和程式碼修正。當有新的引擎版本可供使用時，Athena 會在主控台中通知您。您可以選擇讓 Athena 決定何時升級，或手動為每個工作群組指定 Athena 引擎版本。

## 尋找工作群組的引擎版本
<a name="engine-versions-changing-finding-the-query-engine-version-for-a-workgroup"></a>

您也可以使用 **Workgroups** (工作群組) 頁面，來尋找任何工作群組目前使用的引擎版本。

**若要尋找任意工作群組目前的引擎版本**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。  
![\[選擇展開選單。\]](http://docs.aws.amazon.com/zh_tw/athena/latest/ug/images/nav-pane-expansion.png)

1. 在 Athena 主控台導覽窗格中，選擇 **Workgroups** (工作群組)。

1. 在 **Workgroups** (工作群組) 頁面，尋找您想要的工作群組。工作群組的 **Query engine version** (查詢引擎版本) 欄位顯示查詢引擎版本。

## 使用 Athena 主控台變更引擎版本
<a name="engine-versions-changing-changing-the-engine-version"></a>

當有新的引擎版本可用時，您可以選擇讓 Athena 決定何時升級工作群組，或手動指定工作群組使用的 Athena 引擎版本。如果目前只有一個版本可以使用，則無法手動指定不同版本。

**注意**  
若要變更工作群組的引擎版本，必須擁有許可，才能對該工作群組執行 `athena:ListEngineVersions` 動作。如需 IAM 政策範例，請參閱 [工作群組政策範例](example-policies-workgroup.md)。

**讓 Athena 決定何時升級工作群組**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 在主控台導覽窗格中，選擇 **Workgroups** (工作群組)。

1. 在工作群組清單中，選擇您想要設定的工作群組連結。

1. 選擇**編輯**。

1. 在 **Query engine version** (查詢引擎版本) 中，對於 **Update query engine** (更新查詢引擎)，選擇 **Automatic** (自動) 讓 Athena 選擇何時升級您的工作群組。這是預設設定。

1. 選擇**儲存變更**。

   在工作群組清單中，工作群組的 **Query engine update status** (查詢引擎更新狀態) 會顯示為 **Automatic** (自動)。

**若要手動選擇引擎版本**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 在主控台導覽窗格中，選擇 **Workgroups** (工作群組)。

1. 在工作群組清單中，選擇您想要設定的工作群組連結。

1. 選擇**編輯**。

1. 在 **Query engine version** (查詢引擎版本) 下，對於 **Update query engine** (更新查詢引擎)，選擇 **Manually** (手動) 即可手動選擇引擎版本。

1. 使用 **Query engine version** (查詢引擎版本) 選項，選擇您希望工作群組使用的引擎版本。如果不同引擎版本無法使用，則無法指定不同引擎版本。

1. 選擇**儲存變更**。

   在工作群組清單中，工作群組的 **Query engine update status** (查詢引擎更新狀態) 會顯示為 **Manual** (手動)。

## 使用 AWS CLI 變更引擎版本
<a name="engine-versions-changing-changing-the-engine-version-cli"></a>

若要使用 變更引擎版本 AWS CLI，請使用下列範例中的語法。

```
aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}
```

## 在建立工作群組時指定引擎版本
<a name="engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup"></a>

當您建立工作群組時，您可以指定工作群組使用的引擎版本，或讓 Athena 決定何時升級工作群組。如果新的引擎版本可供使用，則最佳實務則是建立工作群組，以測試新引擎，然後再升級其他工作群組。若要指定工作群組的引擎版本，您必須擁有工作群組的 `athena:ListEngineVersions` 許可。如需 IAM 政策範例，請參閱 [工作群組政策範例](example-policies-workgroup.md)。

**若要在建立工作群組時指定引擎版本**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 在主控台導覽窗格中，選擇 **Workgroups** (工作群組)。

1. 在 **Workgroups** (工作群組) 頁面中，請選擇 **Create workgroup** (建立工作群組)。

1. 在 **Create workgroup** (建立工作群組) 頁面中，請於 **Query engine version** (查詢引擎版本) 區段執行下列其中一項動作：
   + 選擇 **Automatic** (自動)，便可讓 Athena 選擇何時升級您的工作群組。這是預設設定。
   + 如果有不同引擎版本可供使用，透過選擇 **Manual** (手動)，便可手動選擇該引擎版本。

1. 視需要輸入其他欄位的資訊。如需其他欄位的相關資訊，請參閱 [建立工作群組](creating-workgroups.md)。

1. 選擇 **Create workgroup** (建立工作群組)。

## 在引擎版本升級之前測試查詢
<a name="engine-versions-testing"></a>

當工作群組升級到新的引擎版本時，您的部分查詢可能會因為不相容而中斷。若要確保您的引擎版本升級順利進行，您可以事先測試您的查詢。

**若要在引擎版本升級之前測試您的查詢**

1. 請驗證您所使用的工作群組引擎版本。您正在使用的引擎版本顯示在 **Workgroups** (工作群組) 頁面上用於該工作群組的 **Query engine version** (查詢引擎版本) 欄位中。如需詳細資訊，請參閱[尋找工作群組的引擎版本](#engine-versions-changing-finding-the-query-engine-version-for-a-workgroup)。

1. 建立使用新引擎版本的測試工作群組。如需詳細資訊，請參閱[在建立工作群組時指定引擎版本](#engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup)。

1. 使用新工作群組來執行您要測試的查詢。

1. 如果查詢失敗，請檢查新引擎中是否有可能會影響查詢的重大變更。某些變更可能需要您更新查詢的語法。

1. 如果您的查詢仍然失敗，請聯絡 AWS 支援 尋求協助。在 AWS 管理主控台中，選擇**支援**、**支援中心**，或使用 **Amazon Athena** 標籤在 [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) 上詢問問題。

## 對引擎版本升級後失敗的查詢進行疑難排解
<a name="engine-versions-troubleshooting"></a>

如果查詢在引擎版本升級後失敗，請檢查是否有重大變更，包括可能會影響查詢中的語法的變更。

如果您的查詢仍然失敗，請聯絡 AWS 支援 尋求協助。在 中 AWS 管理主控台，選擇**支援**、**支援中心**，或使用 **Amazon Athena** 標籤在 [AWS re：Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) 上提出問題。