select into list()

Führt einen SQL-Select-Befehl a auf der Datenbank aus, die durch den Alias b repräsentiert wird. Im Statement hinterlegte Platzhalter der Form &Parameternummer werden durch die Werte ab Parameter c bis j ersetzt. Zeichen, die für eine gültige Syntax des Statements erforderlich sind (zum Beispiel Hochkommas um Zeichenketten) müssen bereits im Statement enthalten sein. Sie können die Menge an zurückgegebenen Ergebniszeilen über l einschränken. Der Wert 0 führt zu einer unlimitierten Ergebnismenge.

Die Funktion erzeugt für jede Spalte der Ergebnismenge eine Liste. Der Listenname folgt dem Muster k:SPALTENNAME, komplett in Großbuchstaben (siehe Beispiele). Existiert bereits eine Liste mit diesem Namen, löscht die Funktion deren Werte.

Die Funktion gibt die Anzahl der erhaltenen Datensätze zurück.

Enthält die Ergebnismenge Spalten vom Typ BLOB, steuert Parameter m die Kodierung. Setzen Sie m auf true, um die Binärdaten Base64-kodiert in die Ergebnislisten zu schreiben. Andernfalls bleiben die Daten unverändert. Gibt es keine solchen Spalten in der Ergebnismenge, hat der Wert des Parameters keinen Effekt.

HINWEIS: Neben der Schreibweise &Parameternummer gibt es auch die Schreibweise für Prepared Statements in der Form @Parameternummer:Parametertyp@. Bevorzugen Sie Prepared Statements, denn sie verhindern SQL Injection Attacks. Innerhalb von Prepared Statements ersetzen Parameter ausschließlich einzelne Werte. Sie können damit keine Wertelisten für IN, Tabellen- oder Spaltennamen, Operatoren, Sortierungen oder komplette SQL-Fragmente übergeben.

Parameter

Parameter	Beschreibung
a	Auszuführendes SQL-Statement.
b	Datenbank-Alias.
c	(optional) Parameter `&1` im Statement.
d	(optional) Parameter `&2` im Statement.
e	(optional) Parameter `&3` im Statement.
f	(optional) Parameter `&4` im Statement.
g	(optional) Parameter `&5` im Statement.
h	(optional) Parameter `&6` im Statement.
i	(optional) Parameter `&7` im Statement.
j	(optional) Parameter `&8` im Statement.
k	Präfix der zu erzeugenden Ergebnislisten.
l	(optional) Maximale Anzahl zu lesender Zeilen. Default: `0`.
m	(optional) `true`, wenn Daten aus einer Spalte vom Typ BLOB Base64-kodiert in die Ergebnislisten aufgenommen werden sollen. Default: `false`.
n	(optional) `true` für Nur-Lesen-Modus. Default: `false`.
o	(optional) `true`, wenn für die Erweiterung der Listennamen der Displayname und nicht der Spaltenname verwendet werden soll (siehe Beispiele). Default: `false`.
p	(optional) Falls `true`, ignoriert die Funktion von der Datenbank gemeldete SQL-Fehler. Default: <leer> (== `false`).

Beispiele

Gegeben sei eine Tabelle zipcodes, die die Postleitzahlen von Deutschland enthält (insgesamt imaginäre 20000 Einträge).

Parameter a	b	c	d-j	k	l	m	n	o	p	Ergebnis
`select zipcode as zip, city as town from zipcodes`	testdb			ZIPS	0					20000
`select zipcode as zip, city as town from zipcodes`	testdb			ZIPS	0			true		20000

Im Anschluss der Ausführung von Beispiel 1 wurde die Liste ZIPS:ZIPCODE mit den Werten aus der Spalte zipcode und die Liste ZIPS:CITY mit den Werten aus Spalte city erzeugt. Im Fall von Beispiel 2 lauten die Listennamen ZIPS:ZIP und ZIPS:TOWN.

Parameter a	b	c	d-j	k	l	m	n	o	p	Ergebnis
`select zipcode, city from zipcodes where zipcode = &1`	testdb	80689		ZIPS	0					1
`select zipcode, city from zipcodes where zipcode = @1:i@`	testdb	80689		ZIPS	0					1

Erzeugt die zuvor genannten Listen von Beispiel 1 mit jeweils einem Element 80689 oder Munich.

Parameter a	b	c	k	Ergebnis
`select zipcode, city from zipcodes where county = '&1'`	testdb	Bayern	ZIPS	1500
`select zipcode, city from zipcodes where county = @1:s@`	testdb	Bayern	ZIPS	1500
`select zipcode, city from zipcodes where county = &1`	testdb	Bayern	ZIPS	Fehler, da Textliterale in Hochkommas stehen müssen.

Erzeugt in den ersten beiden Fällen die zuvor genannten Listen mit den Postleitzahlen von Bayern.

Documentation Index

select into list()

Parameter

Beispiele