Override client-side settings (覆寫用戶端設定) - Amazon Athena

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

Override client-side settings (覆寫用戶端設定)

當您建立或編輯工作群組時，您可以選擇覆寫用戶端設定。預設不會選取此選項。視您是否選取它而定，Athena 的行為如下：

  • 如果未選取覆寫用戶端設定，則不會在用戶端層級強制工作群組設定。當未為工作群組選取覆寫用戶端設定選項時，Athena 將對工作群組中執行的所有查詢使用用戶端的設定，包括查詢結果位置、預期的儲存貯體擁有者、加密和對寫入查詢結果儲存貯體之物件的控制等的設定。每個使用者可以在主控台的設定選單中指定其自己的設定。如果不設定用戶端設定，則會套用工作群組整體設定。如果您使用 AWS CLI、 API動作或 JDBC和 ODBC驅動程式，在不會覆寫用戶端設定的工作群組中執行查詢，您的查詢會使用您在查詢中指定的設定。

  • 如果選取覆寫用戶端設定，則會在工作群組層級強制工作群組中所有用戶端執行工作群組設定。當為工作群組選取覆寫用戶端設定選項時，Athena 將對工作群組中執行的所有查詢使用工作群組的設定，包括查詢結果位置、預期的儲存貯體擁有者、加密和對寫入查詢結果儲存貯體之物件的控制等的設定。當您使用主控台、API動作或JDBCODBC驅動程式時，工作群組設定會覆寫您為查詢指定的任何用戶端設定。工作群組設定設定為覆寫用戶端設定後，API可以省略驅動程式或 中的用戶端設定。

    如果您覆寫使用者端設定，則您或任何工作群組使用者下次開啟 Athena 主控台時，Athena 會向您告知此工作群組中的查詢使用工作群組的設定，並提示您確認此變更。

    注意

    由於覆寫用戶端設定可能會中斷根據任意 Amazon S3 儲存貯體中結果可用性的自訂自動化，我們建議您在覆寫之前通知使用者。

    重要

    如果您使用API動作、 AWS CLI或 JDBC和 ODBC驅動程式在覆寫用戶端設定的工作群組中執行查詢，請確定您省略查詢中的用戶端設定，或更新它們以符合工作群組的設定。

    如果您在查詢中指定用戶端設定，但在覆寫設定的工作群組中執行這些設定，則將會使用工作群組設定執行查詢。如需有關檢視工作群組設定的資訊，請參閱 檢視工作群組的詳細資訊。