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

APLICA-SE A: simSQL Server (a partir do 2008) simBanco de Dados SQL do Azure simSQL Data Warehouse do Azure simParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Retorna parte de uma expressão de caractere, binária, de texto ou de imagem no SQL ServerSQL Server.Returns part of a character, binary, text, or image expression in SQL ServerSQL Server.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

SUBSTRING ( expression ,start , length )  

ArgumentosArguments

expressãoexpression
É character, binary, text, ntextou imageexpression.Is a character, binary, text, ntext, or image expression.

startstart
É um inteiro ou uma expressão bigint que especifica o ponto em que os caracteres retornados devem iniciar.Is an integer or bigint expression that specifies where the returned characters start. (A numeração é baseada em 1, ou seja, o primeiro caractere da expressão é 1).(The numbering is 1 based, meaning that the first character in the expression is 1). Se start for menos que 1, a expressão retornada começará no primeiro caractere especificado em expression.If start is less than 1, the returned expression will begin at the first character that is specified in expression. Nesse caso, o número de caracteres retornados é o valor maior da soma de start + length- 1 ou 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. Se start for maior que o número de caracteres na expressão de valor, uma expressão de comprimento zero será retornada.If start is greater than the number of characters in the value expression, a zero-length expression is returned.

lengthlength
É um inteiro positivo ou uma expressão bigint que especifica quantos caracteres da expression são retornados.Is a positive integer or bigint expression that specifies how many characters of the expression will be returned. Se lenght for negativo, um erro será gerado e a instrução será encerrada.If length is negative, an error is generated and the statement is terminated. Se a soma de start e length for maior que o número de caracteres em expression, a expressão de valor inteiro, começando no start será retornado.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 de retornoReturn Types

Retorna dados de caractere se expression é um dos tipos de dados de caractere compatíveis.Returns character data if expression is one of the supported character data types. Retorna dados binários se expression é um dos tipos de dados binary compatíveis.Returns binary data if expression is one of the supported binary data types. A cadeia de caracteres retornada é do mesmo tipo que a expressão especificada com as exceções mostradas na tabela.The returned string is the same type as the specified expression with the exceptions shown in the table.

Expressão especificadaSpecified expression Tipo de retornoReturn type
char/varchar/textchar/varchar/text varcharvarchar
nchar/nvarchar/ntextnchar/nvarchar/ntext nvarcharnvarchar
binary/varbinary/imagebinary/varbinary/image varbinaryvarbinary

RemarksRemarks

Os valores para start e length devem ser especificados em número de caracteres para tipos de dados ntext, char ou varchar e bytes para tipos de dados text, image, binary ou 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.

A expression devem ser varchar(max) ou varbinary(max) quando o start ou length contém um valor maior que 2147483647.The expression must be varchar(max) or varbinary(max) when the start or length contains a value larger than 2147483647.

Caracteres suplementares (pares substitutos)Supplementary Characters (Surrogate Pairs)

Ao usar ordenações de caracteres suplementares (SC), tanto start quanto length contarão cada par alternativo na expression como um único caractere.When using supplementary character (SC) collations, both start and length count each surrogate pair in expression as a single character. Para obter mais informações, consulte Suporte a ordenações e a Unicode.For more information, see Collation and Unicode Support.

ExemplosExamples

A.A. Usando SUBSTRING com uma cadeia de caracteresUsing SUBSTRING with a character string

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres.The following example shows how to return only a part of a character string. Na tabela sys.databases, esta consulta retorna os nomes do banco de dados do sistema na primeira coluna, a primeira letra do banco de dados na segunda coluna e os terceiros e quarto caracteres na coluna final.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;   

Aqui está o conjunto de resultados.Here is the result set.

NAMEname InicialInitial ThirdAndFourthCharactersThirdAndFourthCharacters
mastermaster mm stst
tempdbtempdb tt mpmp
modelomodel mm dede
msdbmsdb mm dbdb

Veja como exibir o segundo, terceiro e quarto caracteres da constante de cadeia de caracteres abcdef.Here is how to display the second, third, and fourth characters of the string constant abcdef.

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

Aqui está o conjunto de resultados.Here is the result set.

x  
----------  
bcd  
 
(1 row(s) affected)

b.B. Usando SUBSTRING com dados de texto, ntext e de imagemUsing SUBSTRING with text, ntext, and image data

Observação

Para executar os exemplos a seguir, é necessário instalar o banco de dados pubs.To run the following examples, you must install the pubs database.

O exemplo a seguir mostra como retornar os 10 primeiros caracteres de cada coluna de dados text e image na tabela pub_info do banco de dados 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. Dados de text são retornados como varchar, e dados de image são retornados 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';  

Aqui está o conjunto de resultados.Here is the result set.

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

(1 row(s) affected)

O exemplo a seguir mostra o efeito de SUBSTRING em dados text e ntext.The following example shows the effect of SUBSTRING on both text and ntext data. Primeiro, este exemplo cria uma nova tabela no banco de dados pubs chamado npub_info.First, this example creates a new table in the pubs database named npub_info. Depois, o exemplo cria a coluna pr_info na tabela npub_info com os primeiros 80 caracteres da coluna pub_info.pr_info e adiciona um ü como o primeiro caractere.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, um INNER JOIN recupera todos os números de identificação de editor e a SUBSTRING das colunas de informações de editor text e 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;  

Exemplos: Azure SQL Data WarehouseAzure SQL Data Warehouse e Parallel Data WarehouseParallel Data WarehouseExamples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

C.C. Usando SUBSTRING com uma cadeia de caracteresUsing SUBSTRING with a character string

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres.The following example shows how to return only a part of a character string. Da tabela dbo.DimEmployee, essa consulta retorna o sobrenome em uma coluna com apenas a primeira inicial na segunda coluna.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;  

Aqui está o conjunto de resultados.Here is the result set.

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

O exemplo a seguir mostra como retornar o segundo, o terceiro e o quarto caracteres da constante de cadeia de caracteres 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;  

Aqui está o conjunto de resultados.Here is the result set.

x
-----
bcd

Consulte TambémSee 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)
Funções de cadeia de caracteres (Transact-SQL)String Functions (Transact-SQL)