select into map(a,b,[param &1 equals c], d,e, f,g,h,i,j], delimiter k, map l,m,n,o,p)

Der Befehl führt das SQL-Select-Statement a auf der Datenbank mit dem Alias b aus. Er ersetzt die Platzhalter der Form &Parameternummer im Statement durch die Werte ab Parameter c bis j. Zeichen, die für eine gültige Syntax des Statements erforderlich sind (zum Beispiel Hochkommas um Zeichenketten) müssen bereits im Statement enthalten sein. Eine Begrenzung der Ergebnismenge findet nicht statt. Sollten also weniger Zeilen gelesen werden, muss dies über eine entsprechende LIMIT-Anweisung im SQL geschehen.

Die Ergebnistabelle wird in eine Map mit Namen l geschrieben. Der Wert der ersten Spalte wird hierbei als Schlüssel angesehen. Die restlichen Spalten der Ergebniszeile werden durch Trennzeichen k getrennt und zu einer Zeichenkette zusammengefasst. Diese Zeichenkette wird unter dem Schlüssel als Wert in der Map abgelegt. Vor dem Schreiben leert die Funktion die Map, sofern Parameter o dies nicht unterdrückt.

Der Rückgabewert der Funktion ist die Anzahl an erhaltenen Datensätzen.

Sind in der Ergebnismenge Spalten vom Typ BLOB, legt der Parameter m fest, ob die Binärdaten Base64-kodiert in die Ergebnislisten (Einträge der Map) geschrieben werden. Ist m gleich true, kodiert die Funktion die Daten Base64. Andernfalls bleiben die Daten unverändert. Gibt es keine solchen Spalten in der Ergebnismenge, hat der Wert des Parameters keinen Effekt.

 WICHTIG:  Neben der Schreibweise &Parameternummer ist auch die Schreibweise für Prepared Statements in der Form @Parameternummer:Parametertyp@ möglich. Diese verhindert sogenannte SQL Injection Attacks und ist daher zu bevorzugen. Innerhalb von „Prepared Statements“ ersetzen Parameter ausschließlich einzelne Werte. SQL-Syntax wie Wertelisten für IN, Tabellen- oder Spaltennamen, Operatoren, Sortierungen oder komplette SQL-Fragmente kann nicht über Platzhalter übergeben werden.

Parameter

Beispiele

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

Das Ergebnis ist eine Map ZIPS, die 20000 Einträge mit der Postleitzahl als Schlüssel und der Stadt und deren Bundesland als Wert enthält, zum Beispiel {80336=München;Bayern}.

Erzeugt die zuvor genannte Map mit ausschließlich dem oben genannten Eintrag.

Erzeugt in den ersten beiden Fällen die zuvor genannte Map mit allen bayerischen Postleitzahlen.