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

# 設定済みテーブルへの分析ルールの追加
<a name="add-analysis-rule"></a>

以下のセクションでは、設定済みテーブルに分析ルールを追加する方法について説明します。分析ルールを定義すると、クエリを行えるメンバーに対して、 AWS Clean Roomsでサポートされる特定の分析ルールに一致するクエリを実行する権限を与えることができます。

AWS Clean Rooms は、次のタイプの分析ルールをサポートしています。
+ [集計分析ルール](analysis-rules-aggregation.md)
+ [リスト分析ルール](analysis-rules-list.md)
+ [のカスタム分析ルール AWS Clean Rooms](analysis-rules-custom.md)

設定済みテーブルごとに 1 つの分析ルールのみを割り当てることができます。設定済みテーブルをコラボレーションに関連付ける前に、いつでも分析ルールを設定できます。

**重要**  
Cryptographic Computing for Clean Rooms を使用しており、コラボレーション内のデータテーブルを暗号化している場合、暗号化された設定済みテーブルに追加する分析ルールは、データの暗号化方法と一致している必要があります。例えば、SELECT のデータ (集計分析ルール) を暗号化した場合、JOIN の分析ルール (リスト分析ルール) は追加しないでください。

**Topics**
+ [

## 集計分析ルールのテーブルへの追加 (ガイドフロー)
](#add-agg-analysis-rule-console-wizard)
+ [

## リスト分析ルールのテーブルへの追加 (ガイドフロー)
](#add-list-analysis-rule-console-wizard)
+ [

## カスタム分析ルールのテーブルへの追加 (ガイドフロー)
](#add-custom-analysis-rule-wizard)
+ [

## テーブルへの分析ルールの追加 (JSON エディタ)
](#add-analysis-rule-console-json-editor)
+ [

## 次の手順
](#add-analysis-rule-next-step)

## 集計分析ルールのテーブルへの追加 (ガイドフロー)
<a name="add-agg-analysis-rule-console-wizard"></a>

*集計分析ルール*では、COUNT、SUM、および AVG 関数を使用して、行レベルの情報を明らかにすることなく、任意のディメンションで統計を集計するクエリが可能になります。

この手順では、 AWS Clean Rooms コンソールの **[ガイドフロー]** オプションを使用して設定済みテーブルに集計分析ルールを追加するプロセスを説明します。

**注記**  
non-S3データソースを使用する設定済みテーブルは、[カスタム分析ルール](#add-custom-analysis-rule-wizard)のみをサポートします。

**集計分析ルールをテーブルに追加するには (ガイドフロー)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

1. 左のナビゲーションペインで、**[テーブル]** を選択します。

1. 設定済みテーブルを選択します。

1. 設定済みテーブルの詳細ページで、**[分析ルールを設定]** を選択します。

1. **ステップ 1: 分析ルールタイプ**を選択し、**分析ルールタイプ**で**集計**オプションを選択します。

1. **[作成方法]** で **[ガイドフロー]**] を選択し、**[次へ]** を選択します。

1. **[ステップ 2: クエリコントロールを指定]** の **[集約関数]** で以下の操作を行います。

   1. ドロップダウンから**集約関数**を選択します。
      + **COUNT**
      + **COUNT DISTINCT**
      + **SUM**
      + **SUM DISTINCT**
      + **AVG**

   1. **集約関数**で使用可能にする列を **[列]** ドロップダウンから選択します。

   1. (オプション) **[別の関数を追加]** を選択して別の集約関数を追加し、その関数に 1 つ以上の列を関連付けます。
**注記**  
少なくとも 1 つの集約関数が必要です。

   1. (オプション) **[削除]** を選択して集約関数を削除します。

1. **[結合コントロール]** で以下の操作を行います。

   1. **[テーブルの単独クエリを許可]** オプションを 1 つ選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. **[結合列を指定]** で、INNER JOIN ステートメントでの使用を許可する列を選択します。

      前のステップで **[はい]** を選択した場合、これは省略可能です**。

   1. **[照合に使用できる演算子を指定してください]** で、複数の結合列の照合で使用可能にする演算子 (ある場合) を選択します。2 つ以上の JOIN 列を選択した場合、これらの演算子のいずれかが必要です。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. **(オプション) **[ディメンションコントロール]** の **[ディメンション列を指定]** ドロップダウンで、SELECT ステートメントと、クエリの WHERE、GROUP BY、および ORDER BY 部分での使用を許可する列を選択します。
**注記**  
集約関数または結合列は**ディメンション**列として使用できません。

1. **[スカラー関数]** の **[許可するスカラー関数]** でオプションを 1 つ選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

   詳細については、「[スカラー関数](analysis-rules-aggregation.md#scalar-functions)」を参照してください。

1. **[次へ]** を選択します。

1. **[ステップ 3: クエリ結果コントロールを指定]** の **[集約制約]** で以下の操作を行います。

   1. 各 **[列名]** のドロップダウンリストを選択します。

   1. COUNT DISTINCT 関数を適用した後に、返される各出力行が満たす必要がある **[個別値の最小数]** をドロップダウンリストから選択します。

   1. **[制約を追加]** を選択して集約制約を追加します。

   1. (オプション) **[削除]** を選択して集約制約を削除します。

1. **[追加分析が出力に適用されました]** で、目標に応じてオプションを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. [**次へ**] を選択します。

1. **[ステップ 4: 確認して設定]** で、前のステップで行った選択内容を確認し、必要に応じて編集して、**[分析ルールを設定]** を選択します。

集計分析ルールがテーブルに正常に設定されたことを示す確認メッセージが表示されます。

## リスト分析ルールのテーブルへの追加 (ガイドフロー)
<a name="add-list-analysis-rule-console-wizard"></a>

*リスト分析ルール*では、クエリを実行できるメンバーのテーブルと関連するテーブルとの重複部分について行レベルのリストを出力するクエリが可能になります。

この手順では、 AWS Clean Rooms コンソールの**ガイド付きフロー**オプションを使用して、リスト分析ルールを設定済みテーブルに追加するプロセスについて説明します。

**注記**  
non-S3データソースを使用する設定済みテーブルは、[カスタム分析ルール](#add-custom-analysis-rule-wizard)のみをサポートします。

**リスト分析ルールをテーブルに追加するには (ガイドフロー)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

1. 左のナビゲーションペインで、**[テーブル]** を選択します。

1. 設定済みテーブルを選択します。

1. 設定済みテーブルの詳細ページで、**[分析ルールを設定]** を選択します。

1. **ステップ 1: 分析ルールタイプ**を選択し、**分析ルールタイプ**で**リスト**オプションを選択します。

1. **[作成方法]** で **[ガイドフロー]**] を選択し、**[次へ]** を選択します。

1. **[ステップ 2: クエリコントロールを指定]** の **[結合コントロール]** で以下の操作を行います。

   1. **[結合列を指定]** で、INNER JOIN ステートメントでの使用を許可する列を選択します。

   1. **[照合に使用できる演算子を指定してください]** で、複数の結合列の照合で使用可能にする演算子 (ある場合) を選択します。2 つ以上の JOIN 列を選択した場合、これらの演算子のいずれかが必要です。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. **(オプション) **[リストコントロール]** の **[リスト列を指定]** ドロップダウンで、クエリ出力での使用 (つまり、SELECT ステートメントでの使用)、または結果のフィルター処理での使用 (つまり WHERE ステートメントでの使用) を許可する列を選択します。

1. [**次へ**] を選択します。

1. **[ステップ 3: クエリ結果コントロールを指定]** の **[追加分析が出力に適用されました]** で、目標に応じてオプションを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. **[ステップ 4: 確認して設定]** で、前のステップで行った選択内容を確認し、必要に応じて編集して、**[分析ルールを設定]** を選択します。

リスト分析ルールがテーブルに正常に設定されたことを示す確認メッセージが表示されます。

## カスタム分析ルールのテーブルへの追加 (ガイドフロー)
<a name="add-custom-analysis-rule-wizard"></a>

カスタム分析ルールは、設定されたテーブルでカスタム SQL クエリまたは PySpark ジョブを有効にします。カスタム分析ルールは、以下を使用している場合に必要になります。
+ 事前に承認された特定の SQL クエリまたは PySpark ジョブのセット、またはデータを使用するクエリを提供できる特定のアカウントのセットを許可する[分析テンプレート](create-analysis-template.md)。
+ ユーザー識別の試みから保護するための[AWS Clean Rooms 差分プライバシー](differential-privacy.md)。
+ Amazon Athena や Snowflake などの Non-S3データソース。

この手順では、 AWS Clean Rooms コンソールの**ガイド付きフロー**オプションを使用して、カスタム分析ルールを設定済みテーブルに追加するプロセスについて説明します。

**カスタム分析ルールをテーブルに追加するには (ガイドフロー)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

1. 左のナビゲーションペインで、**[テーブル]** を選択します。

1. 設定済みテーブルを選択します。

1. 設定済みテーブルの詳細ページで、**[分析ルールを設定]** を選択します。

1. **ステップ 1: 分析ルールタイプ**を選択する、**分析ルールタイプ**で**カスタム**オプションを選択します。

1. **[作成方法]** で **[ガイドフロー]**] を選択し、**[次へ]** を選択します。

1. **ステップ 2: 分析コントロールを指定する**で、**直接分析コントロール**には、目標に基づいてオプションを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. **ステップ 3: 分析結果コントロールを指定する** 

   1. **ジョブ結果コントロール**では、追加の結果コントロールはサポートされていないことに注意してください。

   1. **クエリ結果コントロール**で、**出力で許可されていない列**については、目標に基づいてクエリ出力で許可する列を選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. **出力に適用される追加分析**では、目標に基づいて追加の分析をクエリ出力に適用できるかどうかを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. [**次へ**] を選択します。

1. (オプション) **ステップ 4: 差分プライバシーを設定する** で、差分プライバシーを有効または無効にするかどうかを決定します。

   差分プライバシーは、再識別攻撃からデータを保護するための、数学的に証明された手法です。
**注記**  
AWS Clean Rooms 差分プライバシーは、データが Amazon S3 に保存されているコラボレーションでのみ使用できます。

   **差分プライバシー** では、目的に基づいて差分プライバシーを有効または無効にするかどうかを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. **[ステップ 5: 確認して設定]** で、前のステップで行った選択内容を確認し、必要に応じて編集して、**[分析ルールを設定]** を選択します。

カスタム分析ルールがテーブルに正常に設定されたことを示す確認メッセージが表示されます。

## テーブルへの分析ルールの追加 (JSON エディタ)
<a name="add-analysis-rule-console-json-editor"></a>

次の手順は、 AWS Clean Rooms コンソールの **JSON エディタ**オプションを使用してテーブルに分析ルールを追加する方法を示しています。

**注記**  
non-S3データソースを使用する設定済みテーブルは、[カスタム分析ルール](#add-custom-analysis-rule-wizard)のみをサポートします。

**集計、リスト、またはカスタム分析ルールをテーブルに追加するには (JSON エディタ)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

1. 左のナビゲーションペインで、**[テーブル]** を選択します。

1. 設定済みテーブルを選択します。

1. 設定済みテーブルの詳細ページで、**[分析ルールを設定]** を選択します。

1. **ステップ 1: 分析ルールタイプ**を選択し、**分析ルールタイプ**で**集計**、**リスト**、または**カスタム**オプションを選択します。

1. **[作成方法]** で **[JSON エディタ]** を選択し、**[次へ]** を選択します。

1. **[ステップ 2: コントロールを指定]** で、クエリ構造を挿入するか (**[テンプレートを挿入]**)、ファイルを挿入するか (**[ファイルからインポート]**) を選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/add-analysis-rule.html)

1. [**次へ**] を選択します。

1. **[ステップ 3: 確認して設定]** で、前のステップで行った選択内容を確認し、必要に応じて編集して、**[分析ルールを設定]** を選択します。

分析ルールがテーブルに正常に設定されたことを示す確認メッセージが表示されます。

## 次の手順
<a name="add-analysis-rule-next-step"></a>

設定済みテーブルに分析ルールを設定したら、次の作業に進むことができます。
+ [設定済みテーブルをコラボレーションに関連付ける](associate-configured-table.md)
+ (クエリを行えるメンバーとして) [データテーブルにクエリを実行する](running-sql-queries.md)