SUBSTRING (Transact-SQL)
Se aplica a: punto de conexión de SQL Server Azure SQL Database Azure SQL Instancia administrada punto de conexión de SQL Analytics Analytics Platform System (PDW) de SQL Analytics System (PDW) de SQL Server en Microsoft Fabric Warehouse 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
SUBSTRING ( expression, start, length )
Nota:
Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.
Argumentos
expression
Es una expresión de tipo character, binary, text, ntext o image.
start
Es un entero o una expresión bigint que especifica dónde empiezan 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 empezará en el primer carácter especificado en expression. En este caso, el número de caracteres que se devuelve es el valor de la suma de start + length- 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.
length
Es un entero positivo o una expresión bigint que especifica cuántos caracteres de expression se van a devolver. 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.
Tipos de valor devuelto
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 |
---|---|
char/varchar/text | varchar |
nchar/nvarchar/ntext | nvarchar |
binary/varbinary/image | 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.
expresión debe ser de tipo varchar(max) o varbinary(max) cuando start o length contienen un valor mayor que 2 147 483 647.
Caracteres adicionales (pares suplentes)
Al usar intercalaciones de caracteres suplementarios (SC), start y length cuentan cada par suplente de expression como un único carácter. Para más información, consulte Compatibilidad con la intercalación y Unicode.
Ejemplos
A. 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;
El conjunto de resultados es el siguiente:
name | Initial | ThirdAndFourthCharacters |
---|---|---|
maestro | m | st |
tempdb | t | mp |
model | m | de |
msdb | m | db |
He aquí cómo mostrar el segundo, tercer y cuarto caracteres de la constante de cadena abcdef
.
SELECT x = SUBSTRING('abcdef', 2, 3);
El conjunto de resultados es el siguiente:
x
----------
bcd
(1 row(s) affected)
B. Usar SUBSTRING con datos de tipo text, ntext e image
Nota:
Para ejecutar estos ejemplos, es necesario 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;
SELECT pub_id, SUBSTRING(logo, 1, 10) AS logo,
SUBSTRING(pr_info, 1, 10) AS pr_info
FROM pub_info
WHERE pub_id = '1756';
El conjunto de resultados es el siguiente:
pub_id logo pr_info
------ ---------------------- ----------
1756 0x474946383961E3002500 This is sa
(1 row(s) affected)
En este ejemplo se muestra el efecto de SUBSTRING en los datos de tipo 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
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 pr INNER JOIN npub_info 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 tabla dbo.DimEmployee
, esta consulta devuelve el apellido en una columna y 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;
El conjunto de resultados es el siguiente:
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;
El conjunto de resultados es el siguiente:
x
-----
bcd
Consulte también
LEFT (Transact-SQL)
LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
TRIM (Transact-SQL)
String Functions (Transact-SQL) [Funciones de cadena (Transact-SQL)]