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

# 使用分析建置器查詢
<a name="query-data-analysis-builder"></a>

您可以使用分析建置器來建置查詢，而不必撰寫 SQL 程式碼。使用分析建置器，您可以為具有下列項目的協同合作建立查詢：
+ 使用[彙總分析規則](analysis-rules-aggregation.md)且不需要 JOIN 的單一資料表
+ 兩個使用[彙總分析規則](glossary.md#glossary-agg-analysis-rule)的資料表 （每個成員各一個）
+ 兩個使用[清單分析規則](glossary.md#glossary-list-analysis-rule)的資料表 （每個成員各一個）
+ 兩個資料表 （每個成員各一個） 都使用彙總分析規則，兩個資料表 （每個成員各一個） 都使用清單分析規則

如果您想要手動寫入 SQL 查詢，請參閱 [使用 SQL 程式碼編輯器查詢設定的資料表](use-sql-editor.md)。

分析建置器會在 AWS Clean Rooms 主控台分析索引標籤的**分析**區段中顯示為**分析****建置器 UI** 選項。

**重要**  
如果您開啟**分析建置器 UI**，開始在分析建置器中建置查詢，然後關閉**分析建置器 UI**，則不會儲存您的查詢。

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

下列主題說明如何使用分析建置器。

**Topics**
+ [使用分析建置器查詢單一資料表 （彙總）](#use-analysis-builder-one-table)
+ [使用分析建置器查詢兩個資料表 （彙總或清單）](#use-analysis-builder-two-tables)

## 使用分析建置器查詢單一資料表 （彙總）
<a name="use-analysis-builder-one-table"></a>

此程序示範如何在 AWS Clean Rooms 主控台中使用**分析建置器 UI** 來建置查詢。查詢適用於具有單一資料表的協同合作，該資料表使用[彙總分析規則](analysis-rules-aggregation.md)，而不需要JOIN。

**使用分析建置器查詢單一資料表**

登入 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. 在**分析**區段下，開啟**分析建置器 UI**。

1. 建置查詢。

   如果您想要查看所有彙總指標，請跳到步驟 9。

   1. 對於**選擇指標**，請檢閱預設預先選取的彙總指標，並視需要移除任何指標。

   1. （選用） 對於**新增客群 – 選用**，請選擇一或多個參數。
**注意**  
**新增區段 – 只有在為資料表指定維度時，才會顯示選用**項目。

   1. （選用） 對於**新增篩選條件 – 選用**，選擇**新增篩選條件**，然後選擇**參數**、運算子和**值**。

      若要新增更多篩選條件，請選擇**新增另一個篩選條件**。

      若要移除篩選條件，請選擇**移除**。
**注意**  
ORDER BY 不支援彙總查詢。  
篩選條件中僅支援 AND運算子。

   1. （選用） 對於**新增描述 – 選用**，輸入描述以協助識別查詢清單中的查詢。

1. 展開**預覽 SQL 程式碼**。

   1. 檢視從分析建置器產生的 SQL 程式碼。

   1. 若要複製 SQL 程式碼，請選擇**複製**。

   1. 若要編輯 SQL 程式碼，請在 **SQL 程式碼編輯器中選擇編輯**。

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

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

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

## 使用分析建置器查詢兩個資料表 （彙總或清單）
<a name="use-analysis-builder-two-tables"></a>

此程序說明如何使用 AWS Clean Rooms 主控台中的分析建置器，為具有下列項目的協同合作建立查詢：
+ 兩個使用[彙總分析規則](analysis-rules-aggregation.md)的資料表 （每個成員各一個）
+ 兩個使用[清單分析規則](analysis-rules-list.md)的資料表 （每個成員各一個）
+ 兩個資料表 （每個成員各一個） 都使用彙總分析規則，兩個資料表 （每個成員各一個） 都使用清單分析規則

**使用分析建置器查詢兩個資料表**

登入 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. 在**分析**區段下，開啟**分析建置器 UI**。

1. 建置查詢。

   如果協同合作包含兩個使用**彙總分析規則**的資料表，以及兩個使用**清單分析規則**的資料表，請先選擇**彙總**或**清單**，然後根據選取的分析規則遵循提示。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/userguide/query-data-analysis-builder.html)

1. 展開**預覽 SQL 程式碼**。

   1. 檢視從分析建置器產生的 SQL 程式碼。

   1. 若要複製 SQL 程式碼，請選擇**複製**。

   1. 若要編輯 SQL 程式碼，請在 **SQL 程式碼編輯器中選擇編輯**。

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

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

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