[限定提供]{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 対 1 の関係

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

例：多対 1 の関係

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

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

データの削除とハイジーンに関する考慮事項 data-hygiene-support

モデルベースのスキーマを使用すると、すべてのアプリケーションやユースケースに普遍的な影響を与える正確なレコードレベルの削除が可能になります。 プライマリキー、バージョン、タイムスタンプ記述子は、削除操作中にレコードを正確に識別するための基盤となります。

ユニバーサル削除の影響

モデルベースのスキーマを使用するすべてのアプリケーションで次の点を考慮する必要があります。

実装ガイダンスについては、 モデルベースのデータセットからのレコードの削除を参照してください。

制限事項と考慮事項 limitations

モデルベースのスキーマを使用する前に、次の制限事項を確認してください。