REGEXP_INSTR (Transact-SQL) Vorschau

2025-05-22

Gilt für: SQL Server 2025 (17.x) Vorschau der Azure SQL-Datenbank azureSQL Managed Instance SQL SQL-Datenbank in Microsoft Fabric

Anmerkung

Als Vorschaufeature unterliegt die in diesem Artikel vorgestellte Technologie ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Gibt die Anfangs- oder Endposition der übereinstimmenden Teilzeichenfolge abhängig vom Wert des arguments return_option zurück.

REGEXP_INSTR
     (
      string_expression,
      pattern_expression
         [, start [, occurrence [, return_option [, flags [, group ] ] ] ] ]
     )

Argumente

string_expression

Ein Ausdruck einer Zeichenfolge.

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

Datentypen: Char, nchar, varcharoder nvarchar.

Anmerkung

Die REGEXP_LIKE, REGEXP_COUNTund REGEXP_INSTR Funktionen 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.

starten

Gibt die Startposition für die Suche innerhalb der Suchzeichenfolge an. Wahlfrei. Typ ist int oder bigint.

Die Nummerierung ist 1-basiert, d. h. das erste Zeichen im Ausdruck ist 1 und der Wert muss >= 1werden. Wenn der Startausdruck kleiner als 1ist, wird ein Fehler zurückgegeben. Wenn der Startausdruck größer als die Länge string_expression ist, gibt die Funktion zurück 0. Der Standardwert ist 1.

Vorkommen

Ein Ausdruck (positive ganze Zahl), der angibt, welches Vorkommen des Musterausdrucks innerhalb der Quellzeichenfolge durchsucht oder ersetzt werden soll. Der Standardwert ist 1. Sucht nach dem ersten Zeichen des string_expression. Bei einer positiven ganzzahligen Zahl nsucht sie nach dem nth ersten Zeichen nach dem ersten Vorkommen des pattern_expression usw.

return_option

Gibt an, ob die Anfangs- oder Endposition der übereinstimmenden Teilzeichenfolge zurückgegeben werden soll. Verwenden Sie 0 für den Anfang und 1 für das Ende. Der Standardwert ist 0. Die Abfrage gibt einen Fehler für einen anderen Wert zurück.

Kennzeichnung

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 ist 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

Flagge	Beschreibung
`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` (Standard`false`)
`c`	Groß-/Kleinschreibung beachten (Standard `true`)

Gruppen-

Gibt an, welche Erfassungsgruppe (subexpression) eines pattern_expression die Position innerhalb string_expression zurückgibt. Die Gruppe ist ein Musterfragment, das in Klammern eingeschlossen ist und geschachtelt werden kann. Die Gruppen werden in der Reihenfolge nummeriert, in der ihre linken Klammern im Muster angezeigt werden. Der Wert ist eine ganze Zahl und muss >= 0 nicht größer sein als die Anzahl der Gruppen in der pattern_expression. Der Standardwert ist 0, der angibt, dass die Position auf der Zeichenfolge basiert, die dem gesamten pattern_expression entspricht.

Wenn der Wert größer als die Anzahl der Gruppen in pattern_expression ist, gibt die Funktion zurück 0.

Rückgabewert

Ganze Zahl.

Beispiele

Suchen Sie die Position der ersten Teilzeichenfolge, die nur Ziffern in der spalte PRODUCT_DESCRIPTION enthält.

SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, '\d+')
FROM PRODUCTS;

Suchen Sie die Position des dritten Vorkommens des Buchstabens a (Groß-/Kleinschreibung) in der spalte PRODUCT_NAME.

SELECT REGEXP_INSTR(PRODUCT_NAME, 'a', 1, 3, 0, 'i')
FROM PRODUCTS;

Suchen Sie die Position des Endes der ersten Teilzeichenfolge, die mit t beginnt, und endet mit e (Groß-/Kleinschreibung) in der spalte PRODUCT_DESCRIPTION.

SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, 't.*?e', 1, 1, 1)
FROM PRODUCTS;

Freigeben über