Nimmt eine Zeichenfolge von durch einen Begrenzer getrennten Werten und gibt eine Reihe von Zeilen zurück, wobei eine Zeile für jeden Wert steht

Syntax

sa_split_list( 
Zeichenfolge
 [, Begrenzer ]
 [, max_Länge ]
)

Argumente

Ergebnismenge

Bemerkungen

Die Prozedur sa_split_list akzeptiert eine Zeichenfolge mit einer begrenzten Liste von Werten und gibt eine Ergebnismenge mit einem Wert pro Zeile zurück. Dies ist das Gegenteil der Aktion, die durch die LIST-Funktion [Aggregate] ausgelöst wird. Eine leere Zeichenfolge wird für row_value zurückgegeben, wenn für die Zeichenfolge Folgendes gilt:

• Sie beginnt mit Begrenzer.
• Sie enthält zwei aufeinanderfolgende Instanzen von Begrenzer in der Mitte der Zeichenfolge.
• Sie endet mit Begrenzer.

Ein Leerzeichen in der Eingabe-Zeichenfolge ist signifikant. Wenn der Begrenzer ein Leerzeichen ist und in der Eingabe-Zeichenfolge zusätzliche Leerzeichen stehen, werden in der Ergebnismenge zusätzliche Zeilen eingefügt. Wenn der Begrenzer kein Leerzeichen ist, werden Leerzeichen in der Eingabe-Zeichenfolge aus den Werten in der Ergebnismenge nicht entfernt.

Berechtigungen

Keine

Nebenwirkungen

Keine

Siehe auch

• LIST-Funktion [Aggregat]

Beispiele

Die folgende Abfrage gibt eine Liste von Produkten mit schwarzer Farbe zurück.

SELECT list( Name )
  FROM Products 
  WHERE Color = 'Black';

Im folgenden Beispiel wird die Prozedur sa_split_list benutzt, um die ursprüngliche Ergebnismenge aus der zusammengestellten Liste zu entfernen.

SELECT * 
  FROM sa_split_list( 'Tee Shirt,Baseball Cap,Visor,Shorts' );

Das folgende Beispiel gibt eine Zeile für jedes Wort zurück. Um eine Rückgabe von Wörtern zu vermeiden, wenn row_value eine leere Zeichenfolge ist, muss die WHERE-Klausel angegeben werden.

SELECT *
  FROM sa_split_list( 'one||three|four||six|', '|' ) 
  WHERE row_value <> '';

Im folgenden Beispiel wird eine Prozedur namens "ProductsWithColor" erstellt. Wenn sie aufgerufen wird, verwendet die ProductsWithColor-Prozedur sa_split_list, um die vom Benutzer angegebenen Farbenwerte syntaktisch zu analysieren, überprüft die Color-Spalte der Products-Tabelle und gibt Namen, Beschreibung, Größe und Farbe für jedes Produkt zurück, das einer der vom Benutzer angegebenen Farben entspricht.

Das Ergebnis des untenstehenden Prozeduraufrufs besteht aus Namen, Beschreibung, Größe und Farbe aller Produkte, die entweder weiß oder schwarz sind.

CREATE PROCEDURE ProductsWithColor( IN color_list LONG VARCHAR )
BEGIN
  SELECT Name, Description, Size, Color
  FROM Products
  WHERE Color IN ( SELECT row_value FROM sa_split_list( color_list ) )
END;
go

SELECT * from ProductsWithColor( 'white,black' );