變更 Athena 引擎版本 - Amazon Athena

變更 Athena 引擎版本

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

尋找工作群組的查詢引擎版本

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

若要尋找任意工作群組目前的引擎版本
  1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

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

    
                            選擇展開選單。
  3. 在 Athena 主控台導覽窗格中,選擇 Workgroups (工作群組)。

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

使用 Athena 主控台變更引擎版本

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

注意

若要變更工作群組的引擎版本,必須擁有許可,才能對該工作群組執行 athena:ListEngineVersions 動作。如需 IAM 政策範例,請參閱 工作群組政策範例

讓 Athena 決定何時升級工作群組
  1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

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

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

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

  5. 選擇 Edit (編輯)。

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

  7. 選擇 Save changes (儲存變更)。

    如果有新的引擎版本可供使用,則 Workgroups (工作群組) 頁面上的 Query engine update status (查詢引擎更新狀況) 會顯示為 Pending automatic upgrade (等待自動升級)。更新時,Athena 會在 Athena 主控台和 AWS Health Dashboard 上通知您。工作群組會繼續使用目前的引擎版本,直到更新為止。

若要手動選擇引擎版本
  1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

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

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

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

  5. 選擇 Edit (編輯)。

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

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

  8. 選擇 Save changes (儲存變更)。

  9. 如果您選擇較舊的引擎版本,會出現Confirm Athena engine version (確認 Athena 引擎版本) 的警告。閱讀該警告,然後執行下列其中一項動作:

    • 若要取消引擎版本變更,請選擇 Cancel (取消)。

    • 若要確認引擎版本變更,請在對話方塊中輸入 confirm,然後選擇 Confirm (確認)。

    工作群組的 Query engine update status (查詢引擎更新狀況) 會顯示為 Manually set (手動設定)。

使用 AWS CLI 變更引擎版本

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

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

建立工作群組時指定引擎版本

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

若要在建立工作群組時指定引擎版本
  1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

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

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

  4. Workgroups (工作群組) 頁面中,請選擇 Create workgroup (建立工作群組)。

  5. Create workgroup (建立工作群組) 頁面中,請於 Query engine version (查詢引擎版本) 區段執行下列其中一項動作:

    • 選擇 Automatic (自動),便可讓 Athena 選擇何時升級您的工作群組。這是預設設定。

    • 如果有不同引擎版本可供使用,透過選擇 Manual (手動),便可手動選擇該引擎版本。

  6. 視需要輸入其他欄位的資訊。如需其他欄位的相關資訊,請參閱 建立工作群組

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

在引擎版本升級之前測試查詢

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

若要在引擎版本升級之前測試您的查詢
  1. 請驗證您所使用的工作群組引擎版本。您正在使用的引擎版本顯示在 Workgroups (工作群組) 頁面上用於該工作群組的 Query engine version (查詢引擎版本) 欄位中。如需詳細資訊,請參閱 尋找工作群組的查詢引擎版本

  2. 建立使用新引擎版本的測試工作群組。如需詳細資訊,請參閱 建立工作群組時指定引擎版本

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

  4. 如果查詢失敗,請使用 Athena 引擎版本參考 來檢查可能會影響查詢的重大變更。某些變更可能需要您更新查詢的語法。

  5. 如果您的查詢仍然失敗,請聯絡 AWS Support 尋求協助。在 AWS Management Console 中,選擇 Support (支援)、Support Center (支援中心),或使用 Amazon Athena 標籤在 AWS re:Post 上詢問問題。

對失敗的查詢進行疑難排解

如果查詢在引擎版本升級後失敗,請使用 Athena 引擎版本參考 來檢查是否有重大變更,包括可能會影響查詢語法的變更。

如果您的查詢仍然失敗,請聯絡 AWS Support 尋求協助。在 AWS Management Console 中,選擇 Support (支援)、Support Center (支援中心),或使用 Amazon Athena 標籤在 AWSre:Post 上詢問問題。