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

# スキーママッピングの作成
<a name="create-schema-mapping"></a>

この手順では、 [AWS Entity Resolution コンソール](https://console.aws.amazon.com/entityresolution/home)を使用してスキーママッピングを作成するプロセスについて説明します。

スキーママッピングを作成するには、次の 3 つの方法があります。
+ Import **from AWS Glue**オプションを使用して既存の入力データをインポートする – この作成方法を使用して、ガイド付きフローを使用して AWS Glue テーブルから事前入力された列で始まる入力フィールドを定義します。
+ **カスタムスキーマの構築**オプションを使用して入力データを手動で定義する – この作成方法を使用して、ガイド付きフローを使用して入力フィールドを手動で定義します。
+ **JSON エディタ**の使用オプションを使用して手動で作成 – JSON エディタを使用して、既存の入力データを手動で作成、使用、またはインポートします。
**注記**  
このオプションでは、**一意の ID** フィールドと**入力フィールド**は使用できません。

------
#### [ Import from AWS Glue ]

**から既存の入力データをインポートしてスキーママッピングを作成するには AWS Glue**

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

1. 左側のナビゲーションペイン**のデータ準備**で、**スキーママッピング**を選択します。

1. **スキーママッピング**ページの右上隅で、**スキーママッピングの作成**を選択します。

1. **ステップ 1: スキーマの詳細を指定する**には、次の手順を実行します。

   1. **名前と作成方法**には、**スキーママッピング名**とオプションの **説明**を入力します。

   1. **作成方法** で、 **からインポート AWS Glue**を選択します。

   1. [**AWS リージョン**] を選択します。

   1. **AWS Glue データベース**を選択します。

   1. **AWS Glue テーブル**を選択します。

      新しいテーブルを作成するには、 AWS Glue コンソール [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) に移動します。詳細については、 *AWS Glue ユーザーガイド*の[AWS Glue 表](https://docs.aws.amazon.com/glue/latest/dg/tables-described.html)を参照してください。

   1. **一意の ID** には、データの各行を個別に参照する列を指定します。  
**Example**  

      たとえば、**Primary\$1key**、**Row\$1ID**、または **Record\$1ID** などです。
**注記**  
**一意の ID** 列は必須です。**一意の ID** は、単一のテーブル内の一意の識別子である必要があります。ただし、異なるテーブル間で、**一意の ID** に重複した値を含めることができます。**一意の ID** が指定されていない、同じソース内で一意ではない、またはソース間で属性名の点で重複している場合、 は一致するワークフローの実行時にレコード AWS Entity Resolution を拒否します。ルールベースのマッチングワークフローでこのスキーママッピングを使用している場合、**一意の ID** は 38 文字を超えることはできません。

   1. **入力フィールド**で、マッチングに使用する列とオプションのパススルーに使用する列を選択します。

      マッチングとパススルーの両方で最大 34 列を選択できます。

      1. **「マッチング**」で、マッチングの入力フィールドとして使用する列を選択します。

         マッチングには最大 24 列を選択できます。

      1. マッチング**に使用されない列を指定する場合は、パススルーする列を追加する**を選択します。

      1. (オプション) **パススルー**で、パススルー列として含める列を選択します。
**注記**  
機械学習ベースのマッチングワークフローを実行するときは、データ内の列名として、`MatchId`「」、`MatchRule`「」、`RecordId`「」、`SourceId`「」、「」、`TargetId`「」のいずれかの予約名を使用しないでください。これらの予約名のいずれかを使用すると、命名が競合し、ML ベースのマッチングワークフローが失敗します。

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

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

1. **ステップ 2: 入力フィールドをマッピング**するには、マッチングに使用する入力フィールドとオプションのパススルーに使用する入力フィールドを定義します。

   1. **一致する入力フィールドについては**、各**入力フィールド**について、
      + データを分類する**属性タイプ**を指定します。
      + **一致キー名**を指定して、入力フィールドを一致するワークフローと比較できるようにします。特定の一致キー名は、デフォルトで特定の属性タイプに自動的に関連付けられます。
      + その入力フィールドの列値が**ハッシュ**されている場合はハッシュチェックボックスをオンにし、値がクリアテキストの場合はチェックボックスを空白のままにします。
**注記**  
LiveRamp プロバイダーのサービスベースのマッチング手法で使用するスキーママッピングを作成する場合は、次のことができます。  
プロバイダー ID の**属性タイプ**を **LiveRamp ID** として指定します。
**名前**フィールドの**属性タイプ**を複数のフィールド (**名**、**姓**など) または 1 つのフィールドで指定します。
**住所**フィールドの**属性タイプ**を複数のフィールド (**住所 1**、**住所 2**、 など) または 1 つのフィールド (**住所全体**) で指定します。  
アドレスと照合する場合は、郵便番号 (**郵便番号**) が必要です。
名前に E メール (**E メールアドレス**) または電話番号 (**電話番号**) を含めると、それらのフィールドは住所と照合できます。
**注記**  
TransUnion プロバイダーのサービスベースのマッチング手法で使用するスキーママッピングを作成する場合は、次のいずれかの**属性タイプ**を指定できます。  
**フルネーム**、**名**、**姓**
**住所**、**住所 1**、**市**区町村、**都道府県**、**国**、**郵便番号**
**Phone number** (電話番号)
**[E メールアドレス]**
**日付**
**デジタル識別子**: **IPV4**、**IPV6**、または **MAID**
**注記**  
機械学習ベースのマッチングワークフローで使用するスキーママッピングを作成する場合、データセットには次の**属性タイプ**の少なくとも 1 つが含まれている必要があります。  
**フルネーム**
**フルアドレス**
**フルフォン**
**[E メールアドレス]**
**** **一致キー名が****生年月日**の日付
これらの属性の属性**タイプ**を**カスタム文字列**として指定しないでください。

   1. (オプション) **パススルーの入力フィールドには**、一致しない入力フィールドと対応する**ハッシュステータス**を追加します。

      **ハッシュステータス**は、その入力フィールドの列値がハッシュかクリアテキストかを示します。

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

1. **ステップ 3: データをグループ化**するには、**名前**、**住所**、**電話番号**の入力フィールドを複数のフィールドに分割します。

   このステップでは、関連する入力フィールドを 1 つのフィールドに連結します。これにより、一致するワークフローの 1 つのフィールドとして比較できます。

   **名前**、**住所**、または**電話番号**の入力フィールドにデータがマッピングされていない場合、このセクションは空白になります。

   より多くのタイプのデータがある場合は、さらにグループを追加することもできます。

   1. **名前**入力データをグループ化する場合: 

      **フルネーム**で、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**は、データ型に自動的に関連付けられます。

      **グループ名**を更新でき、カスタム一致**キーで一致**キーには、文字、数字、アンダースコア (\$1)、ハイフン (-) など、最大 255 文字を含めることができます。

      **グループの追加** を選択して、別のグループを追加します。
**注記**  
正規化は**フルネーム**でのみサポートされています。  
**フルネーム**サブタイプを正規化する場合は、**フルネーム**グループに名、**ミドル****ネーム**、**姓**のサブタイプを割り当てます。

   1. **Address** 入力データをグループ化する場合: 

      **フルアドレス**で、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**。 は自動的にデータ型に関連付けられます。

      **グループ名**を更新でき、**カスタム一致キー**には、文字、数字、アンダースコア (\$1)、ハイフン (-) など、最大 255 文字を含めることができます。

      **グループの追加**を選択して、別のグループを追加します。
**注記**  
正規化は**フルアドレス**でのみサポートされます。  
**フルアドレス**サブタイプを正規化する場合は、**フルアドレス**グループに次のサブタイプを割り当てます。**住所 1**、**住所 2**: **住所 3 名**、**市名**、**州**、**国**、**郵便番号**。

   1. **電話**入力データをグループ化する場合: 

      **フルフォン**の場合は、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**。 は自動的にデータ型に関連付けられます。

      **グループ名**を更新でき、カスタム**一致キー**には、文字、数字、アンダースコア (\$1)、ハイフン (-) など、最大 255 文字を含めることができます。

      **グループの追加** を選択して、別のグループを追加します。
**注記**  
正規化は**フルフォン**でのみサポートされています。  
**完全な電話**サブタイプを正規化する場合は、**完全な電話**グループに**電話番号**と**電話の国コード**のサブタイプを割り当てます。

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

1. **ステップ 4: 確認して作成**するには、次の手順を実行します。

   1. 前のステップで行った選択内容を確認し、必要に応じて編集します。

   1. **スキーママッピングの作成** を選択します。
**注記**  
ワークフローに関連付けた後でスキーママッピングを変更することはできません。既存の設定を使用して新しいスキーママッピングを作成する場合は、スキーママッピングのクローンを作成できます。

スキーママッピングを作成したら、[一致するワークフローを作成する](create-matching-workflow.md)か、[ID 名前空間を作成する](id-namespace.md)準備が整います。

------
#### [ Build custom schema ]

****カスタムスキーマのビルドオプションを使用してスキーマ**マッピングを作成するには**

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

1. 左側のナビゲーションペイン**のデータ準備**で、**スキーママッピング**を選択します。

1. **スキーママッピング**ページの右上隅で、**スキーママッピングの作成**を選択します。

1. **ステップ 1: スキーマの詳細を指定する**には、次の手順を実行します。

   1. 名前と作成方法には、**スキーママッピング名**とオプションの **説明**を入力します。

   1. **作成方法** で、**カスタムスキーマの構築** を選択します。

   1. **一意の ID** には、データの各行を識別する一意の ID を入力します。  
**Example**  

      たとえば、**Primary\$1key**、**Row\$1ID**、または **Record\$1ID** などです。
**注記**  
**Unique ID** 列は必須です。**一意の ID** は、単一のテーブル内の一意の識別子である必要があります。ただし、異なるテーブル間で、**一意の ID** に重複した値を含めることができます。**一意の ID** が指定されていない、同じソース内で一意ではない、またはソース間で属性名の点で重複している場合、 は一致するワークフローの実行時にレコード AWS Entity Resolution を拒否します。ルールベースのマッチングワークフローでこのスキーママッピングを使用している場合、**一意の ID** は 38 文字を超えることはできません。

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

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

1. **ステップ 2: 入力フィールドをマッピング**するには、マッチングに使用する入力フィールドとオプションのパススルーに使用する入力フィールドを定義します。

   マッチングとパススルーの両方について、合計で最大 34 列を定義できます。

   1. **一致する入力フィールドには**、**入力フィールドに入力**します。
**注記**  
機械学習ベースのマッチングワークフローを実行するときは、データ内の列名として、`MatchId`「」、`MatchRule`「」、`RecordId`「」、`SourceId`「」、「」、`TargetId`「」のいずれかの予約名を使用しないでください。これらの予約名のいずれかを使用すると、命名が競合し、ML ベースのマッチングワークフローが失敗します。

   1. **属性タイプ**を選択してデータを分類します。
**注記**  
[LiveRamp プロバイダーのサービスベースのマッチング手法](create-matching-workflow-provider.md#create-mw-liveramp)で使用するスキーママッピングを作成する場合は、providerID **属性タイプ**を **LiveRamp ID** として指定できます。出力に PII データを含める場合は、**属性タイプ**を**カスタム文字列**として指定する必要があります。
**注記**  
TransUnion プロバイダーのサービスベースのマッチング手法で使用するスキーママッピングを作成する場合は、次のいずれかの**属性タイプ**を指定できます。  
**フルネーム**、**名**、**姓**
**住所**、**住所 1**、**市**区町村、**都道府県**、**国**、**郵便番号**
**Phone number** (電話番号)
**[E メールアドレス]**
**日付**
**デジタル識別子**: **IPV4**、**IPV6**、または **MAID**
**注記**  
[機械学習ベースのマッチングワークフロー](create-matching-workflow-ml.md)で使用するスキーママッピングを作成する場合、データセットには次の**属性タイプ**の少なくとも 1 つが含まれている必要があります。  
**フルネーム**
**フルアドレス**
**フルフォン**
**[E メールアドレス]**
**** **一致キー名が****生年月日**の日付
これらの属性の属性**タイプ**を**カスタム文字列**として指定しないでください。

   1. **一致キー名**を選択して、入力フィールドを一致するワークフローと比較できるようにします。

      特定の一致キー名は、デフォルトで特定の属性タイプに自動的に関連付けられます。

   1. その入力フィールドの列値が**ハッシュ**されている場合はハッシュされたチェックボックスを選択し、値がクリアテキストの場合はチェックボックスを空白のままにします。

   1. **入力フィールドの追加** を選択して、入力フィールドを追加します。

      マッチングには、最大 24 個の入力フィールドを追加できます。

   1. (オプション) **パススルーの入力フィールドには**、一致しない入力フィールドと対応する**ハッシュステータス**を追加します。

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

1. **ステップ 3: データをグループ化**するには、**名前**、**住所**、**電話番号**の入力フィールドを複数のフィールドに分割します。

   このステップでは、関連する入力フィールドを 1 つのフィールドに連結します。これにより、一致するワークフローで 1 つのフィールドとして比較できます。

   **名前**、**住所**、**電話番号**の入力フィールドにマッピングされたデータがない場合、このセクションは空白になります。

   より多くのタイプのデータがある場合は、さらにグループを追加することもできます。

   1. **名前**入力データをグループ化する場合: 

      **フルネーム**で、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**は、データ型に自動的に関連付けられます。

      **グループ名**を更新でき、**カスタム一致キー**には、文字、数字、アンダースコア (\$1)、ハイフン (-) など、最大 255 文字を含めることができます。

      **グループの追加**を選択して、別のグループを追加します。
**注記**  
正規化は**フルネーム**でのみサポートされています。  
**フルネーム**サブタイプを正規化する場合は、**フルネーム**グループに名、**ミドル****ネーム**、**姓**のサブタイプを割り当てます。

   1. **Address** 入力データをグループ化する場合: 

      **フルアドレス**で、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**。 は自動的にデータ型に関連付けられます。

      **グループ名**を更新でき、カスタム**一致キー**には、文字、数字、アンダースコア (\$1)、ハイフン (-) を含む最大 255 文字を含めることができます。

      **グループの追加** を選択して、別のグループを追加します。
**注記**  
正規化は**フルアドレス**でのみサポートされています。  
**フルアドレス**サブタイプを正規化する場合は、**フルアドレス**グループに次のサブタイプを割り当てます。**住所 1**、**住所 2**: **住所 3 名**、**市名**、**州**、**国**、**郵便番号**。

   1. **電話**入力データをグループ化する場合: 

      **フルフォン**の場合は、グループ化する**入力フィールド**を 2 つ以上選択します。

      **グループ名**と**一致キー**。 は自動的にデータ型に関連付けられます。

      **グループ名**を更新でき、カスタム一致**キーで一致**キーには、文字、数字、アンダースコア (\$1)、ハイフン (-) など、最大 255 文字を含めることができます。

      **グループの追加**を選択して、別のグループを追加します。
**注記**  
正規化は**フルフォン**でのみサポートされています。  
**完全な電話**サブタイプを正規化する場合は、**完全な電話**グループに**電話番号**と**電話の国コード**のサブタイプを割り当てます。

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

1. **ステップ 4: 確認して作成**するには、以下を実行します。

   1. 前のステップで行った選択内容を確認し、必要に応じて編集します。

   1. **スキーママッピングの作成** を選択します。
**注記**  
ワークフローに関連付けた後でスキーママッピングを変更することはできません。既存の設定を使用して新しいスキーママッピングを作成する場合は、スキーママッピングのクローンを作成できます。

スキーママッピングを作成したら、[一致するワークフローを作成する](create-matching-workflow.md)か、[ID 名前空間を作成する](id-namespace.md)準備が整います。

------
#### [ Use JSON editor ]

**JSON エディタを使用してスキーママッピングを作成するには**

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

1. 左側のナビゲーションペイン**のデータ準備**で、**スキーママッピング**を選択します。

1. **スキーママッピング**ページの右上隅で、**スキーママッピングの作成**を選択します。

1. **ステップ 1: スキーマの詳細を指定する**には、次の手順を実行します。

   1. 名前と作成方法には、**スキーママッピング名**とオプションの **説明**を入力します。

   1. **作成方法** で、**JSON エディタを使用する** を選択します。

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

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

1. **ステップ 2: マッピングを指定する**には:

   1. JSON エディタでスキーマの構築を開始するか、目標に基づいて次のいずれかのオプションを選択します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/entityresolution/latest/userguide/create-schema-mapping.html)
**注記**  
正規化は、、`NAME`、`ADDRESS`、`PHONE`および **のタイプ**でのみサポートされます`EMAIL_ADRESS`。  
`NAME` サブタイプを正規化する場合は、`NAME`**groupName** に次のサブタイプを割り当てます: `NAME_FIRST`、`NAME_MIDDLE`、および `NAME_LAST`  
`ADDRESS` サブタイプを正規化する場合は、、、`ADDRESS_STREET1`、、`ADDRESS_STREET2`、`ADDRESS_STREET3``ADDRESS_CITY``ADDRESS_STATE`、`ADDRESS_COUNTRY`および のサブタイプを `ADDRESS` **groupName** に割り当てます`ADDRESS_POSTALCODE`。  
`PHONE` サブタイプを正規化する場合は、`PHONE`**groupName** に次のサブタイプを割り当てます: `PHONE_NUMBER`および `PHONE_COUNTRYCODE`。

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

1. **ステップ 3: 確認して作成する**:

   1. 前のステップで行った選択内容を確認し、必要に応じて編集します。

   1. **スキーママッピングの作成** を選択します。
**注記**  
ワークフローに関連付けた後でスキーママッピングを変更することはできません。既存の設定を使用して新しいスキーママッピングを作成する場合は、スキーママッピングのクローンを作成できます。

スキーママッピングを作成したら、[一致するワークフローを作成する](create-matching-workflow.md)か、[ID 名前空間を作成する](id-namespace.md)準備が整います。

------