使用分析建置器查詢 - AWS Clean Rooms

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

使用分析建置器查詢

您可以使用分析建置器來建置查詢,而不必編寫SQL程式碼。使用分析建置器,您可以為具有下列項目的協同合作建立查詢:

  • 使用彙總分析規則且不需要的單一資料表 JOIN

  • 兩個使用彙總分析規則的資料表 (每個成員各一個)

  • 兩個使用清單分析規則的資料表 (每個成員各一個)

  • 兩個資料表 (每個成員各一個) 都使用彙總分析規則,兩個資料表 (每個成員各一個) 都使用清單分析規則

如果您想要手動寫入SQL查詢,請參閱 使用SQL程式碼編輯器查詢設定的資料表

分析建置器會在主控台的查詢索引標籤 AWS Clean Rooms 的分析區段中顯示為分析建置器使用者介面選項。

重要

如果您開啟分析建置器 UI ,請開始在分析建置器中建置查詢,然後關閉分析建置器 UI ,您的查詢不會儲存。

提示

如果在查詢執行期間進行排程維護,則會終止查詢並復原。您必須重新啟動查詢。

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

使用分析建置器查詢單一資料表 (彙總)

此程序示範如何使用 AWS Clean Rooms 主控台中的 Analysis Builder UI 來建置查詢。查詢是針對具有單一資料表的協同合作,該資料表使用沒有 的彙總分析規則 JOIN 必要。

使用分析建置器查詢單一資料表
  1. 登入 AWS Management Console 並使用 開啟AWS Clean Rooms 主控台 AWS 帳戶 (如果您尚未這麼做)。

  2. 在左側導覽窗格中,選擇 Collaborations

  3. 選擇具有查詢 成員能力狀態的協同作業

  4. 查詢索引標籤的資料表 下,檢視資料表及其相關聯的分析規則類型。(分析規則類型應該是彙總分析規則 。)

    注意

    如果您沒有看到預期的資料表,可能是下列原因所造成:

  5. 分析區段下,開啟分析建置器 UI

  6. 建置查詢。

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

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

    2. (選用) 對於新增區段 – 選用 ,選擇一或多個參數。

      注意

      新增區段 – 只有在資料表指定維度時,才會顯示選用項目。

    3. (選用) 對於新增篩選條件 – 選用 ,選擇新增篩選條件 ,然後選擇參數 、運算子 和

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

      若要移除篩選條件,請選擇移除

      注意

      ORDER BY 不支援彙總查詢。

      只有 AND 篩選條件中支援運算子。

    4. (選用) 對於新增描述 – 選用 ,輸入描述以協助識別查詢清單中的查詢。

  7. 展開預覽SQL碼

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

    2. 若要複製SQL程式碼,請選擇複製

    3. 若要編輯SQL程式碼,請在SQL程式碼編輯器 中選擇編輯

  8. 選擇執行

    注意

    如果可以接收結果的成員尚未設定查詢結果設定,則無法執行查詢。

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

注意

AWS Clean Rooms 旨在提供明確的錯誤訊息。如果錯誤訊息沒有足夠的詳細資訊來協助您進行疑難排解,請聯絡帳戶團隊。向他們提供錯誤發生方式和錯誤訊息 (包括任何識別符) 的說明。如需詳細資訊,請參閱疑難排 AWS Clean Rooms

使用分析建置器查詢兩個資料表 (彙總或清單)

此程序說明如何使用 AWS Clean Rooms 主控台中的分析建置器,為具有下列條件的協同作業建立查詢:

  • 兩個使用彙總分析規則的資料表 (每個成員各一個)

  • 兩個使用清單分析規則的資料表 (每個成員各一個)

  • 兩個資料表 (每個成員各一個) 都使用彙總分析規則,兩個資料表 (每個成員各一個) 都使用清單分析規則

使用分析建置器查詢兩個資料表
  1. 登入 AWS Management Console 並使用 開啟AWS Clean Rooms 主控台 AWS 帳戶 (如果您尚未這麼做)。

  2. 在左側導覽窗格中,選擇 Collaborations

  3. 選擇具有查詢 成員能力狀態的協同作業

  4. 查詢索引標籤的資料表 下,檢視兩個資料表及其相關聯的分析規則類型 (彙總分析規則清單分析規則 )。

    注意

    如果您沒有在清單中看到預期的資料表,可能是下列原因所造成:

  5. 分析區段下,開啟分析建置器 UI

  6. 建置查詢。

    如果協同作業包含兩個使用彙總分析規則的資料表,以及兩個使用清單分析規則 的資料表,請先選擇彙總清單 ,然後根據選取的分析規則遵循提示。

    如果兩個資料表使用彙總分析規則 如果兩個資料表使用清單分析規則
    1. 對於選擇指標 ,請檢閱預設預先選取的彙總指標,並視需要移除任何指標。

    2. 針對相符記錄 ,選擇一或多個記錄。

      注意

      使用分析建置器時,您只能比對一對資料欄。

    3. (選用) 對於新增區段 – 選用 ,選擇一或多個參數。

      注意

      新增區段 – 只有在資料表指定維度時,才會顯示選用項目。

    4. (選用) 對於新增篩選條件 – 選用 ,選擇新增篩選條件 ,然後選擇參數、運算子和值。

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

      若要移除篩選條件,請選擇移除

      注意

      ORDER BY 不支援彙總查詢。

      只有 AND 篩選條件中支援運算子。

    5. (選用) 對於新增描述 – 選用 ,輸入描述以協助識別最近查詢清單中的查詢。

    1. 對於選擇屬性 ,請檢閱預設預先選取的清單屬性,並視需要移除任何指標。

    2. 針對相符記錄 ,選擇一或多個記錄。

      注意

      使用分析建置器時,您只能比對一對資料欄。

    3. (選用) 對於新增篩選條件 – 選用 ,選擇新增篩選條件 ,然後選擇參數、運算子和值。

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

      若要移除篩選條件,請選擇移除

      注意

      LIMIT 不支援清單查詢。

      只有 AND 篩選條件中支援運算子。

    4. (選用) 對於新增描述 – 選用 ,輸入描述以協助識別最近查詢清單中的查詢。

  7. 展開預覽SQL碼

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

    2. 若要複製SQL程式碼,請選擇複製

    3. 若要編輯SQL程式碼,請在SQL程式碼編輯器 中選擇編輯

  8. 選擇執行

    注意

    如果可以接收結果的成員尚未設定查詢結果設定,則無法執行查詢

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

注意

AWS Clean Rooms 旨在提供明確的錯誤訊息。如果錯誤訊息沒有足夠的詳細資訊來協助您進行疑難排解,請聯絡帳戶團隊。向他們提供錯誤發生方式和錯誤訊息 (包括任何識別符) 的說明。如需詳細資訊,請參閱疑難排 AWS Clean Rooms