REGEXP_SPLIT_TO_TABLE

Gilt für: SQL Server 2025 (17.x) Azure SQL-Datenbank AzureSQL Managed InstanceSQL SQL-Datenbank in Microsoft Fabric

Die REGEXP_SPLIT_TO_TABLE tabellenwertige reguläre Ausdrucksfunktion liefert eine Tabelle mit geteilten Strings, die durch das Regex-Muster begrenzt sind. Wenn keine Übereinstimmung mit dem Muster vorhanden ist, gibt die Funktion die Zeichenfolge zurück.

REGEXP_SPLIT_TO_TABLE
(
    string_expression,
    pattern_expression [ , flags ]
)

Arguments

string_expression

Ein Ausdruck einer Zeichenfolge.

Dabei kann es sich um eine Konstante, Variable oder Spalte von Zeichenfolgen handeln.

Datentypen: Char, nchar, varcharoder nvarchar.

Note

Die Funktionen REGEXP_* unterstützen LOB-Typen (varchar(max) und nvarchar(max)) bis zu 2 MB für den string_expression-Parameter .

pattern_expression

Muster für reguläre Ausdrücke, das übereinstimmen soll. In der Regel ein Textliteral.

Datentypen: Char, nchar, varcharoder nvarchar. pattern_expression unterstützt eine maximale Zeichenlänge von 8.000 Byte.

flags

Mindestens ein Zeichen, das die Modifizierer für die Suche nach Übereinstimmungen angibt. Der Typ ist varchar oder Zeichenmit maximal 30 Zeichen.

Beispiel: ims. Der Standardwert lautet c. Wenn eine leere Zeichenfolge (' ') angegeben wird, wird sie als Standardwert ('c')behandelt. Geben Sie c oder andere Zeichenausdrücke an. Wenn das Kennzeichen mehrere widersprüchliche Zeichen enthält, verwendet SQL Server das letzte Zeichen.

Wenn Sie z. B. angeben, ic der regex-Wert den Abgleich zwischen Groß- und Kleinschreibung zurückgibt.

Wenn der Wert ein anderes Zeichen als die unter unterstützten Flagwerteenthält, gibt die Abfrage einen Fehler wie im folgenden Beispiel zurück:

Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
Unterstützte Flagwerte
Flag Description
i Groß-/Kleinschreibung wird nicht beachtet (Standard false)
m Mehrzeiligen Modus: ^ und $ Zuordnen der Anfangs-/Endzeile zusätzlich zum Anfangs-/Endtext (Standard false)
s Übereinstimmung . zulassen \n (Standardfalse)
c Groß-/Kleinschreibung beachten (Standard true)

Returns

REGEXP_SPLIT_TO_TABLE gibt die folgende zweispaltige Tabelle zurück:

Spaltenname Datentyp Description
value Gleicher Typ wie string_expression oder Varchar Wenn das Trennzeichen gefunden wird, ist es die entsprechende Teilzeichenfolge. Andernfalls ist es der gesamte Ausdruck.
ordinal bigint 1-basierte Indexwert jeder Teilzeichenfolgenposition aus dem Eingabeausdruck.

Zurückgeben einer Tabellenteilung für the quick brown fox jumps over the lazy dog.

SELECT *
FROM REGEXP_SPLIT_TO_TABLE ('the quick brown fox jumps over the lazy dog', '\s+');

Value  Ordinal
the    1
quick  2
brown  3
fox    4
jumps  5
over   6
the    7
lazy   8
dog    9

Plattformunterstützung

Erfordert Datenbankkompatibilitätsebene 170. Um das Kompatibilitätsniveau der Datenbank festzulegen, überprüfen ALTER DATABASE Sie das Kompatibilitätsniveau (Transact-SQL). Die Kompatibilitätsanforderung gilt nicht, wenn die ALLOW_BUILTIN_TVF_IN_ALL_COMPAT_LEVELS datenbankbezogene Konfiguration aktiviert ist.

  • In Azure SQL Managed Instance sind T-SQL-reguläre Ausdrucksfunktionen nur mit der Aktualisierungsrichtlinie SQL Server 2025 oder Always-up-to-Datum verfügbar.
  • T-SQL-reguläre Ausdrucksfunktionen sind in Azure SQL-Datenbank, SQL-Datenbank in Fabric und ab SQL Server 2025 verfügbar.
  • T-SQL-reguläre Ausdrucksfunktionen sind in SQL Server 2022 oder früheren Versionen nicht verfügbar.
  • In Fabric Data Warehouse werden die tabellenwertigen Funktionen REGEXP_SPLIT_TO_TABLE und REGEXP_MATCHES regulären Ausdrucks nicht unterstützt. T-SQL-Skalarfunktionen für reguläre Ausdruck sind als Vorschaufunktion in Fabric Data Warehouse verfügbar.

Verwandte Inhalte

  • Zuletzt aktualisiert um