[Beta]{class="badge informative"}
UI での Databricks Delta Sharing ソースコネクタの使用 use-deltashare-in-the-ui
このガイドでは、Adobe Experience Platform ユーザーインターフェイスでDatabricks Delta Sharing ソースコネクタを使用する方法について説明します。
基本を学ぶ
このチュートリアルでは、次のExperience Platform コンポーネントについて理解する必要があります。
- ソース : ソースを使用して、サポートされている外部データソースの接続とデータフローを作成します。
- Experience Data Model （XDM） スキーマ ：共有テーブルは、リレーショナルスキーマを通じてExperience Platformで表されます。
- データセット ：共有データは、Experience Platformでバーチャルデータセットとして表されます。 ソースデータは、Experience Platform データレイクに物理的に取り込まれたり、コピーされたりすることはありません。
- クエリサービス / データDistiller: クエリサービスまたはData Distillerを使用して、バーチャルデータセットを照会および操作します。
ソースカタログを移動する
Experience Platform UIで、左側のナビゲーションから「ソース」を選択して、ソース ワークスペースにアクセスします。 カテゴリー パネルで適切なカテゴリーを選択します。 または、検索バーを使用して、使用する特定のソースに移動します。
Delta Sharingを使用するには、データ共有の下にあるDelta Sharing for Databricks ソースカードを選択し、データを追加を選択します。
既存のアカウントの使用
既存のアカウントを使用するには、既存のアカウントを選択し、アカウントインターフェイスから使用するDelta Sharing アカウントを選択します。
新しいアカウントを作成
新しいアカウントを作成するには、新しいアカウントを選択し、アカウントの名前とオプションの説明を指定します。 次の認証情報の値を指定します。
- エンドポイント
- Bearer トークン
- 資格情報バージョンを共有
- 有効期限
完了したら、ソースに接続を選択し、接続が確立されるまでしばらく待ちます。
データの選択
次に、Experience Platformおよびプラットフォームベースのアプリケーションでバーチャルデータセットを作成する対象を選択します。 テーブルディレクトリを使用して目的のデータに移動し、プレビューインターフェイスを使用して、選択したデータの内容と構造を表示します。 完了したら、次へを選択して、スキーマの列を選択します。
スキーマの選択
Delta Sharing ソースからテーブルを選択すると、Experience Platformはリレーショナルスキーマを自動的に推測します。 この段階では、続行する前にスキーマ名を指定する必要があります。 オプションで、プライマリキーと バージョン記述子 を指定して、さらにスキーマを定義することもできます。
プライマリキー：テーブルにプライマリキーがある場合は、プライマリキーを設定します。 プライマリキーを選択する際には、次の要素を考慮してください。
- 対象となる論理エンティティの行ごとに一意のキーを選択します（例：注文ごとに1行、顧客ごとに1行、トランザクションごとに1行）。
- 時間の経過とともに安定しているキーを選択します（一度書き込まれると変更されません）。
- ガバナンスにとって意味のない基数の高いビジネス以外のサロゲートではないキー（例えば、アップストリームが再生成するランダムな「row_id」）を選択します。
バージョン記述子: バージョン記述子は、特定のキーの「最新」レコードである行を示す列をマークします。 テーブルに同じエンティティの複数のバージョンが保存されており、現在または最新のバージョンを明確に定義する方法が必要な場合は、これを参照として使用します。 バージョン記述子を選択する際には、次の要素を考慮してください。
last_updated_atやmodified_tsなどのタイムスタンプ。version_numやsequence_numberなどの数値バージョンが増加しています。
次のシナリオに該当する場合は、バージョン記述子を空のままにできます。
- テーブルは純粋にトランザクション/イベントレベルです（つまり、各行は1回限りのイベントであり、バージョンを持つ可変「エンティティ」を表しません）。
- 信頼できる「最新」インジケーターカラムはありません。
- タイムスタンプ/バージョン列が実際に何を意味するのかを検証していません。
データセットとデータフローの詳細を提供
データセットは、データのコレクション（通常はテーブル）の管理構造で、列またはフィールドを持つスキーマを含みます。 Data Sharingでは、選択したデータはExperience Platformでバーチャルデータセットとして表されます。 データはソースシステム内に残り、データレイクに取り込まれたり保持されたりすることはありません。
仮想データセットを設定したら、名前、オプションの説明、アラート設定など、データフローの詳細を指定します。
Experience Platformは、ユーザーが購読できるイベントベースのアラートを生成できます。これらのオプションを使用すると、実行中のデータフローがこれらのアラートをトリガーできます。 詳しくは、 アラートの概要を参照してください
- ソースデータフロー実行開始：このアラートを選択すると、データフロー実行が開始されたときに通知を受け取ります。
- ソースデータフローの実行成功：このアラートを選択すると、データフローがエラーなしで終了した場合に通知を受け取ります。
- ソースデータフロー実行エラー: データフロー実行がエラーで終了した場合に通知を受け取るには、このアラートを選択します。
データフローのレビュー
レビュー手順が表示され、データフローを作成する前に詳細を確認できます。 詳細は、次のカテゴリに分類されます。
- 接続: アカウント名、ソースプラットフォーム、およびソース名を表示します。
- データセットとマップフィールドを割り当てる：ターゲットデータセットと、データセットが準拠しているスキーマを表示します。
詳細が正しいことを確認したら、完了を選択します。
データフローの監視
データフローを作成したら、そのステータスとアクティビティを監視して、実行ステータス、成功、エラーなどの情報を表示できます。 詳しくは、UIでのアカウントとデータフローの監視に関するチュートリアル を参照してください。