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

# 使用 SQL 程式碼編輯器查詢設定的資料表
<a name="use-sql-editor"></a>

身為可以查詢的成員，您可以在 SQL 程式碼編輯器中撰寫 SQL 程式碼，手動建置查詢。SQL 程式碼編輯器位於 AWS Clean Rooms 主控台**分析**索引標籤的**分析**區段。

預設會顯示 SQL 程式碼編輯器。如果您想要使用分析建置器來建置查詢，請參閱 [使用分析建置器查詢](query-data-analysis-builder.md)。

**重要**  
如果您開始在程式碼編輯器中寫入 SQL 查詢，然後開啟**分析建置器 UI**，則不會儲存您的查詢。

AWS Clean Rooms 支援許多 SQL 命令、函數和條件。如需詳細資訊，請參閱 [AWS Clean Rooms SQL 參考](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)。

**提示**  
如果在查詢執行時發生排程維護，查詢會終止並復原。您必須重新啟動查詢。

**使用 SQL 程式碼編輯器查詢設定的資料表**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) 的 AWS Clean Rooms 主控台。

1. 在左側導覽窗格中，選擇**協同合作**。

1. 選擇具有**執行查詢成員能力**狀態的協同合作。 ****

1. 在**分析**索引標籤的**資料表**下，檢視資料表清單及其相關聯的分析規則類型 **（彙總分析規則**、**清單分析規則**或**自訂分析規則**)。
**注意**  
如果您沒有在清單中看到預期的資料表，可能是因為下列原因：  
資料表尚未[建立關聯](associate-configured-table.md)。
資料表未[設定分析規則](add-analysis-rule.md)。

1. （選用） 若要檢視資料表的結構描述和分析規則控制項，請選取加號圖示 (**\$1**) 展開資料表。

1. 在**分析**區段下，針對**分析模式**，選取**寫入 SQL 程式碼**。
**注意**  
**分析**區段只會在可接收結果的成員，以及負責支付查詢運算成本的成員以作用中成員的身分加入協同合作時顯示。

1. 在 SQL 程式碼編輯器中輸入查詢來建置查詢。

   如需支援的 SQL 命令和函數的詳細資訊，請參閱 [AWS Clean Rooms SQL 參考。](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)

   您也可以使用下列選項來建置查詢。

------
#### [ Use an example query ]

   使用範例查詢

   1. 選取資料表旁的三個垂直點。

   1. 在**插入編輯器**下，選擇**範例查詢**。
**注意**  
插入**範例查詢**會將其附加至編輯器中已有的查詢。

      查詢範例隨即出現。資料表下列出的所有**資料表**都會包含在查詢中。

   1. 編輯查詢中的預留位置值。

------
#### [ Insert column names or functions ]

   插入資料欄名稱或函數

   1. 選取資料欄旁的三個垂直點。

   1. 在**插入編輯器**下，選擇**資料欄名稱**。

   1. 若要手動插入資料欄上允許的函數，

      1. 選取資料欄旁的三個垂直點。

      1. 選取在**編輯器中插入**。

      1. 選取允許的函數名稱 （例如 INNER JOIN、SUM DISTINCT、 SUM或 COUNT)。

   1. 按 **Ctrl** \$1 **Space** 在程式碼編輯器中檢視資料表結構描述。
**注意**  
可以查詢的成員可以檢視和使用每個已設定資料表關聯中的分割區資料欄。確保分割區資料欄在已設定 AWS Glue 資料表的基礎資料表中標記為分割區資料欄。

   1. 編輯查詢中的預留位置值。

------

1. 指定支援的**工作者類型**和**工作者數量**。

   您可以選擇執行個體類型和執行個體數量 （工作者） 來執行 SQL 查詢。

   對於 CR.1X，您最多可以選取 128 個工作者或至少 4 個工作者。

   對於 CR.4X，您最多可以選取 32 個工作者或至少 4 個工作者。

   使用下表來判斷使用案例所需的類型和數量或工作者。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/userguide/use-sql-editor.html)
**注意**  
不同的工作者類型和工作者數量都有相關聯的成本。若要進一步了解 定價，請參閱 [AWS Clean Rooms 定價](https://aws.amazon.com/clean-rooms/pricing/)。

1. 針對**傳送結果至** ，指定誰可以接收結果。
**注意**  
若要接收結果，協作成員必須設定為結果接收者，而且必須是協作中的作用中參與者 (**狀態：作用中**)

1. （只能查詢的成員） 預設會選取**使用您的預設結果設定**核取方塊。如果您想要保留預設結果設定，請保持選取此選項。

   如果您想要為此查詢指定不同的結果設定，請清除**使用您的預設結果設定**核取方塊，然後選擇下列選項。

   1. **結果格式** (**CSV** 或 **PARQUET**)

   1. **結果檔案** (**單一**或**多個**)

   1. **Amazon S3 中的結果目的地**

   每個可以接收結果的成員可以在 Amazon S3 中指定不同的**結果格式**、**結果檔案**和結果目的地。 ** Amazon S3**

1. 若要指定 **Spark 屬性**：

   1. 展開 **Spark 屬性**。

   1. 選擇**新增 Spark 屬性**。

   1. 在 **Spark 屬性**對話方塊中，從下拉式清單中選擇**屬性名稱**，然後輸入**值**。

   下表提供每個屬性的定義。

   如需 Spark 屬性的詳細資訊，請參閱 Apache Spark 文件中的 Spark [屬性](https://spark.apache.org/docs/latest/configuration.html#spark-properties)。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/userguide/use-sql-editor.html)

1. 選擇**執行**。
**注意**  
如果可以接收結果的成員尚未設定查詢結果設定，則無法執行查詢。

1. 檢視**結果**。

   如需詳細資訊，請參閱[接收和使用分析結果](receive-query-results.md)。

1. 繼續調整參數並再次執行查詢，或選擇 **\$1** 按鈕在新索引標籤中啟動新查詢。

**注意**  
AWS Clean Rooms 旨在提供明確的錯誤訊息。如果錯誤訊息沒有足夠的詳細資訊來協助您進行疑難排解，請聯絡客戶團隊。向他們提供錯誤發生方式和錯誤訊息 （包括任何識別符） 的說明。如需詳細資訊，請參閱[故障診斷 AWS Clean Rooms](troubleshooting.md)。