Grundlegende Syntaxbestandteile

VALUES (1,'A') führt zu einem Syntaxfehler.

VALUES (1,2,3) führt zu falschen Ergebnissen.

VALUES (1 ,'A')

VALUES (1 ,2 ,3)

Die eine Art entspricht der Standard-SQL-Syntax: authorization-identifier und Tabellenname werden durch einen Punkt miteinander verbunden. Hierbei muss der DDM-Name dem Namen der physischen Datenbanktabelle (ohne den authorization-identifier) entsprechen.

Beispiel:

DEFINE DATA LOCAL 
01 PERS VIEW OF PERSONNEL 
   02 NAME 
   02 AGE 
END-DEFINE 
SELECT * 
  INTO VIEW PERS 
  FROM SQL.PERSONNEL 
...

Die andere Möglichkeit besteht darin, den authorization-identifier als Teil des DDM-Namens selbst zu definieren. Der DDM-Name besteht dann aus dem authorization-identifier gefolgt von einem Bindestrich (−) und gefolgt vom Namen der Datenbanktabelle. Intern wird der Bindestrich zwischen authorization-identifier und Tabellennamen in einen Punkt umgesetzt.

Beispiel:

DEFINE DATA LOCAL 
01 PERS VIEW OF SQL-PERSONNEL 
   02 NAME 
   02 AGE 
END-DEFINE 
SELECT * 
  INTO VIEW PERS 
  FROM SQL-PERSONNEL 
...

Wenn der authorization-identifier weder explizit noch als Teil des DDM-Namens angegeben wird, wird er vom SQL-Datenbanksystem bestimmt.

Die table-names können nicht nur in SELECT-Statements verwendet werden, sondern auch in den Statements DELETE, INSERT und UPDATE.

Beispiel:

... 
DELETE FROM SQL.PERSONNEL 
  WHERE AGE IS NULL 
 ... 
    
... 
INSERT INTO SQL.PERSONNEL (NAME,AGE) 
  VALUES ('ADKINSON',35) 
... 
    
... 
UPDATE SQL.PERSONNEL 
SET SALARY = SALARY * 1.1 
WHERE AGE > 30 
...

sql-type gehört zum SQL Extended Set.

Wenn ein sql-type angegeben wird, muss er mit Doppelpunkten (:) umgeben sein. Gültige SQL-Datentypen sind:

Wenn sie als empfangendes Feld (z.B. in einer INTO-Klausel) definiert wird, ist die host-variable ein Feld, dem vom Datenbanksystem einen Wert zugeordnet wird.

Wenn sie als sendendes Feld (z.B. in einer WHERE-Klausel) definiert wird, ist die host-variable ein Feld, dessen Wert vom Programm an das Datenbanksystem übergeben wird.

Siehe auch Natural-Formate und SQL-Datentypen.

Gemäß den SQL-Standards kann einer host-variable ein Doppelpunkt (:) vorangestellt werden. Bei der Verwendung mit flexibler SQL muss ihr ein Doppelpunkt vorangestellt werden.

Beispiel:

SELECT NAME INTO :#NAME FROM PERSONNEL 
WHERE AGE = :VALUE

Wenn ein Variablenname mit einem für SQL reservierten Wort identisch ist, ist der Doppelpunkt ebenfalls erforderlich. In Situationen, in denen entweder eine host-variable oder eine Spalte referenziert werden kann, wird ein Name ohne Doppelpunkt als Referenz auf eine Spalte interpretiert.

Diese Klausel ist optional und dient dazu, herauszufinden, ob eine zu lesende Spalte "Null" ist, d.h. keinen Wert enthält, oder tatsächlich den Wert Null (0) bzw. Leerzeichen enthält.

Wenn sie mit einer empfangenden host-variable (Zielfeld) verwendet wird, dient die INDICATOR host-variable (Null-Indikatorfeld) dazu, herauszufinden, ob eine zu lesende Spalte "Null" ist.

Beispiel:

DEFINE DATA LOCAL 
1 NAME      (A20) 
1 NAMEIND   (I2) 
END-DEFINE 
SELECT * 
  INTO NAME INDICATOR NAMEIND 
...

In diesem Beispiel ist NAME die empfangende host-variable und NAMEIND das Null-Indikatorfeld.

Ist ein Null-Indikatorfeld angegeben und die gelesene Spalte ist Null, wird das Indikatorfeld auf einen negativen Wert und das Zielfeld je nach Datentyp auf Null (0) bzw. Leerzeichen gesetzt. Andernfalls ist der Wert des Null-Indikatorfeldes größer als oder gleich Null (0).

Wenn sie mit einer sendenden host-variable (Quelldatenfeld) verwendet wird, dient das Null-Indikatorfeld dazu, diesem Feld einen Nullwert zuzuweisen.

Beispiel:

DEFINE DATA LOCAL 
1 NAME      (A20) 
1 NAMEIND   (I2) 
UPDATE ... 
SET NAME = :NAME INDICATOR :NAMEIND 
WHERE ...

In diesem Beispiel ist :NAME die sendende host-variable und :NAMEIND das Null-Indikatorfeld. Durch Eingabe eines negativen Wertes für das Null-Indikatorfeld wird der Datenbankspalte ein Nullwert zugeordnet.

Eine INDICATOR host-variable hat Format/Länge I2.

Diese Klausel ist optional und dient zur Unterstützung von Spalten mit variabler Länge, z.B. des Typs VARCHAR oder LONG VARCHAR.

Wenn sie mit einer empfangenden host-variable (Zielfeld) verwendet wird, enthält die LINDICATOR host-variable (Längen-Indikatorfeld) die Anzahl der tatsächlich von der Datenbank in das Zielfeld geschriebenen Zeichen. Das Zielfeld wird immer mit Leerzeichen aufgefüllt.

Enthält die VARCHAR- bzw. LONG VARCHAR-Spalte mehr Zeichen, als in das Zielfeld passen, wird im Längen-Indikatorfeld die Anzahl der tatsächlich gelesenen Zeichen ausgegeben und im Null-Indikatorfeld (falls angegeben) die tatsächliche Gesamtlänge der Spalte.

Beispiel:

DEFINE DATA LOCAL 
1 ADDRESSLIND (I2) 
1 ADDRESS     (A50/1:6) 
END-DEFINE 
SELECT * 
  INTO :ADDRESS(*) LINDICATOR :ADDRESSLIND 
  ...

In diesem Besipiel erhält :ADDRESS(*) die ersten 300 Bytes (falls vorhanden) der adressierten VARCHAR- bzw. LONG VARCHAR-Spalte, und :ADDRESSLIND ist das Längen-Indikatorfeld, das die Anzahl der tatsächlich von der Datenbank zurückgelieferten Zeichen enthält.

Wenn es mit einer sendenden host-variable (Quellendatenfeld) verwendet wird, gibt das Längen-Indikatorfeld an, wieviele Zeichen des Quellendatenfeldes an die Datenbank übergeben werden sollen.

Beispiel:

DEFINE DATA LOCAL 
1 NAMELIND  (I2) 
1 NAME      (A20) 
1 AGE       (I2) 
END-DEFINE 
MOVE  4     TO NAMELIND 
MOVE 'ABC%' TO NAME 
SELECT AGE 
  INTO :AGE 
WHERE NAME LIKE :NAME LINDICATOR :NAMELIND 
  ...

Eine LINDICATOR host-variable hat Format/Länge I2 oder I4. Um Verarbeitungszeit zu sparen, sollte sie unmittelbar vor dem betreffenden Ausgangs- bzw. Zielfeld angegeben werden; andernfalls würde sie zur Laufzeit in einen Zwischenspeicher kopiert.

Wenn das LINDICATOR-Feld als I2-Feld definiert ist, wird der SQL-Datentyp VARCHAR zum Senden/Erhalten der betreffenden Spalte verwendet. Wird die LINDICATOR host-variable als I4 angegeben, wird ein großer Objektdatentyp (CLOB/BLOB) verwendet.

Wenn das Feld als DYNAMIC (dynamisch) definiert ist, wird die Spalte in einer internen Schleife bis zu ihrer wirklichen Länge gelesen. Das LINDICATOR-Feld und *LENGTH werden auf diese Länge gesetzt. Bei Feldern fester Länge wird die Spalte bis zur definierten Länge gelesen. In beiden Fällen wird das Feld bis zum im LINDICATOR-Feld definierten Wert geschrieben.

Ein Feld fester Länge soll zum Beispiel mit einem als I2 angegebenen LINDICATOR-Feld definiert werden. Wenn die VARCHAR-Spalte mehr Zeichen enthält als in dieses Feld fester Länge passen, wird das Längenindikatorfeld auf die tatsächlich zurückgegebene Länge gesetzt, und das Nullindikatorfeld (falls angegeben) wird auf die Gesamtlänge dieser Spalte (Lesen) gesetzt. Dies ist bei Feldern fester Länge >= 32 KB nicht möglich (die Länge ist größer gewählt als die Länge des Nullindikatorfeldes).

BUSINESS_TIME muss ein Zeitraum sein, der für die im DELETE- und UPDATE-Statement referenzierte Tabelle definiert ist.

Wenn der Zeitraum, der durch den Startwert und den Endewert für die BUSINESS_TIME einer Zeile angegeben ist, vollständig in dem angegebenen Zeitraum enthalten ist (wenn der Startwert für den Zeitraum in der Zeile kleiner ist als expr2 und der Endewert für den Zeitraum in der Zeile größer ist als expr1), wird diese Zeile aktualisiert bzw. gelöscht, und die Start- und Endewerte für diesen BUSINESS_TIME-Zeitraum bleiben unverändert.

Das Ergebnis eines jeden Ausdrucks muss mit dem Datentyp der Spalten des angegebenen Zeitraums vergleichbar sein. Ein Zeitstempel mit TIME ZONE ist als der Ergebnisdatentyp für expr1 oder expr2 nicht zulässig.