ドキュメント Journey Optimizer Journey Optimizer ガイド

DDL ファイルを使用したモデルベースのスキーマの作成 file-upload-schema

Last update: Wed Oct 08 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

適用対象：
Campaign Orchestration

ロイヤルティメンバーシップ、ロイヤルティトランザクション、ロイヤルティ報酬 などのスキーマを作成して、オーケストレーションキャンペーンに必要なモデルベースのデータモデルを定義します。各スキーマには、プライマリキー、バージョン管理属性、受信者 や ブランド などのエンティティを参照する適切な関係を含める必要があります。

スキーマは、インターフェイスを通じて手動で作成することや、DDL ファイルを使用して一括で読み込むことができます。

この節では、DDL（データ定義言語）ファイルをアップロードして Adobe Experience Platform 内でモデルベースのスキーマを作成する方法について、手順を追って説明します。DDL ファイルを使用すると、テーブル、属性、キー、関係など、データモデルの構造を事前に定義できます。

DDL ファイルをアップロードしてモデルベースのスキーマを作成し、その構造を定義します。
データモデルのテーブル間の関係を定義します。
スキーマをリンクして、モデルベースのデータを受信者やブランドなどの既存のプロファイルエンティティに接続します。
サポートされているソースからデータセットにデータを取得します。

➡️ モデルベースのスキーマについて詳しくは、Adobe Experience Platform ドキュメントを参照してください

DDL ファイルのアップロード ddl-upload

DDL ファイルをアップロードすると、テーブル、属性、キー、関係など、データモデルの構造を事前に定義できます。

Excel ベースのスキーマファイルのアップロードがサポートされています。提供されているテンプレートをダウンロードして、スキーマ定義を簡単に準備します。

Adobe Experience Platform でモデルベースのスキーマを作成する場合、次の機能がサポートされます。

ENUM
ENUM フィールドは、DDL ベースと手動スキーマ作成の両方でサポートされているので、許可される値の固定セットを使用して属性を定義できます。
次に例を示します。

code language-none

code language-none
`CREATE TABLE orders ( order_id INT NOT NULL, product_id INT NOT NULL, order_date DATE NOT NULL, customer_id INT NOT NULL, quantity INT NOT NULL, order_status enum ('PENDING', 'SHIPPED', 'DELIVERED', 'CANCELLED'), PRIMARY KEY (order_id, product_id) );`

CREATE TABLE orders (
order_id     INT NOT NULL,
product_id   INT NOT NULL,
order_date   DATE NOT NULL,
customer_id  INT NOT NULL,
quantity     INT NOT NULL,
order_status enum ('PENDING', 'SHIPPED', 'DELIVERED', 'CANCELLED'),
PRIMARY KEY (order_id, product_id)
);

データガバナンスのスキーマラベル
アクセス制御や使用制限などのデータガバナンスポリシーの適用に、スキーマフィールドレベルでラベル付けがサポートされています。詳しくは、Adobe Experience Platform ドキュメントを参照してください。

Adobe Experience Platform にログインします。
データ管理／スキーマ メニューに移動します。
「スキーマを作成」をクリックします。
スキーマタイプ として「モデルベース」を選択します。

「DDL ファイルをアップロード」を選択し、エンティティ関係ダイアグラムを定義して、スキーマを作成します。

テーブル構造には、次の項目を含める必要があります。

1 つ以上のプライマリキー
バージョン識別子（datetime タイプまたは number タイプの「lastmodified」フィールドなど）。
変更データキャプチャ（CDC）取り込みの場合、タイプ String の _change_request_type という特別な列。これは、データ変更のタイプ（挿入、更新、削除など）を示し、増分処理を可能にします。
DDL ファイルで定義できるテーブルは 200 までです。

note important
IMPORTANT
ターゲティングに使用するスキーマには、関連付けられた ID 名前空間を持つタイプ `String` の ID フィールドを 1 つ以上含める必要があります。これにより、Adobe Journey Optimizer のターゲティングおよび ID 解決機能との互換性が確保されます。

DDL ファイルをドラッグ＆ドロップし、「次へ」をクリックします。

DDL ファイルの最大サポートサイズは 10 MB です。
スキーマ名 を入力します。
各スキーマとその列を設定し、プライマリキーとバージョン記述子を指定します。

データセットが最新のデータで更新されるようにするには、lastmodified などの 1 つの属性をバージョン記述子（タイプ datetime、long または int）として指定する必要があります。ユーザーはバージョン記述子を変更できます。これは、一度設定すると必須になります。属性をプライマリキー（PK）とバージョン記述子の両方に指定できません。
属性を identity としてマークし、定義済みの ID 名前空間にマッピングします。
各テーブルに対して名前変更、削除または説明の追加を行います。
完了したら、「完了」をクリックします。

これで、キャンバス内でテーブルとフィールドの定義を確認できるようになりました。詳しくは、以下の節を参照してください。

関係の定義 relationships

関係は、スキーマの作成時に DDL ファイル内で直接指定できます。ファイル以外で関係を定義する場合は、次の手順に従って、インターフェイスで定義できます。

データモデルのキャンバス表示にアクセスし、リンクする 2 つのテーブルを選択します

ソース結合の横にある「」ボタンをクリックし、矢印をドラッグしてターゲット結合の方向に誘導し、接続を確立します。

note note
NOTE
複合キーは、DDL ファイルで定義されている場合にサポートされます。

指定されたフォームに入力してリンクを定義し、設定が完了したら「適用」をクリックします。

基数：
- 一対多：ソーステーブルの 1 つのオカレンスは、ターゲットテーブルの複数のオカレンスに対応させることができますが、ターゲットテーブルの 1 つのオカレンスは、ソーステーブルの最大 1 つのオカレンスにのみ対応させることができます。
- 多対一：ターゲットテーブルの 1 つのオカレンスは、ソーステーブルの複数のオカレンスに対応させることができますが、ソーステーブルの 1 つのオカレンスは、ターゲットテーブルの最大 1 つのオカレンスにのみ対応させることができます。
- 一対一：ソーステーブルの 1 つのオカレンスは、最大でターゲットテーブルの 1 つのオカレンスに対応させることができます。
データモデルで定義されたすべてのリンクは、キャンバス表示では矢印として表されます。必要に応じて、詳細を表示したり、編集したり、リンクを削除したりするには、2 つのテーブル間の矢印をクリックします。
ツールバーを使用して、キャンバスをカスタマイズおよび調整します。
- ズームイン：データモデルの詳細がより明確に表示するには、キャンバスを拡大します。
- ズームアウト：データモデルをより広く表示するには、キャンバスサイズを縮小します。
- 表示に合わせる：すべてのスキーマを表示領域内に合わせるには、ズームを調整します。
- フィルター：キャンバス内に表示するスキーマを選択します。
- 自動レイアウトを適用：スキーマを自動的に整理して、より適切に整理します。
- マップを表示：ミニマップオーバーレイを切り替えると、大規模スキーマレイアウトや複雑なスキーマレイアウトをより簡単に移動できます。
- すべて展開/すべて折りたたむ：すべてのスキーマノードをすばやく展開または折りたたんで、属性を表示または非表示にします。
- ダウンロード:ER 図を.png ファイルとしてダウンロードします。
完了したら、「保存」をクリックします。このアクションにより、スキーマと関連するデータセットが作成され、データセットを調整されたキャンペーンで使用できます。
「ジョブを開く」をクリックして、作成ジョブの進行状況を監視します。このプロセスは、DDL ファイルで定義されているテーブルの数に応じて、数分かかる場合があります。

また、DDL ファイルをアップロード ウィンドウを開き、「すべての DDL 読み込みジョブを表示」を選択して、DDL 読み込みジョブにアクセスすることもできます。