SUBSTRING (Transact-SQL)

Retorna parte de uma expressão de caractere, binária, de texto ou de imagem. Para obter mais informações sobre os tipos de dados válidos do SQL Server que podem ser usados com esta função, consulte Tipos de dados (Transact-SQL).

Convenções de sintaxe Transact-SQL

Sintaxe

SUBSTRING (value_expression ,start_expression ,length_expression )

Argumentos

• value_expression
  É uma expressão de character, binary, text, ntext ou image.

• start_expression
  É um inteiro ou uma expressão bigint que especifica onde os caracteres retornados devem iniciar. Se start_expression for menos que 1, a expressão retornada começará no primeiro caractere especificado em value_expression. Nesse caso, o número de caracteres que são retornados é o valor maior da soma de start_expression + length_expression – 1 ou 0. Se start_expression for maior que o número de caracteres na expressão de valor, uma expressão de comprimento zero será retornada.

• length_expression
  É um inteiro positivo ou uma expressão bigint que especifica quantos caracteres da value_expression são retornados. Se length_expression for negativo, um erro será gerado e a instrução será encerrada. Se a soma de start_expression e de length_expression for maior do que o número de caracteres de value_expression, a expressão de valor inteira iniciada em start_expression será retornada.

Tipos de retorno

Retorna dados de caractere se expression for um dos tipos de dados de caractere com suporte. Retorna dados binários se expression for um dos tipos de dados binary com suporte. A cadeia de caracteres retornada é do mesmo tipo que a expressão especificada com as exceções mostradas na tabela.

Expressão especificada	Tipo de retorno
char/varchar/text	varchar
nchar/nvarchar/ntext	nvarchar
binary/varbinary/image	varbinary

Comentários

Os valores para start_expression e length_expression devem ser especificados em número de caracteres para os tipos de dados ntext, char ou varchar e em bytes para os tipos de dados text, image, binary ou varbinary.

value_expression deve ser varchar(max) ou varbinary(max) quando start_expression ou length_expression contém um valor maior que 2147483647.

Observação
Os níveis de compatibilidade podem afetar os valores de retorno. Para obter mais informações sobre níveis de compatibilidade, consulte Nível de compatibilidade de ALTER DATABASE (Transact-SQL).

Exemplos

A. Usando SUBSTRING com uma cadeia de caracteres

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres. Da tabela Person, essa consulta retorna o sobrenome em uma coluna com apenas a primeira inicial na segunda coluna.

USE AdventureWorks2008R2;
GO
SELECT LastName, SUBSTRING(FirstName, 1, 1) AS Initial
FROM Person.Person
WHERE LastName like 'Barl%'
ORDER BY LastName;

Aqui está o conjunto de resultados.

LastName       Initial

-------------- -------

Barley         R

Barlow         B

(2 row(s) affected)

Veja como exibir o segundo, terceiro e quarto caracteres da constante de cadeia de caracteres abcdef.

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

Aqui está o conjunto de resultados.

x

----------

bcd

(1 row(s) affected)

B. Usando SUBSTRING com texto, ntext e dados de imagem

Observação
Para executar os exemplos a seguir, instale o banco de dados pubs. Para obter informações sobre como instalar o banco de dados pubs, consulte Baixando os bancos de dados de exemplo Northwind e pubs.

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

Aqui está o conjunto de resultados.

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. Primeiro, este exemplo cria uma nova tabela no banco de dados pubs chamado 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. Por último, um INNER JOIN recupera todos os números de identificação de publicador e a SUBSTRING das colunas de informações de publicador text e 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;

Consulte também

Referência

Funções de seqüência de caracteres (Transact-SQL)