

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

# の ID マッピングテーブル AWS Clean Rooms
<a name="working-with-id-mapping-tables"></a>

*ID マッピングテーブル*は、コラボレーションでマルチパーティ ID マッピング AWS Clean Rooms を有効にする のリソースです。

ID マッピングテーブルを作成する前に、まずソースデータとターゲットデータの両方を ID 名前空間として設定する必要があります。

ID マッピングテーブルを作成したら、ID マッピングワークフローを使用してソース ID 名前空間をターゲット ID 名前空間に変換します。これを行うには、ルールベースの方法、またはプロバイダーサービスのトランスコーディング方法を使用します。

*ID マッピングワークフロー*は、指定された ID マッピングワークフロー方法に基づいて、入力データソースから入力データターゲットにデータをマッピングするデータ処理ジョブです。このワークフローでは、ID マッピングテーブルが入力されます。

**注記**  
 ID マッピングテーブルは、Amazon S3 に保存され、 AWS Glue テーブルにクロールされたデータセットからのみ作成できます。

ID マッピングワークフローには、ルールベースの ID マッピングまたはプロバイダーサービス ID マッピングの 2 つの方法があります。
+ ルールベースの ID マッピング – 一致するルールを使用して、ソースからターゲットにファーストパーティーデータを変換します。
+ プロバイダーサービス ID マッピング – LiveRamp プロバイダーサービスを使用して、ソースからターゲットにサードパーティーデータを変換します。
**注記**  
現在サポートされているトランスコーディングサービスプロバイダーは LiveRamp です。を通じて LiveRamp のサブスクリプションを持つコラボレーションのメンバー AWS Data Exchange は、ID マッピングテーブルを作成できます。LiveRamp へのサブスクリプションをすでに持っているが、 経由では持っていない場合は AWS Data Exchange、LiveRamp に連絡してプライベートオファーを取得してください。詳細については、「*AWS Entity Resolution ユーザーガイド*」の「[AWS Data Exchangeでプロバイダーサービスをサブスクライブする](https://docs.aws.amazon.com/entityresolution/latest/userguide/setting-up.html#subscribe-provider-service)」を参照してください。

**Topics**
+ [新しい ID マッピングテーブルの作成とデータ入力](create-id-mapping-table.md)
+ [既存の ID マッピングテーブルへのデータ入力](populate-id-mapping-table.md)
+ [ID マッピングテーブルの編集](edit-id-mapping-table.md)
+ [ID マッピングテーブルの削除](delete-id-mapping-table.md)

# 新しい ID マッピングテーブルの作成とデータ入力
<a name="create-id-mapping-table"></a>

**前提条件**

ID マッピングテーブルを作成する前に、以下を確認してください。
+ 関連付けられた ID 名前空間のソースとターゲット
+ ルールベースの ID マッピングまたはプロバイダーサービス ID マッピング用に設定された ID 名前空間

  

次の 2 種類の ID マッピングテーブルを作成できます。
+ ルールベース – 一致するルールを使用してファーストパーティーデータを翻訳します
+ プロバイダーサービス – LiveRamp を使用して RampIDs

ID マッピングテーブルを作成したら、ID マッピングワークフローを実行してすぐに入力するか、後でテーブルの入力を待つことができます。

ID マッピングテーブルに正常にデータが入力されたら、ID マッピングテーブルでマルチテーブル結合クエリを実行して、`sourceId` を `targetId` に結合し、データを分析できます。

**Topics**
+ [ID マッピングテーブルを作成する (ルールベース)](#create-id-mapping-table-rule-based)
+ [ID マッピングテーブルを作成する (プロバイダーサービス)](#create-id-mapping-table-provider-services)

## ID マッピングテーブルを作成する (ルールベース)
<a name="create-id-mapping-table-rule-based"></a>

このトピックでは、一致するルールを使用してファーストパーティデータをソースからターゲットに変換する ID マッピングテーブルを作成するプロセスについて説明します。

ルールベースの ID マッピングテーブルを作成する場合、増分処理を有効にすることで、ワークフロー内の新規、更新、または削除されたレコードのみを処理できます。

**ルールベースのメソッドを使用して新しい ID マッピングテーブルを作成してデータを入力するには**

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

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

1. コラボレーションを選択し、**エンティティ解決**タブを選択します。

1. **[ID マッピングテーブルを作成]** を選択します。

1. **ID マッピング設定**で、次のいずれかを実行します。
   + 新しいワークフローを作成するには、**新しい ID マッピングワークフローの作成**を選択したままにします。
   + 既存のワークフローを使用するには、チェックボックスをオフにしてドロップダウンリストからワークフローを選択し、ステップ 9 に進みます。

1. **ID データ**で、ソースとターゲットを表示または設定します。
   + 単一の ID 名前空間ペアの場合: 事前に選択された**ソース**と**ターゲット**を確認します。
   + 複数の ID 名前空間の場合: ドロップダウンリストから**ソース**と**ターゲット**を選択します。

1. (オプション) **増分処理をオンに**して、ワークフロー内の新規、更新、または削除されたレコードのみを処理します。

   AWS Entity Resolution は、ID マッピングテーブル全体を再作成するのではなく、ソース ID またはターゲット ID 名前空間の新規、更新、または削除されたレコードのみを処理します。

   このオプションを選択したままにすると、 は ID マッピングテーブルでデフォルトのバッチ処理 ID マッピングワークフロー AWS Entity Resolution を実行します。

1. **ルールパラメータ**で、以下を設定します。
   + **ルールコントロール** – **ターゲット**または**ソース**が一致するルールを提供するかどうかを選択します。

     **[ルールを表示]** をオンにすると、ルールを表示できます。

     ルールコントロールは、ID マッピングワークフローで使用されるソース ID とターゲット ID 名前空間の間で互換性がある必要があります。例えば、ソース ID 名前空間がルールをターゲットに制限するが、ターゲット ID 名前空間がルールをソースに制限する場合、エラーが発生します。
   + **[比較タイプ]** は、自動的に **[複数の入力フィールド]** に設定されます。

     これは、両方の参加者が以前にこのオプションを選択したためです。
   + **レコードマッチング**
     + 1 **つのソースから 1 つのターゲット** – ターゲットごとに 1 つの一致するレコードを保存します 
     + 1 **つのターゲットへの多くのソース** – ターゲットごとに一致するすべてのレコードを保存します 
**注記**  
ソース ID 名前空間とターゲット ID 名前空間に指定されている制限は、互換性がある必要があります。

1. **ID マッピングの詳細については**、以下を設定します。

   1. **ID マッピングテーブル名**を入力するか、デフォルト名のままにします。

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

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

1. **AWS Clean Rooms アクセス**するには、次のいずれかを選択します。
   + **アクセス許可ポリシーの追加と管理 AWS Clean Rooms を許可する** – サービスロールを自動的に作成します。
   + アクセス**許可を手動で追加および管理** – リソースポリシーを確認して変更するか、**ポリシーステートメントの追加**を選択します。
**注記**  
ロールポリシーを変更できない場合は、 がサービスロールのポリシーを見つけ AWS Clean Rooms られなかったことを示すエラーメッセージが表示されます。

1. **AWS Entity Resolution アクセス**するには、次のいずれかを選択します。

   このセクションは、新しい ID マッピングテーブルを作成する場合にのみ表示されます。
   + **新しいサービスロールを作成して使用**
     + デフォルトの [サービスロール名] は `entityresolution-id-mapping-workflow-<timestamp>` です。
     + (オプション) 暗号化されたデータの場合は、**このデータは KMS キーによって暗号化**され、**AWS KMS キー**を入力します。
   + **既存のサービスロールを使用**
     + ドロップダウンリストから**既存のサービスロール名**を選択するか、ロール ARN を入力します。

       ロールを一覧表示するアクセス許可がある場合は、ロールのリストが表示されます。

       [**IAM で表示**] 外部リンクを選択してサービスロールを表示します。

       既存のサービスロールがない場合、**[既存のサービスロールを使用]** オプションは使用できません。

       デフォルトでは、 AWS Clean Rooms は既存のロールポリシーを更新して必要なアクセス許可を追加しようとしません。
     + (オプション) **必要なアクセス許可を持つ事前設定済みポリシーをこのロールに追加**して、必要なアクセス許可をロールにアタッチします。

       ロールを変更したりポリシーを作成したりするには、アクセス許可が必要です。

1. (オプション) **追加設定**で、以下を設定します。

   1. **ID マッピングテーブルの設定**
      + カスタム暗号化を有効にするには、**暗号化設定をカスタマイズ**を選択し、 AWS KMS キーを入力します。
**注記**  
 この KMS キーは、 内で KMS キーポリシー`cleanrooms.amazonaws.com`を使用するために必要なアクセス許可 AWS Entity Resolution を に付与する必要があります。ID マッピングワークフローで暗号化を使用するために必要なアクセス許可の詳細については、「*AWS Entity Resolution ユーザーガイド*」の「[AWS Entity Resolutionのワークフロージョブロールを作成する](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-workflow-job-role.html)」を参照してください。
      + タグを追加するには、**新しいタグを追加**を選択し、キーと値のペアを入力します 

   1. **ID マッピングワークフロー設定** (新しいワークフローのみ):
      + 異なる名前を使用するには、**「同じ ID マッピングテーブルの名前と説明を保持**」と「新しい値」を入力します。
      + タグを追加するには、**新しいタグを追加**を選択し、キーと値のペアを入力します 

1. 次のいずれかを選択します。
   + **ID マッピングテーブル**の作成 – 後で入力できる空のテーブルを作成します ([既存の ID マッピングテーブルへのデータ入力](populate-id-mapping-table.md))
   + **ID マッピングテーブルの作成と入力** – テーブルを作成してすぐに入力します (数時間かかる場合があります）。

   ID マッピングワークフロープロセスが開始されます。このプロセス中、ID マッピングテーブルには変換された ID が入力されます。ID マッピングワークフローの処理には数時間かかる場合があります。

   ID マッピングテーブルに正常にデータが入力されたら、[ID マッピングテーブルのクエリを実行](query-id-mapping-tables.md)して `sourceId` を `targetId` と結合し、データを分析できます。

## ID マッピングテーブルを作成する (プロバイダーサービス)
<a name="create-id-mapping-table-provider-services"></a>

このトピックでは、プロバイダーサービス (LiveRamp) を使用する ID マッピングテーブルを作成するプロセスについて説明します。LiveRamp プロバイダーサービスは、保持された RampID または派生された RampID を使用して、ソース RampID のセットを変換します。

**プロバイダーサービスのメソッドを使用して新しい ID マッピングテーブルを作成するには**

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

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

1. コラボレーションを選択し、**エンティティ解決**タブを選択します。

1. **[ID マッピングテーブルを作成]** を選択します。

1. **ID マッピング設定**で、次のいずれかを実行します。
   + 新しいワークフローを作成するには、**新しい ID マッピングワークフローの作成**を選択したままにします。
   + 既存のワークフローを使用するには、チェックボックスをオフにしてドロップダウンリストからワークフローを選択し、ステップ 9 に進みます。

1. **ID データ**で、ソースとターゲットを表示または設定します。
   + 単一の ID 名前空間ペアの場合: 事前に選択した**ソース**と**ターゲット**を確認します。
   + 複数の ID 名前空間の場合: ドロップダウンリストから**ソース**と**ターゲット**を選択します。

1. **[メソッド]**で、選択した ID マッピングワークフローメソッドが **[LiveRamp トランスコーディング]** であることを確認します。

1. **LiveRamp 設定**の場合は、次のいずれかを実行します。
   + **LiveRamp ID マネージャー ARN** と **LiveRamp シークレットマネージャー ARN** を入力します。
   + **既存のワークフローからインポート**を選択します。

1. **ID マッピングの詳細については**、以下を設定します。

   1. **ID マッピングテーブル名**を入力するか、デフォルト名のままにします。

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

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

1. **AWS Clean Rooms アクセス**するには、次のいずれかを選択します。
   + **アクセス許可ポリシーの追加と管理 AWS Clean Rooms を許可する** – サービスロールを自動的に作成します。
   + アクセス**許可を手動で追加および管理** – リソースポリシーを確認して変更するか、**ポリシーステートメントの追加**を選択します。
**注記**  
ロールポリシーを変更できない場合は、 がサービスロールのポリシーを見つけ AWS Clean Rooms られなかったことを示すエラーメッセージが表示されます。

1. **AWS Entity Resolution アクセス**の場合は、1 つ選択します。

   このセクションは、新しい ID マッピングテーブルを作成する場合にのみ表示されます。
   + **新しいサービスロールを作成して使用**
     + デフォルトの [サービスロール名] は `entityresolution-id-mapping-workflow-<timestamp>` です。
     + (オプション) 暗号化されたデータの場合は、**このデータは KMS キーによって暗号化**され、**AWS KMS キー**を入力します。
   + **既存のサービスロールを使用**
     + ドロップダウンリストから**既存のサービスロール名**を選択するか、ロール ARN を入力します。

       ロールを一覧表示するアクセス許可がある場合は、ロールのリストが表示されます。

       [**IAM で表示**] 外部リンクを選択してサービスロールを表示します。

       既存のサービスロールがない場合、**[既存のサービスロールを使用]** オプションは使用できません。

       デフォルトでは、 AWS Clean Rooms は既存のロールポリシーを更新して必要なアクセス許可を追加しようとしません。
     + (オプション) **必要なアクセス許可を持つ事前設定済みポリシーをこのロールに追加して**、必要なアクセス許可をロールにアタッチします。

       ロールを変更したりポリシーを作成したりするには、アクセス許可が必要です。

1. (オプション) **追加設定**で以下を設定します。

   1. **ID マッピングテーブルの設定**
      + カスタム暗号化を有効にするには、**暗号化設定をカスタマイズ**を選択し、 AWS KMS キーを入力します。
**注記**  
 この KMS キーは、 内で KMS キーポリシー`cleanrooms.amazonaws.com`を使用するために必要なアクセス許可 AWS Entity Resolution を に付与する必要があります。ID マッピングワークフローで暗号化を使用するために必要なアクセス許可の詳細については、「*AWS Entity Resolution ユーザーガイド*」の「[AWS Entity Resolutionのワークフロージョブロールを作成する](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-workflow-job-role.html)」を参照してください。
      + タグを追加するには、**新しいタグを追加**を選択し、キーと値のペアを入力します。

   1. **ID マッピングワークフロー設定** (新しいワークフローのみ):
      + 別の名前を使用するには、**「同じ ID マッピングテーブルの名前と説明を保持**」と「新しい値」を入力します。
      + タグを追加するには、**新しいタグを追加**を選択し、キーと値のペアを入力します。

1. 次のいずれかを選択します。
   + **ID マッピングテーブル**の作成 – 後で入力できる空のテーブルを作成します ([既存の ID マッピングテーブルへのデータ入力](populate-id-mapping-table.md))
   + **ID マッピングテーブルの作成と入力** – テーブルを作成してすぐに入力します (数時間かかる場合があります）。

   ID マッピングワークフロープロセスが開始されます。このプロセス中、ID マッピングテーブルには変換された ID が入力されます。ID マッピングワークフローの処理には数時間かかる場合があります。

   ID マッピングテーブルに正常にデータが入力されたら、[ID マッピングテーブルのクエリを実行](query-id-mapping-tables.md)して `sourceId` を `targetId` と結合し、データを分析できます。

# 既存の ID マッピングテーブルへのデータ入力
<a name="populate-id-mapping-table"></a>

ID 名前空間に新しいデータが追加されたら、このワークフローを使用します。[ID マッピングテーブルの作成](create-id-mapping-table.md#create-id-mapping-table-rule-based)時に増分処理を有効にすることを選択した場合、ID マッピングテーブル全体を再作成するのではなく、ソース ID 名前空間またはターゲット ID 名前空間のいずれかで新規、更新、または削除されたレコードのみを処理できます。

**既存の ID マッピングテーブルにデータを入力するには**

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

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

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

1. **エンティティ解決**タブに移動します。

1. **ID マッピングテーブル**セクションで、ID マッピングテーブルを選択します。

1. この ID マッピングテーブルの増分処理を有効にしていない場合は、ID マッピングテーブルを選択し、**入力**を選択します。

1. この ID マッピングテーブルの増分処理を有効にしている場合は、 **で入力**を選択し、次のいずれかを選択します。
   + **増分処理** – ソース ID またはターゲット ID 名前空間のいずれかで、新規、更新、または削除されたレコードのみを処理します。

      頻繁な更新、日次実行、またはリアルタイムのデータ同期に推奨されます。
   + **バッチ処理** – ID マッピングテーブル全体を処理します。

      初期設定、定期的なフル更新、またはソース ID 名前空間とターゲット ID 名前空間の両方で大幅な変更が発生した場合に推奨されます。
   + **削除のみの処理** – ソース ID 名前空間から削除されたレコードのみを処理し、それに応じてターゲット ID 名前空間を更新します。

      削除をすばやく同期するために推奨されます。

1. ID マッピングワークフロープロセスが開始されます。

   このプロセス中、ID マッピングテーブルにはトランスコーディングされた ID が入力されます。ID マッピングワークフローの処理には数時間かかる場合があります。

ID マッピングテーブルに正常にデータが入力されたら、[ID マッピングテーブルのクエリを実行](query-id-mapping-tables.md)して `sourceId` を `targetId` と結合できます。

# ID マッピングテーブルの編集
<a name="edit-id-mapping-table"></a>

コラボレーションメンバーは、作成した ID マッピングテーブルを編集できます。

**ID マッピングテーブルを編集するには**

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

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

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

1. **[エンティティ解決]** タブを選択します。

1. **[ID マッピングテーブル]** で、テーブルを選択します。

1. ID マッピングテーブルの詳細ページで、下へスクロールして **[ID マッピングテーブルの詳細]** を表示します。

1. **[編集]** を選択します。

1. **[ID マッピングテーブルを編集]** ページで、**[説明]** または **[サービスアクセス情報]** を更新します。

1. **[Save changes]** (変更の保存) をクリックします。

# ID マッピングテーブルの削除
<a name="delete-id-mapping-table"></a>

コラボレーションメンバーは、作成した ID マッピングテーブルを削除できます。このアクションにより、クエリを行えるメンバーはテーブルでクエリを実行できなくなります。

**警告**  
マッピングテーブルを削除すると、入力されたデータは完全に削除されます。

**ID マッピングテーブルを削除するには**

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

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

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

1. **[エンティティ解決]** タブを選択します。

1. [ID マッピングテーブル] で、テーブルを選択します。

1. ID マッピングテーブルの詳細ページで、下へスクロールして **[ID マッピングテーブル]** を表示します。

1. ID マッピングテーブルを選択し、**[削除]** を選択します。

1. ID マッピングテーブルを削除してよい場合は、**[削除]** を選択します。