DocumentaciónCampaignDocumentación de Campaign Classic v7

Administración de claves en esquemas management-of-keys

Last update: Wed Sep 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

Cada tabla asociada con un esquema de datos debe tener al menos una clave para identificar un registro de una tabla.

Se declara una clave a partir del elemento principal del esquema de datos.

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

Una clave se conoce como 'clave principal' cuando es la primera del esquema que se va a rellenar o si contiene el atributo internal establecido como "true".

Las siguientes reglas se aplican a las claves:

  • Una clave puede hacer referencia a uno o varios campos de la tabla
  • Se declara implícitamente un índice único para cada definición de clave. La creación de un índice en la clave se puede evitar estableciendo el atributo noDbIndex en "true".
NOTE

  • Como estándar, las claves son los elementos declarados a partir del elemento principal del esquema después de definir los índices.

  • Las claves se crean durante la asignación de tablas (estándar o FDA), Adobe Campaign encuentra índices únicos.

Ejemplo:

  • Añadir una clave a la dirección de correo electrónico y a la ciudad:

    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>

    El esquema generado:

    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>

  • Adición de una clave principal o interna al campo de nombre "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>

    El esquema generado:

    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>

Clave de incremento automático auto-incremental-key

La clave principal de la mayoría de las tablas de Adobe Campaign es un entero de 32 bits generado automáticamente por el motor de la base de datos. El cálculo del valor de clave depende de una secuencia (de forma predeterminada, la función SQL XtkNewId) que genere un número único en toda la base de datos. El contenido de la clave se introduce automáticamente al insertar el registro.

La ventaja de una clave incremental es que proporciona una clave técnica no modificable para las uniones entre tablas. Además, esta clave no ocupa mucha memoria porque utiliza un entero de doble byte.

Puede especificar en el esquema de origen el nombre de la secuencia que se va a utilizar con el atributo pkSequence. Si este atributo no se proporciona en el esquema de origen, se utilizará la secuencia predeterminada XtkNewId. La aplicación usa secuencias dedicadas para los esquemas nms:broadLog y nms:trackingLog (NmsBroadLogId y NmsTrackingLogId respectivamente) porque estas son las tablas que contienen la mayor cantidad de registros.

A partir de la versión 18.10 de ACC, XtkNewId ya no es el valor predeterminado para la secuencia en los esquemas predeterminados. Ahora puede crear un esquema o ampliar el esquema existente con una secuencia dedicada.

IMPORTANT
Al crear un nuevo esquema o durante una extensión de esquema, se debe mantener el mismo valor de secuencia de clave principal (@pkSequence) para todo el conjunto.

Una secuencia a la que se hace referencia en un esquema de Adobe Campaign (NmsTrackingLogId, por ejemplo) debe asociarse con una función SQL que devuelva el número de ID en los parámetros, separados por comas. Esta función debe llamarse GetNew XXX Ids, donde XXX es el nombre de la secuencia (GetNewNmsTrackingLogIds, por ejemplo). Vea los archivos postgres-nms.sql, mssql-nms.sql o oracle-nms.sql proporcionados con la aplicación en el directorio datakit/nms/eng/sql/ para recuperar el ejemplo de creación de secuencia 'NmsTrackingLogId' para cada motor de base de datos.

Para declarar una clave única, rellene el atributo autopk (con el valor "true") en el elemento principal del esquema de datos.

Ejemplo:

Declarar una clave incremental en el esquema de origen:

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

El esquema generado:

<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>

Además de la definición de la clave y su índice, se ha añadido un campo numérico llamado "id" al esquema ampliado para contener la clave principal generada automáticamente.

IMPORTANT
Al crear la tabla, se inserta automáticamente un registro con una clave principal establecida en 0. Este registro se utiliza para evitar las uniones externas, que no son efectivas en las tablas de volumen. De forma predeterminada, todas las claves externas se inicializan con el valor 0, de modo que siempre se pueda devolver un resultado en la unión cuando el elemento de datos no se rellena.

Más información

Examine los siguientes vínculos para obtener más información:

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