UI でのローカルファイルアップロードソースコネクタの作成

このチュートリアルでは、ユーザーインターフェイスを使用してローカルファイルを Platform に取り込むためのローカルファイルアップロードソースコネクタを作成する手順を説明します。

はじめに

このチュートリアルは、 Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

Platform へのローカルファイルのアップロード

プラットフォーム UI で、左のナビゲーションバーから「 ソース 」を選択して、「 ソース 」ワークスペースにアクセスします。 カタログ 画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択できます。 または、検索オプションを使用して、目的の特定のソースを見つけることもできます。

「ローカルシステム」カテゴリで、「ローカルファイルのアップロード」を選択し、「設定」を選択します。

カタログ

既存のデータセットを使用する

データフローの詳細 ページでは、CSV データを既存のデータセットに取り込むか、新しいデータセットに取り込むかを選択できます。

CSV データを既存のデータセットに取り込むには、「既存のデータセット」を選択します。 詳細検索 オプションを使用するか、ドロップダウンメニューで既存のデータセットのリストをスクロールして、既存のデータセットを取得できます。

select-existing-dataset

With a dataset selected, provide a name for your dataflow and an optional description.

このプロセスの間に、エラー診断 および 部分取得 を有効にすることもできます。 エラー 診断では、データフローで発生したエラーレコードの詳細なエラーメッセージ生成が可能で す。部分的な取り込みで は、エラーを含むデータを、手動で定義した特定のしきい値まで取り込むことができます。詳しくは、 バッチの部分取得の概要 を参照してください。

dataflow-detail-existing

新しいデータセットの使用

CSV データを新しいデータセットに取り込むには、「新しいデータセット」を選択し、出力データセット名と説明(オプション)を入力します。 次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。

select-new-dataset

With a schema selected, provide a name for your dataflow and an optional description, and then apply the Error diagnostics and Partial ingestion settings you want for your dataflow. 終了したら、「次へ」を選択します。

Select data

The Select data step appears, providing you an interface to upload your local files and preview their structure and contents. 「ファイル を選択」を選択して、ローカルシステムから CSV ファイルをアップロードします。 または、アップロードする CSV ファイルを ファイルをドラッグ&ドロップ パネルにドラッグ&ドロップできます。

ヒント

現在、ローカルファイルのアップロードでは CSV ファイルのみがサポートされています。 各ファイルの最大ファイルサイズは 1 GB です。

choose-files

ファイルがアップロードされると、プレビューインターフェイスが更新され、ファイルの内容と構造が表示されます。

preview-sample-data

ファイルに応じて、ソースデータの列区切り文字(タブ、コンマ、パイプ、カスタム列区切り文字など)を選択できます。 区切り文字 ドロップダウン矢印を選択し、メニューから適切な区切り文字を選択します。

終了したら、「次へ」を選択します。

delimiter

マッピング

マッピング 手順が表示され、ソーススキーマのソースフィールドをターゲットスキーマの適切なターゲット XDM フィールドにマッピングするインターフェイスが提供されます。

mapping-interface

データのプレビュー

データのプレビュー」を選択すると、選択したデータセットから最大 100 行のサンプルデータのマッピング結果が表示されます。

プレビューとマッピング

プレビュー時、ID 列は最初のフィールドとして優先付けされます。マッピング結果を検証する際に必要な重要な情報です。 終了したら、「閉じる」を選択します。

プレビューパネル

計算フィールドの追加

計算フィールドでは、入力スキーマの属性に基づいて値を作成できます。 これらの値をターゲットスキーマの属性に割り当て、名前と説明を指定して参照を容易にできます。

計算済みフィールドを追加」ボタンを選択して次に進みます。

add-calculated-field

計算フィールドの作成 パネルが表示されます。 左側のダイアログボックスには、計算フィールドでサポートされるフィールド、関数、演算子が含まれています。タブの 1 つを選択して、式エディターに関数、フィールドまたは演算子を追加します。

create-calculated-field

タブ 説明
関数 「関数」タブには、データの変換に使用できる関数が一覧表示されます。計算フィールド内で使用できる関数の詳細については、 データ準備(マッパー)関数の使用 に関するガイドを参照してください。
フィールド 「フィールド」タブには、ソーススキーマで使用できるフィールドと属性が表示されます。
演算子 「演算子」タブには、データの変換に使用できる演算子が一覧表示されます。

式エディターを選択して、フィールド、関数、演算子を手動で追加します。 Once you have created a calculated field, select Save to proceed.

式エディター

Filter source schema mapping tree

ソーススキーマをフィルタリングするには、「すべてのソースフィールド」を選択し、ドロップダウンメニューからマッピングする特定のフィールドを選択します。

次の表に、ソーススキーマツリーの並べ替えオプションを示します。

ソースフィールド 説明
すべてのソースフィールド このオプションは、ソーススキーマのすべてのソースフィールドを表示します。 このオプションはデフォルトで表示されます。
必須フィールド このオプションは、ソーススキーマをフィルタリングして、マッピングの完了に必要なフィールドのみを表示します。
ID フィールド このオプションでは、ソーススキーマをフィルタリングして、ID としてマークされたフィールドのみを表示します。
マッピングされたフィールド このオプションは、ソーススキーマをフィルタリングして、既にマッピングされているフィールドのみを表示します。
マッピングされていないフィールド このオプションでは、ソーススキーマをフィルタリングして、まだマッピングされていないフィールドのみを表示します。
レコメンデーションを含むフィールド このオプションでは、ソーススキーマをフィルタリングして、マッピングレコメンデーションを含むフィールドのみを表示します。

all-source-fields

Intelligent recommendations

Platform automatically provides intelligent recommendations for auto-mapped fields based on the target schema or dataset that you selected. You can manually adjust mapping rules to suit your use cases.

source-schema-tree

すべての自動生成マッピング値を受け入れるには、「すべてのターゲットフィールドを受け入れる」を選択します。

all-target-fields

ソーススキーマに複数のレコメンデーションが使用できる場合があります。 この場合、マッピングカードには最も目立つレコメンデーションが表示され、その後に使用可能なレコメンデーションの数を示す青い円が表示されます。 電球アイコンを選択すると、追加の推奨事項のリストが表示されます。 代わりに、マッピング先のレコメンデーションの横にあるチェックボックスを選択して、代替レコメンデーションの 1 つを選択できます。

手動マッピング

または、ソーススキーマを手動でターゲットスキーマにマッピングすることもできます。 それには、マッピングするソーススキーマの上にマウスポインターを置き、プラス (+) アイコンを選択します。

select-plus-icon

ソースをターゲットフィールドにマッピング」ポップオーバーが表示されます。 ここから、マッピングするフィールドを選択し、「保存」を選択して新しいマッピングを追加できます。

map-source-to-target-field

終了したら、「終了」を選択します。

終了

データ取得の監視

CSV ファイルがマッピングされ、作成されたら、監視ダッシュボードを使用して、CSV ファイルを通じて取り込まれるデータを監視できます。 For more information, see the tutorial on monitoring sources dataflows in the UI.

次の手順

このチュートリアルに従うと、フラットな CSV ファイルを XDM スキーマにマッピングし、Platform に取り込むことができます。このデータは、Real-time Customer Profile などのダウンストリームの Platform サービスで使用できるようになりました。 詳しくは、Real-time Customer Profile の概要を参照してください。

このページ