数据库映射

我们示例架构的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 e-mail 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>.

这会将我们转到另一类文档，该文档是从源架构自动生成的，简称为架构。此架构将由Adobe Campaign应用程序使用。

SQL名称根据元素名称和类型自动确定。

SQL命名规则如下：

表：架构命名空间和名称的拼接

在本例中，表的名称是通过 sqltable 属性：
```
<element name="recipient" sqltable="CusRecipient">
```
字段：元素的名称，前面是根据类型定义的前缀（“i”表示整数，“d”表示双精度类型，“s”表示字符串，“ts”表示日期等）

字段名称通过 sqlname 每个键入的属性 <attribute> 和 <element>:
```
<attribute desc="E-mail address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
```

注意

SQL名称可以从源架构中重载。要实现此目的，请在相关元素中填充“sqltable”或“sqlname”属性。

用于创建从扩展模式生成的表的SQL脚本如下所示：

CREATE TABLE CusRecipient(
  iGender NUMERIC(3) NOT NULL Default 0,
  sCity VARCHAR(50),
  sEmail VARCHAR(80),
  tsCreated TIMESTAMP Default NULL);

SQL字段约束如下：

数字和日期字段中没有空值，
数字字段已初始化为0。

XML字段

默认情况下，任何键入的 <attribute> 和 <element> 元素被映射到数据模式表的SQL字段。但是，您可以在XML中引用此字段，而不是SQL ，这意味着数据存储在包含所有XML字段值的表的Memo字段("mData")中。这些数据的存储是一个XML文档，用于观察架构结构。

要以XML填充字段，必须将 xml 属性，其值为“true”。

示例:以下是两个XML字段使用示例。

多行注释字段：

<element name="comment" xml="true" type="memo" label="Comment"/>

以HTML格式描述数据：
```
<element name="description" xml="true" type="html" label="Description"/>
```
“html”类型允许您将HTML内容存储在CDATA标记中，并在Adobe Campaign客户端界面中显示特殊的HTML编辑检查。

使用XML字段，您无需修改数据库的物理结构即可添加字段。另一个优势是使用的资源较少（分配给SQL字段的大小、对每个表的字段数的限制等）。

密钥管理

表必须至少具有一个用于标识表中记录的键。

从数据架构的主元素中声明一个键。

<key name="name_of_key">
  <keyfield xpath="xpath_of_field1"/>
  <keyfield xpath="xpath_of_field2"/>
  ...
</key>

密钥遵循以下规则：

键可以引用表中的一个或多个字段。
当键是要填充的架构中的第一个键，或者包含的是内部属性。

示例:

向电子邮件地址和城市添加键：

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <key name="email">
      <keyfield xpath="@email"/>
      <keyfield xpath="location/@city"/>
    </key>

    <attribute name="email" type="string" length="80" label="Email" desc="E-mail address of recipient"/>
    <element name="location" label="Location">
      <attribute name="city" type="string" length="50" label="City" userEnum="city"/>
    </element>
  </element>
</srcSchema>

生成的架构：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" sqltable="CusRecipient">
   <key name="email">
    <keyfield xpath="@email"/>
    <keyfield xpath="location/@city"/>
   </key>

   <attribute desc="E-mail address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
   <element label="Location" name="location">
     <attribute label="City" length="50" name="city" sqlname="sCity" type="string" userEnum="city"/>
   </element>
  </element>
</schema>

在“id”名称字段中添加主键或内部键：

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <key name="id" internal="true">
      <keyfield xpath="@id"/>
    </key>

    <key name="email">
      <keyfield xpath="@email"/>
    </key>

    <attribute name="id" type="long" label="Identifier"/>
    <attribute name="email" type="string" length="80" label="Email" desc="E-mail address of recipient"/>
  </element>
</srcSchema>

生成的架构：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" sqltable="CusRecipient">
    <key name="email">
      <keyfield xpath="@email"/>
    </key>

    <key internal="true" name="id">
     <keyfield xpath="@id"/>
    </key>

    <attribute label="Identifier" name="id" sqlname="iRecipientId" type="long"/>
    <attribute desc="E-mail address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
  </element>
</schema>

主键 — 标识符

在企业(FFDA)部署，则Adobe Campaign表的主键是 通用唯一ID(UUID) 由数据库引擎自动生成。键值在整个数据库中是唯一的。在插入记录时，将自动生成键的内容。

示例

在源模式中声明增量键：

<srcSchema name="recipient" namespace="cus">
  <element name="recipient"  autopk="true" autouuid="true">
  ...
  </element>
</srcSchema>

生成的架构：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient"  autopk="true" autouuid="true" sqltable="CusRecipient">

    <key internal="true" name="id">
      <keyfield xpath="@id"/>
    </key>

    <attribute desc="Internal primary key" label="Primary key" name="id" sqlname="iRecipientId" type="long"/>
  </element>
</schema>

除了键的定义之外，还在扩展架构中添加了名为“id”的数字字段，以包含自动生成的主键。

注意

在创建表时，主键设置为0的记录会自动插入。此记录用于避免外连接，该连接对卷表无效。默认情况下，所有外键都将初始化为值0，以便在未填充数据项时始终在连接时返回结果。

链接：表之间的关系

链接描述一个表与另一个表之间的关联。

各种类型的关联（称为“基数”）如下所示：

基数1-1:源表格的一个存在最多可以具有目标表格的一个对应存在。
基数1-N:源表格的一个存在可以具有目标表格的多个对应存在，但目标表格的一个存在最多可以具有源表格的一个对应存在。
基数N-N:源表格的一个存在可以具有目标表格的多个对应存在，反之亦然。

在界面中，您可以通过其图标轻松区分不同类型的关系。

要与促销活动表/数据库建立连接关系，请执行以下操作：

:基数1-1。例如，在收件人和当前订单之间。收件人一次只能与当前订单表的一个实例相关。
:基数1-1，外部连接。例如，在收件人与其国家/地区之间。收件人只能与表国家/地区的一个事件相关。将不会保存国家/地区表的内容。
:基数1-N。例如，在收件人和订阅表之间。收件人可以与订阅表上的多个事件相关。

对于使用联合数据库访问的连接关系：

:基数1-1
:基数1-N

有关FDA表的更多信息，请参阅联合数据访问.

必须在包含通过主元素链接的表的外键的架构中声明链接：

<element name="name_of_link" type="link" target="key_of_destination_schema">
  <join xpath-dst="xpath_of_field1_destination_table" xpath-src="xpath_of_field1_source_table"/>
  <join xpath-dst="xpath_of_field2_destination_table" xpath-src="xpath_of_field2_source_table"/>
  ...
</element>

链接遵循以下规则：

链接的定义是在链接-type <element> 具有以下属性：
- name:源表中链接的名称，
- 目标:目标架构的名称，
- 标签:链接标签，
- revLink （可选）：目标模式中反向链接的名称（默认自动推导），
- 完整性 （可选）：源表格的出现与目标表格的出现的参照完整性。可能的值如下：
  - 定义:如果源实例不再被目标实例引用，则可以删除该源实例，
  - 正常:删除源实例将初始化指向目标实例的链接键（默认模式），此类型的完整性将初始化所有外键，
  - 自己:删除源事件会导致删除目标事件，
  - owncopy:与自己（如果是删除）或重复（如果是重复），
  - 中性:不执行任何操作。
- revIntegrity （可选）：目标架构上的完整性（默认情况下为可选，“正常”），
- revCardinality （可选）：使用值“single”填充基数类型1-1（默认情况下为1-N）。
- externalJoin （可选）：强制外连接
- revExternalJoin （可选）：在反向链路上强制外连接
链接将源表中的一个或多个字段引用到目标表。构成连接的字段( <join> 元素)，因为默认情况下，会使用目标架构的内部键自动推断这些元素。
链接由两个半链接组成，其中第一个链接从源架构声明，第二个链接在目标架构的扩展架构中自动创建。
如果 externalJoin 属性，其值为“true”（在PostgreSQL中受支持）。

注意

链接是在架构末尾声明的元素。

示例 1

1-N与“cus:company”架构表相关：

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    ...
    <element label="Company" name="company" revIntegrity="define" revLabel="Contact" target="cus:company" type="link"/>
  </element>
</srcSchema>

生成的架构：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" sqltable="CusRecipient">
    ...
    <element label="Company" name="company" revLink="recipient" target="cus:company" type="link">
      <join xpath-dst="@id" xpath-src="@company-id"/>
    </element>
    <attribute advanced="true" label="Foreign key of 'Company' link (field 'id')" name="company-id" sqlname="iCompanyId" type="long"/>
  </element>
</schema>

链接定义由构成连接的字段来补充，即在目标架构中使用其XPath("@id")的主键，在架构中使用其XPath("@company-id")的外键。

外键会自动添加到与目标表中关联字段使用相同特征的元素中，并遵循以下命名约定：目标架构的名称，后跟关联字段的名称（在我们的示例中为“company-id”）。

目标的扩展模式(“cus:company”):

<schema mappingType="sql" name="company" namespace="cus" xtkschema="xtk:schema">
  <element name="company" sqltable="CusCompany"  autopk="true" autouuid="true">
    <key internal="true" name="id">
      <keyfield xpath="@id"/>
    </key>
    ...
    <attribute desc="Internal primary key" label="Primary key" name="id" sqlname="iCompanyId" type="long"/>
    ...
    <element belongsTo="cus:recipient" integrity="define" label="Contact" name="recipient" revLink="company" target="nms:recipient" type="link" unbound="true">
      <join xpath-dst="@company-id" xpath-src="@id"/>
    </element>
  </element>
</schema>

添加了指向“cus:recipient”表的反向链接，其中包含以下参数：

name:自动从源模式的名称推断（可以使用源模式上链接定义中的“revLink”属性强制推断）
revLink:反向链接名称
目标:链接架构的键值（“cus:recipient”架构）
未绑定:链接将声明为1-N基数的集合元素（默认情况下）
完整性:默认情况下为“define”（可以使用源架构上的链接定义中的“revIntegrity”属性强制进行）。

请注意， autouuid="true"参数在企业(FFDA)部署仅。

示例 2

在本例中，我们将声明指向“nms:address”模式表的链接。连接是外部连接，明确填充有收件人的电子邮件地址和链接表(“nms:address”)的“@address”字段。

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    ...
    <element integrity="neutral" label="Info about email" name="emailInfo" revIntegrity="neutral" revLink="recipient" target="nms:address" type="link" externalJoin="true">
      <join xpath-dst="@address" xpath-src="@email"/>
    </element>
  </element>
</srcSchema>

示例 3

与“cus:extension”架构表的1-1关系：

<element integrity="own" label="Extension" name="extension" revCardinality="single" revLink="recipient" target="cus:extension" type="link"/>

示例 4

链接到文件夹（“xtk:folder”架构）：

<element default="DefaultFolder('nmsFolder')" label="Folder" name="folder" revDesc="Recipients in the folder" revIntegrity="own" revLabel="Recipients" target="xtk:folder" type="link"/>

默认值会返回在“DefaultFolder('nmsFolder')”函数中输入的第一个符合条件的参数类型文件的标识符。

示例 5

在本例中，我们希望在链接（“company”到“cus:company”架构）上使用 xlink 属性和(“email”)表的字段：

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <key name="companyEmail">
      <keyfield xpath="@email"/>
      <keyfield xlink="company"/>
    </key>

    <attribute name="email" type="string" length="80" label="Email" desc="Recipient email"/>
    <element label="Company" name="company" revIntegrity="define" revLabel="Contact" target="cus:company" type="link"/>
  </element>
</srcSchema>

生成的架构：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" sqltable="CusRecipient">
    <key name="companyEmail">
      <keyfield xpath="@email"/>
      <keyfield xpath="@company-id"/>
    </key>

    <attribute desc="E-mail address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
    <element label="Company" name="company" revLink="recipient" target="sfa:company" type="link">
      <join xpath-dst="@id" xpath-src="@company-id"/>
    </element>
    <attribute advanced="true" label="Foreign key of link 'Company' (field 'id')" name="company-id" sqlname="iCompanyId" type="long"/>
  </element>
</schema>

“companyEmail”名称键的定义已扩展为“company”链接的外键。

数据库映射

说明

XML字段

密钥管理

主键 — 标识符

链接：表之间的关系

示例 1

示例 2

示例 3

示例 4

示例 5

Business.Adobe.com 资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe