Element `<database>`¶

Zweck: Deklariert einen benannten relationalen Datenbank-Client für Lese-, Schreib- und SQL-Operationen.

Warum: Verwende dieses Element, damit relationale Reads, Writes, Selektoren und SQL-Ausführungen dieselbe Client-ID nutzen.

Beispiel¶

<database id="customer-db"/>

Entscheidungshilfe¶

Fachlicher Nutzen: Bündelt relationale Konnektivität für Selektoren, SQL-Setup, Inserts und Datenbankoperationen.

Verwenden, wenn
- Wenn ein Descriptor aus einer relationalen Datenbank liest oder in sie schreibt.
Anderen Ansatz wählen, wenn
- Wenn die Quelle eine MongoDB-Collection, Datei, ein Object Store oder Message Broker ist.
Voraussetzungen
- Wähle das DBMS und liefere die erforderlichen Verbindungswerte über die Projektkonfiguration.
Alternativen
- Verwende mongodb für dokumentorientierte Collection-Daten. (Siehe: <mongodb>)

Vollständige Beispiele¶

Eine deterministische relationale Quelle vorbereiten und lesen

Verwende einen benannten Datenbank-Client, wenn SQL-Vorbereitung, Quellselektion und spätere Ziele denselben Verbindungsvertrag nutzen müssen.

sqlite-assembly/datamimic.xml
<setup numProcess="1">
    <database id="source_db" dbms="sqlite" database="docs.sqlite"/>
    <execute script="'DROP TABLE IF EXISTS customers'" type="sql" target="source_db"/>
    <execute script="'CREATE TABLE customers (id INTEGER, name TEXT)'" type="sql" target="source_db"/>
    <execute script='"INSERT INTO customers VALUES (1, char(65,100,97)), (2, char(71,114,97,99,101))"'
             type="sql"
             target="source_db"/>
    <generate name="selected_customers"
              source="source_db"
              selector="SELECT id, name FROM customers ORDER BY id"
              distribution="ordered"
              target="LogExporter"/>
</setup>

Regeln und ungültige Kombinationen¶

Ein relationaler Client erfordert einen Datenbank-Locator.

Attribute: dbms, database

Warum: DBMS und Netzwerkendpunkt identifizieren noch nicht die zu öffnende Datenbank, den Service oder Katalog.

Gültige Kombination
<database id="customerDb"/>

Ungültige Kombination
<database id="customerDb" dbms="postgresql"/>

Erlaubte Elternelemente / Erlaubte Kindelemente¶

Erlaubte Elternelemente: else, else-if, if, setup, while

Erlaubte Kindelemente:

Keine

Erweiterungsattribute: Die deklarierten Attribute sind vollständig. Dieses Element akzeptiert zusätzlich laufzeitdefinierte Herstellererweiterungen, für die es bewusst keine statische Completion gibt.

Datenbankgestützte Sequenzen erzeugen — Explains bounded database sequence reservation and its single-process policy.
Source und Target wählen — Guides users and agents from an input ownership boundary and intended side effect to one bounded source and target contract.