SUBSTRING (Transact-SQL)
Devuelve parte de una expresión de caracteres, binaria, de texto o de imagen. Para obtener más información acerca de los tipos de datos válidos de SQL Server que se pueden usar con esta función, vea Tipos de datos (Transact-SQL).
.gif "Icono de vínculo a temas")
Sintaxis
SUBSTRING ( value_expression ,start_expression , length_expression )
Argumentos
value_expression
Es una expresión de tipo character, binary, text, ntext o image.start_expression
Es un entero o una expresión bigint que especifica dónde comienzan los caracteres devueltos. Si start_expression es menor que 1, la expresión devuelta comenzará en el primer carácter especificado en value_expression. En este caso, el número de caracteres que se devuelve es el valor de la suma de start_expression y length_expression o 0, el que sea mayor. Si start_expression es mayor que el número de caracteres de la expresión de valor, se devuelve una expresión de longitud cero.length_expression
Es un entero positivo o una expresión bigint que especifica cuántos caracteres de value_expression se van a devolver. Si length_expression es negativo, se genera un error y finaliza la instrucción. Si la suma de start_expression y length_expression es mayor que el número de caracteres de value_expression, se devuelve la expresión de valor completa que empieza en start_expression.
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 |
Valor devuelto |
|---|---|
char/varchar/text |
varchar |
nchar/nvarchar/ntext |
nvarchar |
binary/varbinary/image |
varbinary |
Notas
Los valores para start_expression y length_expression se deben especificar en número de caracteres para los tipos de datos ntext, charo varchar y en bytes para los tipos de datos text, image, binaryo varbinary.
value_expression debe ser varchar(max) o varbinary(max) cuando start_expression o length_expression contiene un valor superior a 2147483647.
[!NOTA]
Los niveles de compatibilidad pueden afectar a los valores devueltos. Para obtener más información acerca de los niveles de compatibilidad, vea sp_dbcmptlevel (Transact-SQL).
Ejemplos
A. Utilizar 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 Contact, esta consulta devuelve el apellido en una columna y solamente la primera inicial en la segunda columna.
USE AdventureWorks;
GO
SELECT LastName, SUBSTRING(FirstName, 1, 1) AS Initial
FROM Person.Contact
WHERE LastName like 'Barl%'
ORDER BY LastName;
Éste es el conjunto de resultados.
LastName Initial
--------------------------------- -------
Barley R
Barlow B
(2 filas afectadas)
A continuación se indica cómo se muestran el segundo, tercer y cuarto caracteres de la constante de cadena abcdef.
SELECT x = SUBSTRING('abcdef', 2, 3);
Éste es el conjunto de resultados.
x
----------
bcd
(1 fila afectada)
B. Utilizar SUBSTRING con datos de tipo text, ntext e image
[!NOTA]
Para ejecutar los siguientes ejemplos es necesario instalar la base de datos pubs. Para obtener información sobre cómo instalar la base de datos pubs, vea Descargar las bases de datos de ejemplo Northwind y pubs.
En el siguiente ejemplo se muestra cómo se devuelven los 10 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 tipo text se devuelven como varchar y los de tipo image 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';
Éste es el conjunto de resultados.
pub_id logo pr_info
------ ---------------------- ----------
1756 0x474946383961E3002500 Es el sa
(1 fila afectada)
En el ejemplo siguiente se muestra el efecto de SUBSTRING en los datos de tipo ntext y text. 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');
INSERT npub_info values('0877', N'üThis is sample text data for Binnet & Hardley, publisher 0877 in the pubs databa');
INSERT npub_info values('1389', N'üThis is sample text data for Algodata Infosystems, publisher 1389 in the pubs da');
INSERT npub_info values('9952', N'üThis is sample text data for Scootney Books, publisher 9952 in the pubs database');
INSERT npub_info values('1622', N'üThis is sample text data for Five Lakes Publishing, publisher 1622 in the pubs d');
INSERT npub_info values('1756', N'üThis is sample text data for Ramona Publishers, publisher 1756 in the pubs datab');
INSERT npub_info values('9901', N'üThis is sample text data for GGG&G, publisher 9901 in the pubs database. GGG&G i');
INSERT npub_info values('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;