コラボレーションでデータをクエリする - AWS Clean Rooms

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

コラボレーションでデータをクエリする

注記

クエリは、クエリコンピューティングコストの支払いを担当するメンバーがアクティブなメンバーとしてコラボレーションに参加している場合にのみ実行できます。

クエリを行えるメンバーは、次のいずれかを実行できます。

  • SQL コードエディタを使用してSQLクエリを手動で構築します。

  • Analysis Builder UI を使用して、SQLコードを記述しなくてもクエリを構築できます。

  • 承認済みの分析テンプレートを使用する。

クエリを実行できるメンバーがコラボレーション内のテーブルでSQLクエリを実行すると、 AWS Clean Rooms は関連するロールを引き受けて、ユーザーに代わってテーブルにアクセスします。 は、入力クエリとその出力に必要に応じて分析ルール AWS Clean Rooms を適用します。

分析ルールと出力制約は自動的に適用されます。 は、定義された分析ルールに準拠した結果 AWS Clean Rooms のみを返します。

暗号化されたデータに対するクエリの場合、結果を受け取ることができるメンバーは、暗号化された出力を から受け取り AWS Clean Rooms 、そこから復号する必要があります。

AWS Clean Rooms は、他のSQLクエリエンジンとは異なるクエリをサポートします。仕様については、「 AWS Clean Rooms SQLリファレンス」を参照してください。差分プライバシーで保護されているデータテーブルでクエリを実行する場合は、クエリが AWS Clean Rooms 差分プライバシーの汎用クエリ構造と互換性があることを確認する必要があります。

注記

暗号化コンピューティングを使用する場合 Clean Rooms、すべてのSQLオペレーションが有効な結果を生成するわけではありません。例えば、COUNT 暗号化された列で を実行する SUM 暗号化された数値の場合、エラーが発生します。また、誤ったクエリ結果が得られることもあります。例えば、SUM 密封された列はエラーを生成します。ただし、GROUP BY 密封された列に対するクエリは成功したように見えますが、 によって生成されたグループとは異なるグループを生成します。GROUP BY クリアテキストでクエリを実行します。

クエリの計算コストを負担するメンバーに、コラボレーションで実行されたクエリの料金が請求されます。

以下のトピックでは、 AWS Clean Rooms コンソールを使用してコラボレーション内のデータにクエリを実行する方法を説明します。

StartProtectedQuery API オペレーションを直接呼び出す AWS Clean Rooms か、 を使用してデータをクエリしたり、クエリを表示する方法については AWS SDKs、 AWS Clean Rooms APIリファレンス を参照してください。

クエリログ記録の詳細については、「ログインのクエリ AWS Clean Rooms」を参照してください。

注記

暗号化されたデータテーブルにクエリを実行すると、暗号化された列の結果は暗号化されます。

クエリ結果の受け取りについては、「クエリ結果の受信と使用」を参照してください。