Partekatu honen bidez:

SUBCADENA (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Devuelve parte de una expresión de caracteres, binaria, de texto o de imagen en SQL Server.

Convenciones de sintaxis de Transact-SQL

Sintaxis

Sintaxis para SQL Server.

SUBSTRING ( expression , start , length )

Sintaxis para Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) y Almacén y punto de conexión de análisis de SQL en Microsoft Fabric.

SUBSTRING ( expression , start [ , length ] )

Argumentos

expresión

Carácter,binario, texto, ntext o expresiónde imagen.

iniciar

Expresión integer o bigint que especifica dónde se inician los caracteres devueltos. (La numeración se basa en 1, lo que significa que el primer carácter de la expresión es 1). Si start es menor que 1, la expresión devuelta comienza en el primer carácter especificado en la expresión. En este caso, el número de caracteres que se devuelven es el valor más grande de la suma de + inicial : 1 o 0. Si start es mayor que el número de caracteres de la expresión de valor, se devuelve una expresión de longitud cero.

largura

Un entero positivo o expresión bigint que especifica cuántos caracteres de la expresión se devuelven. Si length es negativo, se genera un error y finaliza la instrucción. Si la suma de start y length es mayor que el número de caracteres de expression, se devuelve la expresión de valor completa que empieza en start. Si se omite length , se devuelven todos los caracteres de la posición inicial al final de la expresión.

Puede usar la subcadena con un argumento de longitud opcional en Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) y almacén y punto de conexión de análisis de SQL en Microsoft Fabric. Sin embargo, si usa NULL para longitud, SUBSTRING devuelve NULL. Revise E. Use SUBSTRING con el argumento de longitud opcional para obtener un ejemplo.

Tipos de valores devueltos

Devuelve datos de caracteres si expression es de alguno de los tipos de datos de caracteres admitidos. Devuelve datos binarios si expression es de alguno de los tipos de datos binary admitidos. La cadena devuelta es del mismo tipo que la expresión indicada, con las excepciones mostradas en la tabla:

Expresión especificada Tipo de valor devuelto
carbonizar / varchar / Mensaje de texto varchar
nchar / nvarchar / ntexto nvarchar
binario / varbinary / imagen varbinary

Observaciones

Los valores de start y length deben especificarse en número de caracteres para los tipos de datos ntext, char o varchar y bytes para los tipos de datos text, image, binary o varbinary.

La expresión debe ser varchar(max) o varbinary(max) cuando el inicio o la longitud contiene un valor mayor que 2.147.483.647.

Caracteres adicionales (pares suplentes)

Cuando se usan intercalaciones de caracteres adicionales (SC), tanto el inicio como la longitud cuentan cada par suplente en expresión como un solo carácter. Para obtener más información, consulte Soporte técnico de intercalación y Unicode.

Ejemplos

Un. Usar SUBSTRING con una cadena de caracteres

En el siguiente ejemplo se muestra cómo devolver únicamente una parte de una cadena de caracteres. Desde la tabla sys.databases, esta consulta devuelve los nombres de base de datos del sistema en la primera columna, la primera letra de la base de datos en la segunda columna y el tercer y cuarto carácter en la última columna.

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

Este es el conjunto de resultados.

nombre Inicial ThirdAndFourthCharacters
master m st
tempdb t mp
model m de
msdb m db

Para mostrar los caracteres segundo, tercero y cuarto de la constante abcdefde cadena , use la consulta siguiente.

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

Este es el conjunto de resultados.

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

B. Uso de SUBSTRING con datos de texto, ntext e imagen

Nota:

Para ejecutar los ejemplos siguientes, debe instalar la base de datos pubs.

En este ejemplo se muestra cómo se devuelven los diez primeros caracteres de cada columna de datos de tipo text e image de la tabla pub_info de la base de datos pubs. Los datos de text se devuelven como varchar, mientras que los datos de image se devuelven como varbinary.

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';

Este es el conjunto de resultados.

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

En el ejemplo siguiente se muestra el efecto de SUBSTRING en los datos text y ntext . En primer lugar, este ejemplo crea una nueva tabla en la base de datos pubs denominada npub_info. En segundo lugar, crea la columna pr_info en la tabla npub_info a partir de los primeros 80 caracteres de la columna pub_info.pr_info y agrega una ü como primer carácter. Por último, INNER JOIN recupera todos los números de identificación del publicador y una función SUBSTRING de las columnas de información del publicador, de tipo text y ntext.

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;

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

C. Usar SUBSTRING con una cadena de caracteres

En el siguiente ejemplo se muestra cómo devolver únicamente una parte de una cadena de caracteres. En la dbo.DimEmployee tabla, esta consulta devuelve el nombre de familia en una columna con solo la primera inicial en la segunda columna.

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

Este es el conjunto de resultados.

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

En este ejemplo se muestra el segundo, tercer y cuarto carácter de la constante de cadena abcdef.

USE ssawPDW;

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

Este es el conjunto de resultados.

x
-----
bcd

D. Uso de SUBSTRING con NULL el argumento length

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

Este es el conjunto de resultados.

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

E. Uso de SUBSTRING con el argumento de longitud opcional

Se aplica a: Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) y el punto de conexión de análisis de SQL y Warehouse en Microsoft Fabric

En el ejemplo siguiente se muestra cómo devolver solo una parte de una cadena de caracteres desde una posición inicial determinada. Dado que no se proporciona el argumento length , la longitud predeterminada devuelve los caracteres restantes de la cadena.

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

Este es el conjunto de resultados.

y
-----
abc

F. Usar SUBSTRING sin un argumento de longitud para buscar piezas de reemplazo en el inventario de AdventureWorks2022

USE AdventureWorks2022;
GO

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

Este es el conjunto de resultados.

ProductDescriptionID Descripción Replacement-Part
686 Rueda de montaña de reemplazo para el piloto de nivel de entrada. rueda de montaña para el piloto de nivel de entrada.
687 Rueda de montaña de reemplazo para el piloto casual a serio. rueda de montaña para el jinete casual a serio.
689 Rueda delantera de la carretera de reemplazo para el ciclismo de nivel de entrada. rueda delantera de carretera para ciclistas de nivel de entrada.
867 Rueda trasera trasera de montaña para el piloto de nivel de entrada. rueda trasera de montaña para el piloto de nivel de entrada.
868 Reposición de rueda trasera de montaña para el piloto casual a serio. rueda trasera de montaña para el piloto casual a serio.
870 Rueda trasera de reemplazo para ciclistas de nivel de entrada. rueda trasera para ciclistas de nivel de entrada.
1981 Rueda de montaña de reemplazo para el piloto de nivel de entrada. rueda de montaña para el piloto de nivel de entrada.
1987 Rueda de montaña de reemplazo para el piloto casual a serio. rueda de montaña para el jinete casual a serio.
1999 Rueda trasera de la carretera de reemplazo para el ciclismo de nivel de entrada. rueda trasera de carretera para ciclistas de nivel de entrada.

Contenido relacionado