[限定提供]{class="badge informative"}

関係スキーマ

関係スキーマは、Adobe Experience Platform データレイク内の構造化データを表現するための、柔軟で制御されたモデリングパターンを提供します。 結合スキーマや包括的なリレーショナルデータベースシステムに依存することなく、強制的なプライマリキー、スキーマレベルの関係、レコードの詳細な制御などをサポートします。

リレーショナルスキーマを使用すると、次のことが可能になります。

リレーショナルスキーマと標準XDM スキーマの違い

Experience Platformの標準XDM スキーマは、レコード、時系列、アドホックの3つのデータビヘイビアーのいずれかに従います。 定義と詳細については、XDM データ動作を参照してください。

従来のモデルでは、レコードと時系列のスキーマは結合スキーマ ​に参加します（結合スキーマ UI ガイド ​も参照）。 これらのスキーマは、共有​ フィールドグループ ​が更新され、カスタムフィールドをテナント名前空間の下にネストする必要がある場合に、自動的に進化します。 このモデルは強力ですが、オンボーディングが遅くなったり、未使用のフィールドを含む複雑すぎるスキーマが生成されたり、追加のデータマッピングや変換が必要になったりする可能性があります。 これらの要因により、学習時間と継続的なメンテナンスの労力が増加します。

リレーショナルスキーマは、結合スキーマの依存関係を削除します。これにより、共有フィールドグループからの自動更新が不要になり、テナント名前空間の制限なしに直接フィールド定義を行うことができます。 プライマリキー、関係、初期スキーマ設計などを明示的に制御できるため、作成時のニーズに合わせてデータを容易にモデル化できます。

関係スキーマの機能

ガバナンス、統合性、相互運用性を維持しながら、データレイク内の構造化データをモデル化するために、次の機能を使用します。

必須フィールド

関係スキーマには、主要な動作と制約を制御するスキーマ定義内のメタデータという、特定の記述子が必要です。 スキーマ定義の一部として、次の記述子を追加します。

プライマリキー記述子

プライマリキー記述子を使用して、各レコードが一意に識別できるようにします。 サポートされる設定は次のとおりです。

例（単一フィールド）:

{
  "xdm:descriptor": "xdm:descriptorPrimaryKey",
  "xdm:sourceProperty": "customerId"
}

例（時系列の複合）

{
  "xdm:descriptor": "xdm:descriptorPrimaryKey",
  "xdm:sourceProperty": ["customerId", "eventTimestamp"]
}

バージョン記述子（識別子）

バージョン記述子（識別子）を定義して、正しいレコードの状態を維持し、最新の更新が適用されるようにします。 複数のレコードが同じプライマリキーを共有する場合、バージョン値が最も高いレコードは最新と見なされます。

例：

{
  "xdm:descriptor": "xdm:descriptorVersion",
  "xdm:sourceProperty": "lastModified"
}

タイムスタンプ記述子（識別子）

時系列スキーマの場合は、順序のイベント時間を設定するタイムスタンプ記述子（識別子）を定義します。

例：

{
  "xdm:descriptor": "xdm:descriptorTimestamp",
  "xdm:sourceProperty": "eventTimestamp"
}

スキーマエディターで記述子を作成する方法については、​ スキーマエディターで記述子を作成を参照してください。 API ベースの作成については、APIを使用した記述子の作成を参照してください。

関係サポート relationship-support

関係データモデリングは、関係スキーマの主な用途です。 アプリケーションユースケースでは、これらのスキーマを「関係スキーマ」と呼ぶこともあります。 関係記述子は、外部キーをデータ行に埋め込まずに、スキーマ間でデータセットをリンクすることで、これらの接続を有効にします。 参照整合性を向上させ、再利用可能なモデリングパターンを実現し、アプリケーションをまたいで接続されたクエリをサポートします。

クエリ時の動的解決のために、スキーマレベルで関係記述子を作成します。 基数値（1:1、多対一）はガイダンスを提供しますが、取り込み中に制約を適用することはなく、接続されたデータセット全体で柔軟なデータモデリングをサポートします。

関係記述子を追加する前に、適切なタイプとターゲットを決定します。

例：1対1の関係

{
  "xdm:descriptor": "xdm:descriptorRelationship",
  "xdm:sourceProperty": "accountId",
  "xdm:destinationSchema": "https://ns.adobe.com/xdm/context/account",
  "xdm:destinationProperty": "accountId"
}

例：多対一の関係

{
  "xdm:descriptor": "xdm:descriptorRelationship",
  "xdm:sourceProperty": "customerId",
  "xdm:destinationSchema": "https://ns.adobe.com/xdm/context/customer",
  "xdm:destinationProperty": "customerId"
}

関係記述子のタイプと構文の一覧については、記述子API リファレンス ​を参照してください。これらの概念を実際に適用する方法については、APIでの関係の定義またはUIでの関係の作成のチュートリアルに従ってください。

データの削除と健全性への配慮 data-hygiene-support

関係スキーマは、あらゆるアプリケーションとユースケースに普遍的な影響を与える、正確なレコードレベルの削除を可能にします。 プライマリキー、バージョン、およびタイムスタンプ記述子は、削除処理中に正確なレコードを識別するための基盤を提供します。

普遍的な削除の影響

リレーショナルスキーマを使用するすべてのアプリケーションでは、次のことを考慮する必要があります。

実装ガイダンスについては、関係スキーマに基づくデータセットからのレコードの削除を参照してください。

制限と考慮事項 limitations

リレーショナルスキーマを使用する前に、次の制限事項を確認してください。