Freigeben über


TEILZEICHENFOLGE (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-Endpunkt in Microsoft FabricWarehouse in Microsoft Fabric

Gibt einen Teil eines Zeichen-, Binär-, Text- oder Bildausdrucks in SQL Server zurück.

Transact-SQL-Syntaxkonventionen

Syntax

Syntax für SQL Server.

SUBSTRING ( expression , start , length )

Syntax für Azure SQL-Datenbank, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) und Warehouse- und SQL-Analyseendpunkt in Microsoft Fabric.

SUBSTRING ( expression , start [ , length ] )

Argumente

Ausdruck

Ein Zeichen, binärerText, ntext oder Bildausdruck.

starten

Ein ganzzahliger oder bigint-Ausdruck , der angibt, wo die zurückgegebenen Zeichen beginnen. (Die Nummerierung basiert auf 1, das bedeutet, dass das erste Zeichen im Ausdruck 1 ist.) Wenn der Anfang kleiner als 1 ist, beginnt der zurückgegebene Ausdruck mit dem ersten Zeichen, das im Ausdruck angegeben ist. In diesem Fall ist die Anzahl der zurückgegebenen Zeichen der größte Wert der Summe der Anfangslänge + - 1 oder 0. Wenn start größer ist als die Anzahl der Zeichen in dem Werteausdruck, wird eine Zeichenfolge der Länge 0 zurückgegeben.

Länge

Ein positiver ganzzahliger oder bigint-Ausdruck , der angibt, wie viele Zeichen des Ausdrucks zurückgegeben werden. Wenn length negativ ist, wird ein Fehler generiert, und die Anweisung wird beendet. Wenn die Summe von start und length größer ist als die Anzahl der Zeichen in expression, wird der gesamte Wertausdruck, beginnend bei start, zurückgegeben. Wenn die Länge weggelassen wird, werden alle Zeichen von der Startposition bis zum Ende des Ausdrucks zurückgegeben.

Sie können Teilzeichenfolgen mit einem optionalen Längenargument in Azure SQL-Datenbank, azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) und Warehouse- und SQL-Analyseendpunkt in Microsoft Fabric verwenden. Wenn Sie die NULL jedoch verwenden, SUBSTRING wird zurückgegebenNULL. Überprüfen Sie E. Verwenden Sie SUBSTRING mit optionalem Längenargument für ein Beispiel.

Rückgabetypen

Gibt Zeichendaten zurück, wenn expression einer der unterstützten Zeichendatentypen ist. Gibt Binärdaten zurück, wenn expression einer der unterstützten Binärdatentypen ist. Die zurückgegebene Zeichenfolge hat denselben Typ wie der angegebene Ausdruck, mit den folgenden Ausnahmen:

Angegebener Ausdruck Rückgabetyp
verkohlen / varchar / Text varchar
nchar / nvarchar / ntext nvarchar
binär / varbinär / Bild varbinär

Bemerkungen

Die Werte für start und length müssen als Anzahl der Zeichen für die Datentypen ntext, char oder varchar und Bytes für die Datentypen text, image, binary oder varbinary angegeben werden.

Der Ausdruck muss varchar(max) oder varbinary(max) sein, wenn der Anfang oder die Länge einen Wert enthält, der größer als 2.147.483.647 ist.

Zusatzzeichen (Ersatzpaare)

Wenn Sie Zusatzzeichen (SC) verwenden, zählen start - und längenpaare im Ausdruck als einzelnes Zeichen. Weitere Informationen finden Sie unter Sortierungs- und Unicode-Support.

Beispiele

Ein. Verwenden von SUBSTRING mit einer Zeichenfolge

Im folgenden Beispiel wird gezeigt, wie Sie nur einen Teil einer Zeichenfolge zurückgeben können. Diese Abfrage gibt aus der Tabelle sys.databases in der ersten Spalte die Namen der Systemdatenbank zurück, in der zweiten Spalten den ersten Buchstaben der Datenbank und in der letzten Spalte den dritten und vierten Buchstaben.

SELECT name,
       SUBSTRING(name, 1, 1) AS Initial,
       SUBSTRING(name, 3, 2) AS ThirdAndFourthCharacters
FROM sys.databases
WHERE database_id < 5;

Hier sehen Sie das Ergebnis.

Name Initial DritteundvierteZeichen
master m st
tempdb t mp
model m de
msdb m db

Um die zweiten, dritten und vierten Zeichen der Zeichenfolgenkonstante abcdefanzuzeigen, verwenden Sie die folgende Abfrage.

SELECT SUBSTRING('abcdef', 2, 3) AS x;

Hier sehen Sie das Ergebnis.

x
----------
bcd

B. Verwenden von SUBSTRING mit Text-, ntext- und Bilddaten

Hinweis

Zum Ausführen der folgenden Beispiele müssen Sie die Pubs-Datenbank installieren.

Im folgenden Beispiel wird gezeigt, wie die ersten 10 Zeichen aus allen text- und image-Datenspalten in der pub_info-Tabelle der pubs-Datenbank zurückgegeben werden. text-Daten werden als varchar zurückgegeben, und image-Daten werden als varbinary zurückgegeben.

USE pubs;
GO

SELECT pub_id,
       SUBSTRING(logo, 1, 10) AS logo,
       SUBSTRING(pr_info, 1, 10) AS pr_info
FROM pub_info
WHERE pub_id = '1756';

Hier sehen Sie das Ergebnis.

 pub_id logo    pr_info
------ ---------------------- ----------
1756   0x474946383961E3002500 This is sa

Das folgende Beispiel zeigt die Auswirkung sowohl SUBSTRING auf Text - als auch auf ntext-Daten . Zunächst wird in diesem Beispiel eine neue Tabelle in der pubs-Datenbank namens npub_info erstellt. Im nächsten Schritt wird die Spalte pr_info in der npub_info-Tabelle aus den ersten 80 Zeichen der pub_info.pr_info-Spalte erstellt und ein ü als erstes Zeichen hinzugefügt. Abschließend ruft ein INNER JOIN alle Verleger-IDs sowie den SUBSTRING der text- und ntext-Spalten mit Verlegerinformationen ab.

IF EXISTS (SELECT table_name
           FROM INFORMATION_SCHEMA.TABLES
           WHERE table_name = 'npub_info')
    DROP TABLE npub_info;
GO

-- Create npub_info table in pubs database. Borrowed from instpubs.sql.
USE pubs;
GO

CREATE TABLE npub_info
(
    pub_id CHAR (4) NOT NULL FOREIGN KEY
        REFERENCES publishers (pub_id)
        CONSTRAINT UPKCL_npubinfo PRIMARY KEY CLUSTERED,
    pr_info NTEXT NULL
);
GO

-- Fill the pr_info column in npub_info with international data.
RAISERROR ('Now at the inserts to pub_info...', 0, 1);
GO

INSERT npub_info
VALUES ('0736', N'üThis is sample text data for New Moon Books, publisher 0736 in the pubs database'),
    ('0877', N'üThis is sample text data for Binnet & Hardley, publisher 0877 in the pubs databa'),
    ('1389', N'üThis is sample text data for Algodata Infosystems, publisher 1389 in the pubs da'),
    ('9952', N'üThis is sample text data for Scootney Books, publisher 9952 in the pubs database'),
    ('1622', N'üThis is sample text data for Five Lakes Publishing, publisher 1622 in the pubs d'),
    ('1756', N'üThis is sample text data for Ramona Publishers, publisher 1756 in the pubs datab'),
    ('9901', N'üThis is sample text data for GGG&G, publisher 9901 in the pubs database. GGG&G i'),
    ('9999', N'üThis is sample text data for Lucerne Publishing, publisher 9999 in the pubs data');
GO

-- Join between npub_info and pub_info on pub_id.
SELECT pr.pub_id,
       SUBSTRING(pr.pr_info, 1, 35) AS pr_info,
       SUBSTRING(npr.pr_info, 1, 35) AS npr_info
FROM pub_info AS pr
     INNER JOIN npub_info AS npr
         ON pr.pub_id = npr.pub_id
ORDER BY pr.pub_id ASC;

Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

C. Verwenden von SUBSTRING mit einer Zeichenfolge

Im folgenden Beispiel wird gezeigt, wie Sie nur einen Teil einer Zeichenfolge zurückgeben können. Aus der dbo.DimEmployee Tabelle gibt diese Abfrage den Familiennamen in einer Spalte mit nur der ersten Initiale in der zweiten Spalte zurück.

-- Uses AdventureWorks
SELECT LastName,
       SUBSTRING(FirstName, 1, 1) AS Initial
FROM dbo.DimEmployee
WHERE LastName LIKE 'Bar%'
ORDER BY LastName;

Hier sehen Sie das Ergebnis.

LastName             Initial
-------------------- -------
Barbariol            A
Barber               D
Barreto de Mattos    P

Das folgende Beispiel stellt dar, wie die zweiten, dritten und vierten Buchstaben der Zeichenfolgenkonstanten abcdef zurückgegeben werden.

USE ssawPDW;

SELECT TOP 1 SUBSTRING('abcdef', 2, 3) AS x
FROM dbo.DimCustomer;

Hier sehen Sie das Ergebnis.

x
-----
bcd

D. Verwenden von SUBSTRING mit NULL Längenargument

SELECT SUBSTRING('123abc', 4, NULL) AS [NULL length];

Hier sehen Sie das Ergebnis.

NULL length
-----------
NULL

E. Verwenden von SUBSTRING mit optionalem Längenargument

Gilt für: Azure SQL-Datenbank, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) und Warehouse- und SQL-Analyseendpunkt in Microsoft Fabric

Das folgende Beispiel zeigt, wie nur ein Teil einer Zeichenfolge von einer bestimmten Anfangsposition zurückgegeben wird. Da das Längenargument nicht angegeben wird, gibt die Länge standardmäßig die verbleibenden Zeichen in der Zeichenfolge zurück.

SELECT SUBSTRING('123abc', 4) AS y;

Hier sehen Sie das Ergebnis.

y
-----
abc

F. Verwenden von SUBSTRING ohne Längenargument, um Ersatzteile im AdventureWorks2022-Bestand zu finden

USE AdventureWorks2022;
GO

SELECT [ProductDescriptionID],
       [Description],
       SUBSTRING([Description], LEN('Replacement') + 1) AS [Replacement-Part]
FROM [Production].[ProductDescription]
WHERE [Description] LIKE 'Replacement%';

Hier sehen Sie das Ergebnis.

Produktbeschreibungs-ID BESCHREIBUNG Replacement-Part
686 Ersatz-Bergrad für Einstiegsfahrer. Bergrad für Einstiegsfahrer.
687 Ersatz-Bergrad für den lässigen ernsten Fahrer. Bergrad für den lässigen, ernsten Fahrer.
689 Ersatzfahrrad für Einstiegsradfahrer. Straßen-Vorderrad für Einstiegsradfahrer.
867 Ersatz-Bergrad für Einstiegsfahrer. Hinteres Bergrad für Einstiegsfahrer.
868 Ersatz-Hinterbergrad für den lässigen ernsten Fahrer. Hinteres Bergrad für den lässigen, ernsten Fahrer.
870 Ersatzrückrad für Einstiegsradfahrer. Hinterrad für Einstiegsradfahrer.
1981 Ersatz-Bergrad für Einstiegsfahrer. Bergrad für Einstiegsfahrer.
1987 Ersatz-Bergrad für den lässigen ernsten Fahrer. Bergrad für den lässigen, ernsten Fahrer.
1999 Ersatz-Hinterrad für Einstiegsradfahrer. Straßenrückrad für Einstiegsradfahrer.