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

# 執行 SQL 查詢
<a name="running-sql-queries"></a>

**注意**  
只有在負責支付查詢運算成本的成員以作用中成員的身分加入協同合作時，您才能執行查詢。

身為[可以查詢的成員](glossary.md#glossary-member-who-can-query)，您可以透過下列方式執行 SQL 查詢：
+ 使用 SQL 程式碼編輯器手動建置 SQL 查詢。
+ 使用核准的 SQL [分析範本](create-analysis-template.md)。
+ 使用**分析建置器 UI** 來建置查詢，而無需撰寫 SQL 程式碼。

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

分析規則和輸出限制條件會自動強制執行。 AWS Clean Rooms 只會傳回符合定義分析規則的結果。

AWS Clean Rooms 支援與其他查詢引擎不同的 SQL 查詢。如需規格，請參閱 [AWS Clean Rooms SQL 參考](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)。如果您想要對受差異隱私權保護的 AWS Clean Rooms 資料表執行查詢，則應確保您的查詢與差異隱私權[的一般用途查詢結構](analysis-rules-custom.md#dp-query-structure-syntax)相容。

**注意**  
使用適用於 [的加密運算時Clean Rooms](crypto-computing.md)，並非所有 SQL 操作都會產生有效的結果。例如，您可以在加密資料欄COUNT上執行 ，但在加密數字SUM上執行 會導致錯誤。此外，查詢也可能產生不正確的結果。例如，SUM密封資料欄的查詢會產生錯誤。不過，對密封資料欄的GROUPBY查詢似乎成功，但產生的群組與透過純文字GROUPBY查詢產生的群組不同。

[支付查詢運算成本的成員](glossary.md#glossary-member-paying-for-query-compute)會針對協同合作中執行的查詢付費。

可以查詢的成員可以選取多個[可以接收結果的成員](glossary.md#glossary-member-who-can-receive-results)，以接收來自單一查詢的結果。如需詳細資訊，請參閱[使用 SQL 程式碼編輯器查詢設定的資料表](use-sql-editor.md)。如需接收查詢結果的一般資訊，請參閱 [接收和使用分析結果](receive-query-results.md)。

## 先決條件
<a name="sql-queries-prereqs"></a>

 執行 SQL 查詢之前，請確定您有下列項目：
+  AWS Clean Rooms 協作中的作用中成員資格
+ 在協同合作中存取至少一個已設定的資料表
+ 確認負責查詢運算成本的成員是作用中的協同合作成員

如需有關如何直接呼叫 AWS Clean Rooms [StartProtectedQuery API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html) 操作或使用 AWS SDKs 查詢資料或檢視查詢的資訊，請參閱 [AWS Clean Rooms API 參考](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)。

如需查詢記錄的資訊，請參閱 [分析登入 AWS Clean Rooms](query-logs.md)。

**注意**  
如果您在[加密](glossary.md#glossary-encryption)的資料表上執行查詢，加密資料欄的結果會加密。

## SQL 查詢的 Spark 屬性組態
<a name="spark-properties-config"></a>

AWS Clean Rooms 可讓您設定 SQL 查詢支援的 Spark 屬性，選擇性地自訂 Spark 執行時間行為。這些屬性可讓您微調效能、記憶體用量和查詢執行參數。透過此功能，您可以更好地控制 Spark 型查詢的處理方式，從而根據您的特定工作負載需求進行最佳化。

您現在可以直接從 AWS Clean Rooms 主控台調整隨機播放分割區、廣播聯結閾值和自適應查詢執行參數等設定。此功能對於預設組態可能不是最佳的複雜查詢或大型資料集特別有用。透過微調這些 Spark 屬性，您可以改善查詢效能、減少資源消耗，以及更好地管理 Spark 型協同合作分析的記憶體用量。

若要利用此功能，您可以在查詢界面中找到新的 **Spark 屬性**區段。您可以從支援的屬性清單中選取 ，並指定自訂值。您也可以使用 [StartProtectedQuery API，以程式設計方式設定 Spark 屬性。](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html)此進階組態選項可讓資料分析師和工程師最佳化其查詢，以提升效率和可擴展性。

如需 Spark 屬性的詳細資訊，包括預設值，請參閱 Apache Spark 文件中的 Spark [屬性](https://spark.apache.org/docs/latest/configuration.html#spark-properties)。

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

**Topics**
+ [先決條件](#sql-queries-prereqs)
+ [SQL 查詢的 Spark 屬性組態](#spark-properties-config)
+ [使用 SQL 程式碼編輯器查詢設定的資料表](use-sql-editor.md)
+ [使用 SQL 程式碼編輯器查詢 ID 映射表](query-id-mapping-tables.md)
+ [使用 SQL 分析範本查詢設定的資料表](use-analysis-template.md)
+ [使用分析建置器查詢](query-data-analysis-builder.md)
+ [檢視差異隱私權的影響](query-data-with-diff-privacy.md)
+ [檢視近期查詢](view-queries-console.md)
+ [檢視查詢詳細資訊](view-query-details.md)