文件CampaignCampaign Classic v7 文件

結構描述中的金鑰管理 management-of-keys

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer

每個與資料結構描述關聯的表格必須至少有一個索引鍵來識別表格中的記錄。

從資料結構描述的主要元素中宣告索引鍵。

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

當金鑰是結構描述中第一個要填入的金鑰，或金鑰包含 internal 屬性設為「true」。

下列規則適用於機碼：

  • 索引鍵可參考表格中的一或多個欄位
  • 每個索引鍵定義都會以隱含方式宣告唯一索引。 可透過設定 noDbIndex 屬性為"true"。
NOTE

  • 作為標準，索引鍵是在定義索引後，從結構描述的主要元素宣告的元素。

  • 金鑰是在表格對應期間建立（標準或FDA），Adobe Campaign會尋找唯一索引。

範例：

  • 將金鑰新增至電子郵件地址和城市：

    code language-sql 
    <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="Email address of recipient"/>
    <element name="location" label="Location">
      <attribute name="city" type="string" length="50" label="City" userEnum="city"/>
    </element>
  </element>
</srcSchema>

    產生的結構描述：

    code language-sql 
    <schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" sqltable="CusRecipient">
   <dbindex name="email" unique="true">
     <keyfield xpath="@email"/>
     <keyfield xpath="location/@city"/>
   </dbindex>

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

   <attribute desc="Email 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」名稱欄位中新增主要或內部索引鍵：

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

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

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

    產生的結構描述：

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

    <dbindex name="id" unique="true">
      <keyfield xpath="@id"/>
    </dbindex>

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

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

自動增量索引鍵 auto-incremental-key

大部分Adobe Campaign表格的主要索引鍵是由資料庫引擎自動產生的32位元長整數。 機碼值的計算取決於順序(根據預設， XtkNewId SQL函式)產生在整個資料庫中唯一的數字。 插入記錄時會自動輸入金鑰的內容。

增量索引鍵的優點在於，它提供不可修改的技術索引鍵用於表格之間的聯結。 此外，此索引鍵使用雙位元組整數，因此不會佔用太多記憶體。

您可以在來源綱要中指定要與搭配使用的序列名稱 pkSequence 屬性。 如果來源結構描述中未指定此屬性， XtkNewId 將會使用預設序列。 應用程式使用專用的序列 nms：broadLog 和 nms：trackingLog 結構描述(NmsBroadLogId 和 NmsTrackingLogId 這些是包含最多記錄的表格。

從ACC 18.10， XtkNewId 不再是現成可用結構中序列的預設值。 您現在可以使用專用序列來建置方案或擴充現有方案。

IMPORTANT
建立新結構描述或在結構描述擴充期間，您需要為整個結構描述保留相同的主要索引鍵序列值(@pkSequence)。

Adobe Campaign結構描述中參照的序列(NmsTrackingLogId 例如)必須與SQL函式相關聯，此函式會傳回引數中的ID數目（以逗號分隔）。 必須呼叫此函式 GetNew XXX Id，其中 XXX 是序列的名稱(GetNewNmsTrackingLogIds 例如)。 檢視 postgres-nms.sql， mssql-nms.sql 或 oracle-nms.sql 中隨應用程式提供的檔案 datakit/nms/eng/sql/ 目錄，以復原每個資料庫引擎的「NmsTrackingLogId」序列建立範例。

若要宣告唯一金鑰，請填入 autopk 屬性（值為「true」）。

範例：

在來源結構描述中宣告增量金鑰：

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

產生的結構描述：

<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
  <element name="recipient" autopk="true" pkSequence="XtkNewId" sqltable="CusRecipient">
    <dbindex name="id" unique="true">
      <keyfield xpath="@id"/>
    </dbindex>

    <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」的數值欄位已新增至擴充架構，以包含自動產生的主要索引鍵。

IMPORTANT
主鍵設為0的記錄會在建立表格時自動插入。 此記錄用於避免外部聯結，這些外部聯結在磁碟區表格上無效。 依預設，所有外部索引鍵都是以值0初始化，如此一來，當資料專案未填入時，就可以在聯結上傳回結果。

了解更多

瀏覽以下連結以瞭解更多資訊：

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1