在協同作業中查詢資料 - AWS Clean Rooms
使用 SQL 程式碼編輯器使用分析建置器查詢具有差分隱私的資料檢視近期查詢檢視查詢詳細資訊

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

在協同作業中查詢資料

身為可以查詢的成員，您可以執行下列其中一項作業：

  • 使用 SQL 程式碼編輯器手動建置 SQL 查詢。

  • 使用分析產生器使用者介面來建立查詢，而不需要撰寫 SQL 程式碼。

  • 使用核准的分析範本。

當可以查詢的成員在協同作業中的資料表上執行 SQL 查詢時，會 AWS Clean Rooms 假設相關角色代表他們存取資料表。 AWS Clean Rooms 視需要將分析規則套用至輸入查詢及其輸出。

AWS Clean Rooms 支援可能與其他查詢引擎不同的 SQL 查詢。如需規格，請參閱 AWS Clean Rooms SQL 參考。如果您要對受差分隱私保護的資料表執行查詢，您應該確定您的查詢與 AWS Clean Rooms 差分隱私權的一般用途查詢結構相容。

注意

使用的密碼編譯運算時Clean Rooms，並非所有 SQL 作業都會產生有效的結果。例如，您可以在加密的資料行COUNT上執行，但是執SUM行加密的數字會導致錯誤。此外，查詢也可能會產生不正確的結果。例如，SUM密封資料行的查詢會產生錯誤。但是，對密封列的GROUPBY查詢似乎成功，但產生的組與通過明文GROUPBY查詢生成的組不同。

下列主題說明如何使用主 AWS Clean Rooms 控台在協同作業中查詢資料。

如需如何直接呼叫 AWS Clean Rooms StartProtectedQuery API 作業或使用 AWS SDK 來查詢資料或檢視查詢的相關資訊，請參閱 AWS Clean Rooms API 參考。

如需查詢記錄的相關資訊，請參閱查詢登入 AWS Clean Rooms。

注意

如果您對加密的資料表執行查詢，則加密資料行的結果會加密。

如需有關接收查詢結果的資訊，請參閱接收查詢結果。

使用 SQL 程式碼編輯器

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

依預設，會顯示 SQL 程式碼編輯器。如果您要使用分析建置器來建立查詢，請參閱使用分析建置器。

重要

如果您開始在程式碼編輯器中撰寫 SQL 查詢，然後開啟 Analysis 產生器 UI，則不會儲存您的查詢。

AWS Clean Rooms 支持許多 SQL 命令，函數和條件。如需詳細資訊，請參閱 AWS Clean Rooms SQL 參考。

提示

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

若要使用 SQL 程式碼編輯器手動建立查詢

  1. 登入 AWS Management Console 並使用您的AWS Clean Rooms 主機 AWS 帳戶 (如果您尚未這麼做) 開啟主機。

  2. 在左側導覽窗格中，選擇 [協同作業]。

  3. 選擇「您的會員能力」狀態為「查詢」的合作。

  4. 在「查詢」頁籤上，移至「分析」區段。

    注意

    只有在可以接收結果的成員以及負責支付查詢計算成本的成員已加入協同作業為作用中成員時，才會顯示「分析」區段。

  5. 在 [查詢] 索引標籤的 [資料表] 下，檢視表格清單及其相關聯的分析規則類型 (彙總分析規則、清單分析規則或自訂分析規則)。

    注意

    如果您在清單中沒有看到預期的表格，可能是因為下列原因：

  6. (選擇性) 若要檢視表格的結構定義和分析規則控制項，請選取加號圖示 (+) 以展開表格。

  7. 透過在 SQL 程式碼編輯器中輸入查詢來建立查詢。

    (選擇性) 如果您要使用範例查詢 (選擇性) 如果要插入欄名稱或函數

    1. 選取表格旁邊的三個垂直點。

    2. 在 [插入編輯器] 下，選擇 [範例查詢]。

      注意

      插入範例查詢會將查詢附加到編輯器中。

      此時會顯示查詢範例。下面列出的所有表都包括在查詢中。

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

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

    2. 在「在編輯器中插入」下，選擇「欄名稱」

    3. 若要在欄中手動插入允許的函數，請選取欄旁邊的三個垂直點，選取 [在編輯器中插入]，然後選取允許函數的名稱 (例如INNER JOINSUMDISTINCT、SUM 或COUNT)。

    4. 按 Ctrl + 空格鍵可在程式碼編輯器中檢視資料表結構描述。

      注意

      可以查詢的成員可以檢視和使用每個已設定資料表關聯中的分割區資料欄。請確定資料分割資料行在已設定之資料 AWS Glue 表底層的資料表中標示為分割資料行。

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

  8. 選擇執行。

    注意

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

  9. 繼續調整參數並再次執行查詢，或選擇「+」按鈕以在新標籤中開始新查詢。

注意

AWS Clean Rooms 旨在提供清晰的錯誤消息。如果錯誤訊息沒有足夠的詳細資料可協助您進行疑難排解，請連絡客戶團隊。提供錯誤發生方式的描述以及錯誤訊息 (包括任何識別碼)。如需詳細資訊，請參閱 疑難排 AWS Clean Rooms。

使用分析建置器

您可以使用分析生成器來構建查詢，而無需編寫 SQL 代碼。使用分析建置器，您可以為具有下列條件的協同作業建立查詢：

  • 使用彙總分析規則的單一表格，不需要 JOIN

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

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

  • 兩個使用彙總分析規則的表格 (每個成員各一個)，以及兩個使用清單分析規則的表格 (每個成員各一個)

如果您想要手動撰寫 SQL 查詢，請參閱使用 SQL 程式碼編輯器。

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

重要

如果您打開 Analysis 生成器 UI，開始在分析生成器中構建查詢，然後關閉 Analysis 生成器 UI，則不會保存您的查詢。

提示

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

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

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

此程序示範如何在 AWS Clean Rooms 主控台中使用 Analysis 產生器 UI 來建立查詢。此查詢適用於具有使用彙總分析規則且不JOIN需要的單一資料表的共同作業。

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

  1. 登入 AWS Management Console 並使用您的AWS Clean Rooms 主機 AWS 帳戶 (如果您尚未這麼做) 開啟主機。

  2. 在左側導覽窗格中，選擇 [協同作業]。

  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. 在左側導覽窗格中，選擇 [協同作業]。

  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。

查詢具有差分隱私的資料

一般而言，在開啟差分隱私時，撰寫和執行查詢不會變更。不過，如果沒有足夠的隱私權預算剩餘，您就無法執行查詢。當您執行查詢並使用隱私權預算時，您可以看到大約可以執行多少彙總，以及可能對 future 查詢造成什麼影響。

若要檢視協同合作中差異隱私的影響

  1. 登入 AWS Management Console 並使用您的AWS Clean Rooms 主機 AWS 帳戶 (如果您尚未這麼做) 開啟主機。

  2. 在左側導覽窗格中，選擇 [協同作業]。

  3. 選擇「您的成員詳細資料」狀態為「執行查詢」的協同作業。

  4. 在 [查詢] 索引標籤的 [表格] 下方，檢視剩餘的隱私權預算。這會顯示為剩餘彙總函數的估計數目和使用的公用程式 (以百分比顯示)。

    注意

    預估的剩餘彙總函數和使用的公用程式百分比只會顯示可以查詢的成員。

  5. 選擇 [檢視影響] 以檢視在結果中注入多少雜訊，以及您可以執行的彙總函數大約數目。

檢視近期查詢

您可以在 [最近的查詢] 索引標籤上檢視過去 90 天內執行的查詢。

注意

如果您唯一的會員能力是 Con tribute 資料，而您並非支付查詢計算費用的成員，則主控台上不會顯示 [查詢] 索引標籤。

檢視最近查詢的步驟

  1. 登入 AWS Management Console 並使用您的AWS Clean Rooms 主機 AWS 帳戶 (如果您尚未這麼做) 開啟主機。

  2. 在左側導覽窗格中，選擇 [協同作業]。

  3. 選擇合作。

  4. 在 [查詢] 索引標籤的 [查詢] 下，檢視過去 90 天內執行的查詢。

  5. 要按狀態對最近的查詢進行排序，請從 「所有狀態」 下拉列表中選擇某個狀態。

    狀態為：「已提交」、「已啟動」、「已取消」、「成功」、「失敗」和「逾時」。

檢視查詢詳細資訊

您可以以執行查詢的成員或可以接收結果的成員身分檢視查詢詳細資訊。

若要檢視查詢的詳細資訊

  1. 登入 AWS Management Console 並使用您的AWS Clean Rooms 主機 AWS 帳戶 (如果您尚未這麼做) 開啟主機。

  2. 在左側導覽窗格中，選擇 [協同作業]。

  3. 選擇合作。

  4. 在「查詢」頁籤上，執行下列其中一項作業：

    • 選擇您要檢視之特定查詢的選項按鈕，然後選擇「檢視明細」。

    • 選擇「受保護的查詢 ID」。

  5. 在「查詢詳細資訊」頁面上，

    • 如果您是可以執行查詢的成員，請檢視查詢詳細資訊、SQL 文字和結果。

      您會看到一則訊息，確認查詢結果已傳遞給可接收結果的成員。

    • 如果您是可以接收結果的成員，請檢視查詢詳細資料和結果。