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

DDL ファイルを使用したリレーショナルスキーマの作成 file-upload-schema

Last update: Fri Sep 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

適用対象：
Campaign Orchestration

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

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

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

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

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）として指定する必要があります。ユーザーはバージョン記述子を変更できます。これは、一度設定すると必須になります。 1 つの属性を、プライマリキー（PK）とバージョン記述子の両方にすることはできません。
属性を identity としてマークし、定義済みの ID 名前空間にマッピングします。
各テーブルの名前を変更、削除または説明を追加します。
完了したら、「完了」をクリックします。

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

関係の定義 relationships

スキーマ内のテーブル間の論理接続を定義するには、次の手順に従います。

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

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

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

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

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

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