Statement: Direktes SQL

Input

HTML/XML

<Beliebiger Elementname>
   <statement resulttag="Ergebniselementname" timezone="Zeitzone"
    format="Datumsformat">
      <sql>  
         SQL-Anweisungen
      </sql>
   </statement> 
</Beliebiger Elementname>

Für jedes Element <statement/> gilt:

Das optionale Attribut timezone gibt eine Zeitzone gemäß java.util.TimeZone, siehe http://docs.oracle.com/javase/1.5.0/docs/api/java/util/TimeZone.html, an, z. B. GMT+2 .
Das optionale Attribut format gibt ein Datumsformat gemäß java.text.SimpleDateFormat an.
Es enthält mindestens ein Element <sql/>, das jeweils eine SQL-Anweisung enthält.

Falls Sie innerhalb der SQL-Anweisung oder für die Werte bzw. Daten der Tabellenspalten Zeichen verwenden, die in XML eine Bedeutung besitzen, maskieren Sie die SQL-Anweisung mit einem umgebenden CDATA -Block, z. B. <![CDATA[ SELECT * FROM TABLE WHERE ID<1 ]]> oder <rowset><row><Name><!CDATA[ XML Zeichen “<“ in CDATA Element]]></Name></row></rowset>.

So wird sichergestellt, dass die Zeichen im CDATA-Element nicht als XML interpretiert werden, sondern als Daten für den Adapter.

Beispiel

HTML/XML

<select>
   <statement resulttag="result" timezone="UTC" format="dd.MM.yyyy">
      <sql>  
         <![CDATA[SELECT * FROM JMS_USERS]]>
      </sql>
   </statement> 
</select>

Output

Wurde die SQL-Anweisung erfolgreich ausgeführt, gibt der Datenbankverbindungs-Baustein ein XML-Dokument mit folgender Struktur zurück, das die Antwort der Datenbank als Zeichenkette (String) enthält:

HTML/XML

<Data>
   <Ergebniselementname>
      <Feld1><!--Wert--></Feld1>
      <Feldn><!--Wert--></Feldn>
   </Ergebniselementname>
</Data>

Bei SELECT-Statements zum Zugriff auf Datenbanktabellen mit Spaltennamen, die keine gültigen XML-Namen darstellen, werden im Ergebnis-XML-Dokument synthetische Elementnamen erzeugt, um die Wohlgeformheit des XML-Dokuments sicherzustellen.