SUBSTRING (Transact-SQL)SUBSTRING (Transact-SQL)

Este tema se aplica a: SíSQL Server (a partir de 2008)Síbase de datos de SQL AzureSíalmacenamiento de datos de SQL Azure Sí Almacenamiento de datos paralelos THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Devuelve parte de una expresión de caracteres, binaria, de texto o de imagen en SQL ServerSQL Server.Returns part of a character, binary, text, or image expression in SQL ServerSQL Server.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

SUBSTRING ( expression ,start , length )  

ArgumentosArguments

expressionexpression
Es una expresión de tipo character, binary, text, ntext o image.Is a character, binary, text, ntext, or image expression.

startstart
Es un entero o una expresión bigint que especifica dónde empiezan los caracteres devueltos.Is an integer or bigint expression that specifies where the returned characters start. (La numeración se basa en 1, lo que significa que el primer carácter de la expresión es 1).(The numbering is 1 based, meaning that the first character in the expression is 1). Si start es menor que 1, la expresión devuelta empezará en el primer carácter especificado en expression.If start is less than 1, the returned expression will begin at the first character that is specified in expression. En este caso, el número de caracteres que se devuelve es el valor de la suma de start + length- 1 o 0.In this case, the number of characters that are returned is the largest value of either the sum of start + length- 1 or 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.If start is greater than the number of characters in the value expression, a zero-length expression is returned.

lengthlength
Es un entero positivo o una expresión bigint que especifica cuántos caracteres de expression se van a devolver.Is a positive integer or bigint expression that specifies how many characters of the expression will be returned. Si length es negativo, se genera un error y finaliza la instrucción.If length is negative, an error is generated and the statement is terminated. 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.If the sum of start and length is greater than the number of characters in expression, the whole value expression beginning at start is returned.

Tipos devueltosReturn Types

Devuelve datos de caracteres si expression es de alguno de los tipos de datos de caracteres admitidos.Returns character data if expression is one of the supported character data types. Devuelve datos binarios si expression es de alguno de los tipos de datos binary admitidos.Returns binary data if expression is one of the supported binary data types. La cadena devuelta es del mismo tipo que la expresión indicada, con las excepciones mostradas en la tabla:The returned string is the same type as the specified expression with the exceptions shown in the table.

Expresión especificadaSpecified expression Tipo de valor devueltoReturn type
char/varchar/textchar/varchar/text varcharvarchar
nchar/nvarchar/ntextnchar/nvarchar/ntext nvarcharnvarchar
binary/varbinary/imagebinary/varbinary/image varbinaryvarbinary

NotasRemarks

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.The values for start and length must be specified in number of characters for ntext, char, or varchar data types and bytes for text, image, binary, or varbinary data types.

expresión debe ser de tipo varchar(max) o varbinary(max) cuando start o length contienen un valor mayor que 2 147 483 647.The expression must be varchar(max) or varbinary(max) when the start or length contains a value larger than 2147483647.

Caracteres adicionales (pares suplentes)Supplementary Characters (Surrogate Pairs)

Al usar intercalaciones de caracteres suplementarios (SC), start y length cuentan cada par suplente de expression como un único carácter.When using supplementary character (SC) collations, both start and length count each surrogate pair in expression as a single character. Para más información, consulte Compatibilidad con la intercalación y Unicode.For more information, see Collation and Unicode Support.

EjemplosExamples

A.A. Usar SUBSTRING con una cadena de caracteresUsing SUBSTRING with a character string

En el siguiente ejemplo se muestra cómo devolver únicamente una parte de una cadena de caracteres.The following example shows how to return only a part of a character string. 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.From the sys.databases table, this query returns the system database names in the first column, the first letter of the database in the second column, and the third and fourth characters in the final column.

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.Here is the result set.

NAMEname InitialInitial ThirdAndFourthCharactersThirdAndFourthCharacters
maestramaster mm stst
tempdbtempdb tt mpmp
modelmodel mm dede
msdbmsdb mm dbdb

He aquí cómo mostrar el segundo, tercer y cuarto caracteres de la constante de cadena abcdef.Here is how to display the second, third, and fourth characters of the string constant abcdef.

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

El conjunto de resultados es el siguiente.Here is the result set.

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

(1 row(s) affected)

B.B. Usar SUBSTRING con datos de tipo text, ntext e imageUsing SUBSTRING with text, ntext, and image data

Nota

Para ejecutar estos ejemplos, es necesario instalar la base de datos pubs.To run the following examples, you must install the pubs database.

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.The following example shows how to return the first 10 characters from each of a text and image data column in the pub_info table of the pubs database. Los datos de text se devuelven como varchar, mientras que los datos de image se devuelven como varbinary.text data is returned as varchar, and image data is returned as 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.Here is the result set.

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.The following example shows the effect of SUBSTRING on both text and ntext data. En primer lugar, este ejemplo crea una nueva tabla en la base de datos pubs denominada npub_info.First, this example creates a new table in the pubs database named 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.Second, the example creates the pr_info column in the npub_info table from the first 80 characters of the pub_info.pr_info column and adds an ü as the first character. 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.Lastly, an INNER JOIN retrieves all publisher identification numbers and the SUBSTRING of both the text and ntext publisher information columns.

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: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse and Almacenamiento de datos paralelosParallel Data Warehouse

C.C. Usar SUBSTRING con una cadena de caracteresUsing SUBSTRING with a character string

En el siguiente ejemplo se muestra cómo devolver únicamente una parte de una cadena de caracteres.The following example shows how to return only a part of a character string. En la tabla dbo.DimEmployee, esta consulta devuelve el apellido en una columna y solo la primera inicial en la segunda columna.From the dbo.DimEmployee table, this query returns the last name in one column with only the first initial in the second column.

-- 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.Here is the result set.

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.The following example shows how to return the second, third, and fourth characters of the string constant abcdef.

USE ssawPDW;  

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

El conjunto de resultados es el siguiente.Here is the result set.

x
-----
bcd

Ver tambiénSee Also

LEFT (Transact-SQL)LEFT (Transact-SQL)
LTRIM (Transact-SQL)LTRIM (Transact-SQL)
RIGHT (Transact-SQL)RIGHT (Transact-SQL)
RTRIM (Transact-SQL)RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)STRING_SPLIT (Transact-SQL)
TRIM (Transact-SQL)TRIM (Transact-SQL)
Funciones de cadena (Transact-SQL)String Functions (Transact-SQL)