

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

# 設定済みテーブルのコラボレーションへの関連付け
<a name="associate-configured-table"></a>

設定済みテーブルを作成して分析ルールを追加したら、そのテーブルをコラボレーションに関連付け、 AWS Glue テーブルにアクセスするための AWS Clean Rooms サービスロールを付与できます。

**注記**  
このサービスロールにはテーブルに対するアクセス許可があります。このサービスロールは、クエリを行えるメンバーに代わって許可されたクエリを実行するためにのみ、 AWS Clean Rooms によって引き受け可能です。コラボレーションメンバー (データの所有者以外) は誰も、コラボレーションの基になるテーブルにはアクセスできません。データの所有者は差分プライバシーをオンにして、他のメンバーがテーブルのクエリを利用できるようにすることが可能です。

## データアクセス予算
<a name="data-access-budget"></a>

設定済みテーブルを関連付けると、データアクセス予算を適用できます。*データアクセス予算*は、コラボレーション内のクエリ、ジョブ、ML 入力チャネルにテーブルを使用できる回数を制御します。これらの予算は、テーブルの使用を制限することで、組織がリソース使用率を管理し、コストを制御するのに役立ちます。

テーブルがクエリ、ジョブ、または ML 入力チャネルで使用されるたびに、そのテーブルの予算が 1 つ削減されます。予算がゼロに達すると、テーブルを SQL クエリ、Pyspark ジョブ、またはテーブルから派生した ML 入力チャネルの一部として使用することはできません。

定期的に更新される期間ごとの予算、全体的な使用量のライフタイム予算、またはその両方を設定できます。デフォルトでは、テーブルの使用は無制限です。
+ 期間ごとの予算 – 指定した期間内にこのテーブルを使用できる回数を制限する更新可能な割り当て。期間は、毎日、毎週、または毎月に設定できます。この予算は、毎日、毎週、または毎月自動的に更新するように設定できます。
+ ライフタイム予算 – このテーブルを使用できる合計時間を制限する実行中の割り当て。

## 設定済みテーブルを関連付ける
<a name="associate-table-config-table-details"></a>

以下のトピックでは、 コンソールを使用して、設定済みテーブルを AWS Clean Rooms 関連付け、データアクセス予算をコラボレーションに適用する方法について説明します。

 AWS SDKs を使用して設定済みテーブルをコラボレーションに関連付ける方法については、 [https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)を参照してください。

### ステップ 1: 前提条件を満たす
<a name="associate-config-table-prereq"></a>

設定済みテーブルを関連付けるには、次の前提条件を満たす必要があります。
+ Amazon S3 フォルダの場所を指す AWS Glue テーブル (単一のファイルではない)
+ 暗号化された AWS Glue テーブルの場合:
  + テーブルの AWS Glue 復号に AWS KMS キーを使用するアクセス許可を持つサービスロール
  +  AWS KMS暗号化された Amazon S3 データセットの場合: サービスロールには、 AWS KMS キーを使用して Amazon S3 データを復号するためのアクセス許可も必要です。

暗号化の設定の詳細については、 *AWS Glue デベロッパーガイド*の[「 での暗号化の設定 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/set-up-encryption.html)」を参照してください。

 AWS Glue テーブルの場所を確認するには:

1. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) で AWS Glue コンソールを開きます。

1. テーブルの詳細を表示し、場所が S3 フォルダを指していることを確認する

### ステップ 2: 設定済みテーブルを関連付ける
<a name="associate-config-table"></a>

**設定済みテーブルを関連付けるには**

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. コラボレーションの詳細ページから:

      1. 左のナビゲーションペインで、**[コラボレーション]** を選択します。

      1. コラボレーションを選択します。

      1. **[テーブル]** タブで **[テーブルを関連付ける]** を選択します。

1. **テーブルの関連付け**ページで、次のいずれかを実行します。
   + 既存の設定済みテーブルを選択する – ドロップダウンリストからコラボレーションに関連付ける**設定済みテーブル名**を選択します。
   + 新しいテーブルの設定 – **新しいテーブルの設定**を選択し、**新しいテーブルの設定**ページのプロンプトに従います。
   + 設定済みテーブルのスキーマと分析ルールを表示する – **スキーマと分析ルールの表示**を有効にします。

1. **[テーブルの関連付けの詳細]** で次の操作を行います。

   1. 関連付けるテーブルの**[名前]** を入力します。

      デフォルトの名前を使用することも、テーブルの名前を変更することもできます。

   1. (オプション) テーブルの **[説明]** を入力します。

      この説明はクエリの作成に役立ちます。

1. **[新しいサービスロールを作成して使用]** または **[既存のサービスロールを使用]** を選択して、**[サービスアクセス]** 許可を指定します。
**注記**  
Amazon Athena でバックアップされた設定済みテーブルを関連付ける場合は、ドロップダウンリストから**既存のサービスロール名**を選択します。サービスロールに IAM と、必要に応じてデータセットへの Lake Formation アクセス許可があることを確認します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/associate-configured-table.html)
**注記**  
AWS Clean Rooms には、分析ルールに従ってクエリを実行するためのアクセス許可が必要です。のアクセス許可の詳細については AWS Clean Rooms、「」を参照してください[AWS の 管理ポリシー AWS Clean Rooms](security-iam-awsmanpol.md)。
ロールに十分なアクセス許可がない場合 AWS Clean Rooms、ロールに に対する十分なアクセス許可がないことを示すエラーメッセージが表示されます AWS Clean Rooms。続行する前に、ロールポリシーを追加する必要があります。
ロールポリシーを変更できない場合は、 AWS Clean Rooms でサービスロールのポリシーが見つからなかったという内容のエラーメッセージが表示されます。

1. 設定**済みテーブル関連付けリソースの設定済みテーブル関連付けタグ**を有効にする場合は、**新しいタグを追加**を選択し、**キー**と**値の**ペアを入力します。

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

1. **コラボレーション分析ルールの設定**ページで、次のいずれかを選択します。
   + **はい、今すぐコラボレーション分析ルールを作成する** – テーブルをこのコラボレーションに関連付け、コラボレーション分析ルールを作成します
   + **いいえ。後でコラボレーション分析ルールを作成します**。テーブルをこのコラボレーションにのみ関連付けます。コラボレーション分析ルールは後で作成できます。

1. **「はい」を選択した場合は、コラボレーション分析ルールを今すぐ作成**します。**結果配信**では、ドロップダウンリストから**クエリ出力の結果を受信できるメンバー**を選択します。

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

1. **データアクセス予算の追加**ページで、**データアクセス予算設定**で、次のいずれかを選択します。
   + **はい、今すぐデータアクセス予算を追加する** – テーブルをこのコラボレーションに関連付け、データアクセス予算を追加します。期間予算、ライフタイム予算、またはその両方を選択できます。
   + **いいえ、後でデータアクセス予算を追加します**。テーブルをこのコラボレーションにのみ関連付けます。データアクセス予算は後で追加できます。

     **いいえを選択した場合は、後でデータアクセス予算を追加**し、ステップ 15 に進みます。

1. **はい を選択した場合は、今すぐデータアクセス予算を追加**し、次のいずれかの予算設定を選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/associate-configured-table.html)

1. **データアクセス予算の概要**で選択内容を確認します。  
**Example 例**  

   たとえば、**期間ごとの予算額**として 1,000 を選択し、**期間**を**週次**に設定し、**週次自動更新予算**チェックボックスを選択したままにして**、ライフタイム予算**を 1,000,000 に設定すると、**アクセス予算の概要**に次のメッセージが表示されます。毎週、このテーブルはクエリまたはジョブの実行に最大 1,000 回使用できます。この予算は毎週日曜日の 00:00 UTC に自動的に更新されるように設定され、このテーブルがライフタイム予算である 1,000,000 回の使用量に達するまで更新され続けます。

1. (オプション) アクセス**予算リソースのデータアクセス予算タグ**を有効にする場合は、**新しいタグを追加**を選択し、キーと値のペアを入力します。

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

1. **レビューと作成**ページの情報を確認します。

   1. セクションを編集する必要がある場合は、**編集** を選択します。

   1. 設定を編集し、次**へ**を選択します。

1. **[テーブルを関連付ける]** を選択します。

### ステップ 3: 次のステップ
<a name="associate-table-next-steps"></a>

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