データベースマッピング database-mapping
このページ 🔗のに記載されているサンプルスキーマのSQL マッピングは、次のXML ドキュメントを生成します。
<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
<enumeration basetype="byte" name="gender">
<value label="Not specified" name="unknown" value="0"/>
<value label="Male" name="male" value="1"/>
<value label="Female" name="female" value="2"/>
</enumeration>
<element name="recipient" sqltable="CusRecipient">
<attribute desc="Recipient email address" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
<attribute default="GetDate()" label="Date of creation" name="created" sqlname="tsCreated" type="datetime"/>
<attribute enum="gender" label="Gender" name="gender" sqlname="iGender" type="byte"/>
<element label="Location" name="location">
<attribute label="City" length="50" name="city" sqlname="sCity" type="string" userEnum="city"/>
</element>
</element>
</schema>
スキーマのルート要素が <srcschema> から <schema> に変更されました。
この別のタイプのドキュメントは、ソーススキーマから自動的に生成され、単にスキーマと呼ばれます。
SQL 名は、要素名と型に基づいて自動的に決定されます。
SQL の命名規則は次のとおりです。
-
テーブル: スキーマ名前空間と名前の連結
この例では、テーブルの名前は、スキーマのメイン要素を使用して sqltable 属性に入力されます。
code language-sql <element name="recipient" sqltable="CusRecipient"> -
field：整数の「i」、倍数の「d」、文字列の「s」、日付の「ts」などのタイプに従って定義された接頭辞の前にエレメントの名前が付きます。
フィールド名は、型指定された
<attribute>および<element>ごとに sqlname 属性を使用し入力されます。code language-sql <attribute desc="Email address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
拡張スキーマから生成されるテーブルを作成する SQL スクリプトは、次のとおりです。
CREATE TABLE CusRecipient(
iGender NUMERIC(3) NOT NULL Default 0,
sCity VARCHAR(50),
sEmail VARCHAR(80),
tsCreated TIMESTAMP Default NULL);
SQL フィールドの制約は次のとおりです。
- 数値フィールドと日付フィールドに null 値はありません
- 数値フィールドは 0 に初期化されます
XML フィールド xml-fields
デフォルトでは、<attribute>と <element> で入力された要素はすべて、データスキーマテーブルのSQL フィールドにマッピングされます。 ただし、このフィールドを SQL ではなく XML で参照することができます。つまり、データは、すべての XML フィールドの値を含んだテーブルのメモフィールド（「mData」）に格納されます。 これらのデータのストレージは、スキーマ構造に準拠する XML ドキュメントです。
XML のフィールドにデータを入力するには、値「true」の xml 属性を、該当する要素に追加する必要があります。
例：XML フィールドの使用例を 2 つ示します。
-
複数行コメントフィールド：
code language-sql <element name="comment" xml="true" type="memo" label="Comment"/> -
HTML 形式でのデータの説明：
code language-sql <element name="description" xml="true" type="html" label="Description"/>「html」タイプを使用すると、HTML コンテンツを CDATA タグに格納し、Adobe Campaign クライアントインターフェイスに特別な HTML 編集チェックを表示できます。
XML フィールドを使用して、データベースの物理構造を変更せずに新しいフィールドを追加します。 もう 1 つの利点は、使用するリソースが少ないことです（SQL フィールドに割り当てるサイズ、テーブルあたりのフィールド数の制限など）。 ただし、XML フィールドにインデックスを付けたり、フィルタリングしたりすることはできません。
索引付きフィールド indexed-fields
インデックスを使用すると、アプリケーションで使用されるSQL クエリのパフォーマンスを最適化できます。
インデックスは、データスキーマのメイン要素から宣言されます。
<dbindex name="name_of_index" unique="true/false">
<keyfield xpath="xpath_of_field1"/>
<keyfield xpath="xpath_of_field2"/>
...
</key>
インデックスは次のルールに従います。
- インデックスは、テーブル内の1つ以上のフィールドを参照できます
- unique属性に「true」の値が含まれている場合、すべてのフィールドでインデックスを一意にできます（重複を避けるために）
- インデックスのSQL名は、テーブルのSQL名とインデックスの名前から決まります
-
標準として、インデックスは、スキーマのメイン要素から宣言された最初の要素です。
-
インデックスは、テーブルマッピング（標準またはFDA）中に自動的に作成されます。
例：
-
メールアドレスと市区町村にインデックスを追加する：
code language-sql <srcSchema name="recipient" namespace="cus"> <element name="recipient"> <dbindex name="email"> <keyfield xpath="@email"/> <keyfield xpath="location/@city"/> </dbindex> <attribute name="email" type="string" length="80" label="Email" desc="Email address of recipient"/> <element name="location" label="Location"> <attribute name="city" type="string" length="50" label="City" userEnum="city"/> </element> </element> </srcSchema> -
「id」名フィールドに一意のインデックスを追加する：
code language-sql <srcSchema name="recipient" namespace="cus"> <element name="recipient"> <dbindex name="id" unique="true"> <keyfield xpath="@id"/> </dbindex> <dbindex name="email"> <keyfield xpath="@email"/> </dbindex> <attribute name="id" type="long" label="Identifier"/> <attribute name="email" type="string" length="80" label="Email" desc="Email address of recipient"/> </element> </srcSchema>