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

# データの接続
<a name="connecting-your-data"></a>

## 前提条件
<a name="connecting-your-data-prerequisites"></a>

データオンボーディングを開始する前に、以下を確認してください。
+ Amazon Connect 決定インスタンス
  + インスタンスは、関連付けられた S3 バケットで既に作成されている必要があります
+ 準備済みデータ
  + カスタマーサクセス担当者と協力して、Amazon Connect Decisions の使用方法に基づいて、必要なデータを決定します。基本データの要件は次のとおりです。
    + 販売/注文履歴: 12 か月以上のトランザクションレコード
    + 製品の詳細: 仕様を含む製品カタログを完成させる
    + サイト/ロケーション情報: 倉庫、ディストリビューションセンター、小売ロケーション
    + 現在の在庫保有: 各ロケーションの手元在庫
  + UTF-8 エンコードを使用した CSV 形式のすべてのソースデータ

## 最初のソースフローの作成
<a name="connecting-your-data-creating-first-source-flow"></a>

データのオンボーディングを開始するには、Amazon Connect Decisions の**データ管理**タブに移動します。ここでは、既存のソースフローをすべて確認できます。まだ設定していない場合は、**「新しいソースの作成**」を選択して開始します。

## ソースデータをアップロードする
<a name="connecting-your-data-upload-source-data"></a>

ユースケースに必要な CDM テーブルに基づいて、ソースデータを含む CSV ファイルをアップロードします。データ更新の処理方法を選択できます。
+ **追加**: 既存のデータに新しいデータを追加する
+ **置換**: 既存のデータを新しいデータに置き換える

ファイルをアップロードすると、Amazon Connect Decisions は S3 に以下のデータ用のフォルダ構造を自動的に作成します。
+ 選択したソースシステムにちなんで名付けられた親フォルダ
+ 選択したソーステーブル名の後に という名前のサブフォルダ
+ サブフォルダのすべてのファイルは、同じソーステーブルに対して保存されます。
+ このファイル構造は、Amazon S3 フォルダパスの作成にも使用されます。

## Source-to-CDM 送信先マッピング
<a name="connecting-your-data-source-to-cdm-destination-mapping"></a>

ファイルをアップロードすると、Amazon Connect Decisions はデータの分析を開始し、1 つ以上の Amazon Connect Decisions の CDM 送信先テーブルに自動的にマッピングします。

**期待すること**
+ このステップは、アップロードされたデータの量に応じて 10～15 分かかる場合があります。
+ データエージェントはバックグラウンドで動作し、ソースデータに最適な CDM 送信先データセットを特定します。
+ *このページから移動すると、自動マッピングが失敗します。*待機中は、Amazon Connect Decisions and Data Management タブを開いたままにして、自動マッピングが完了していることを確認してください。

完了すると、データエージェントは重複するデータに基づいてsource-to-destinationマッピングの理論的根拠を提供します。これらのデータを確認して、マッピング結果についてエージェントに質問できます。

ソースマッピングを確認して編集するには、次の操作を行います。
+ 自然言語を使用してデータエージェントと直接やり取りし、送信元と送信先のマッピングを更新します。
+ アクションオプションを選択し、**「ソースの編集**」を選択します。

### マッピングの編集
<a name="connecting-your-data-editing-mappings"></a>

ここから、次のことができます。
+ 必要に応じて、送信元と送信先のマッピングを手動で更新する
+ 画面の右側にあるデータエージェントを使用して質問し、マッピングを確認します。
+ 特定のデータセットの詳細については[、ユーザーガイド](https://docs.aws.amazon.com/aws-supply-chain/latest/userguide/data-model-asc.html)を参照してください。

## 列/データマッピング
<a name="connecting-your-data-column-data-mapping"></a>

source-to-destinationマッピングが完了すると、Amazon Connect Decisions は送信元データセットから CDM 送信先への SQL 変換クエリを自動的に作成します。マッピングが完了すると、データエージェントからマッピングの結果を詳述する通知が送信されます。

ここから、アクションメニューから「SQL **のレビュー」を選択して、マッピング用に生成された SQL** を確認する必要があります。

マッピング (SQL) を確認すると、以下が表示されます。
+ 追加したソースデータセット列
+ 参照先 CDM テーブル列
+ それらを接続している変換 SQL
+ データエージェントによって提供されるマッピングの根拠

### マッピングの編集
<a name="connecting-your-data-editing-column-mappings"></a>

マッピングを編集するには、次の 2 つのオプションがあります。
+ **データエージェントの使用**: 自然言語を使用してマッピングを質問、管理、更新する
+ **SQL を直接編集する**: SQL に精通している場合は、クエリを直接変更できます。

### 変更のテスト
<a name="connecting-your-data-testing-your-changes"></a>

マッピングクエリを編集するときは、**「テストクエリ**」機能を使用してテストを続行します。これにより、データの送信先 CDM への変換方法のサンプルがスクロール可能にプレビューされます。これを使用して、変換が正しく実行されることを確認し、送信source-to-destination CDM からの適切な更新を検証します。

マッピング出力に満足したら、「クエリの保存」を選択して、その送信元と送信先のペアの変換クエリを保存します。

## マッピングを確認して受け入れる
<a name="connecting-your-data-review-accept-mappings"></a>

各ソースデータセットの残りのマッピングを確認します。データエージェントは、質問やトラブルシューティングのヘルプのために、画面の右側で永続的に残ります。

すべてのマッピングに満足したら、受け入れてデータのオンボーディングを完了します。

**失敗したマッピングの処理**

マッピングが失敗した場合は、**「マッピングの再開**」を選択してすべてのマッピングを再起動するか、**「SQL 生成**の再試行」を介してアクションメニューから 1 つのマッピングを手動で再試行できます。データエージェントは自然言語を使用してマッピングを再試行することもでき、エラーが解決しない場合は引き続き問題の特定と解決に役立ちます。

## フローのモニタリング
<a name="connecting-your-data-monitor-your-flows"></a>

### 送信先タブ
<a name="connecting-your-data-destinations-tab"></a>

マッピングを受け入れると、**データ管理**内の**送信先**タブに移動し、以下を実行できます。
+ 送信先フローを確認する
+ マッピングの管理と編集 (「フローの管理」)
+ 古いフローを削除する
+ これらのフローの実行ステータスを確認する

**「フローの管理**」を選択すると、データマッピングエクスペリエンスに戻り、データエージェントと連携して時間の経過とともにマッピングを絞り込むことができます。

### ソースタブ
<a name="connecting-your-data-sources-tab"></a>

**ソース**タブに戻ります。
+ 作成されたソースデータセット
+ 関連付けられた S3 バケット
+ 以下のオプション:
  + 別のファイルアップロードを介してソースデータを追加する
  + フローを管理する
  + フローを削除する
  + 実行の確認

**「フローの管理**」を選択すると、データマッピングエクスペリエンスに戻ります。ここでは、データエージェントと引き続き連携し、時間の経過とともにマッピングを絞り込むことができます。

また、必要に応じて**新しいソースを作成して**、新しいデータソースのデータオンボーディングプロセスを再起動することもできます。

## ベストプラクティス
<a name="connecting-your-data-best-practices"></a>

**データの準備**
+ 「前提条件」セクションのステップに従う
+ すべての CSV ファイルで UTF-8 エンコードを使用する
+ ファイル名が一意であることを確認する
+ アップロード前にデータ品質を検証する

**データエージェントの使用**
+ リクエストに具体的に記述する
+ 決定事項がわからない場合は説明を求める
+ 受け入れる前にすべての SQL 変更をテストする
+ プレビュー機能を使用して変換を検証する

**継続的なメンテナンス**
+ ソースデータを最新の状態に保つ
+ フロー実行を定期的にモニタリングする
+ 通知されたらすぐにデータエラーに対処する
+ チームのカスタム変換を文書化する