Datenbank-Mapping

Letzte Aktualisierung: 30. Dezember 2024

Erstellt für:

  • Entwickler

Die SQL-Zuordnung des auf Seite beschriebenen Beispielschemasdas folgende XML-Dokument:

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

Das Stammelement des Schemas wurde in <srcschema> in <schema> geändert.

Dieser andere Dokumenttyp wird automatisch aus dem Quellschema generiert und einfach als Schema bezeichnet.

Die SQL-Namen werden automatisch anhand des Elementnamens und des Elementtyps bestimmt.

Die SQL-Benennungsregeln lauten wie folgt:

  • table: Verkettung des Namespace und Namens des Schemas

    In diesem Beispiel wird der Tabellenname über das Hauptelement des Schemas im Attribut sqltable eingegeben:

    <element name="recipient" sqltable="CusRecipient">

  • field: Name des Elements mit vorangestelltem Präfix, das nach Typ definiert wird: „i“ für Integer, „d“ für Double, „s“ für String, „ts“ für Datumsangaben usw.

    Der Feldname wird über das Attribut sqlname für die verschiedenen Eingaben von <attribute> und <element> eingegeben:

    <attribute desc="Email address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
NOTE
SQL-Namen können aus dem Quellschema geladen werden. Füllen Sie dazu die Attribute "sqltable" oder "sqlname" für das betreffende Element aus.

Das SQL-Script zur Erstellung der aus dem erweiterten Schema generierten Tabelle lautet wie folgt:

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

In Bezug auf SQL-Felder gelten folgende Einschränkungen:

  • Keine Nullwerte in numerischen und Datumsfeldern
  • Numerische Felder werden mit 0 initialisiert

XML-Felder

Standardmäßig werden alle <attribute> und <element> Elemente einem SQL-Feld der Datenschematabelle zugeordnet. Sie können dieses Feld jedoch anstatt in SQL auch in XML referenzieren. Das bedeutet, dass die Daten in einem Memo-Feld ("mData") der Tabelle gespeichert werden, in der Werte aller XML-Felder enthalten sind. Als Speicher dieser Daten fungiert ein XML-Dokument, das die Struktur des Schemas beibehält.

Um ein Feld in XML auszufüllen, müssen Sie dem betreffenden Element das Attribut xml mit dem Wert "true" hinzufügen.

Beispiel: Im Folgenden finden Sie zwei Beispiele für die Verwendung von XML-Feldern.

  • Mehrzeiliges Kommentarfeld:

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

  • Beschreibung der Daten im HTML-Format:

    <element name="description" xml="true" type="html" label="Description"/>

    Über den Typ "html" können Sie HTML-Inhalte in einem CDATA-Tag speichern und eine spezielle HTML-Bearbeitungsprüfung in der Benutzeroberfläche des Adobe Campaign-Clients anzeigen.

Verwenden Sie XML-Felder, um neue Felder hinzuzufügen, ohne die physische Struktur der Datenbank zu ändern. Ein weiterer Vorteil besteht darin, dass weniger Ressourcen benötigt werden (SQL-Feldern zugewiesene Größe, Anzahl der Felder pro Tabelle usw.). Beachten Sie jedoch, dass Sie ein XML-Feld nicht indizieren oder filtern können.