SUBSTRING (Transact-SQL)

 

Publicado: dezembro de 2016

ESTE TÓPICO APLICA-SE A: simSQL Server (começando com o 2008)simBanco de Dados SQL do AzuresimAzure SQL Data Warehouse simParallel Data Warehouse

Retorna parte de uma expressão de caractere, binária, de texto ou de imagem no SQL Server.

Topic link icon Convenções de sintaxe Transact-SQL

-- Syntax for SQL Server, Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse  
  
SUBSTRING ( expression ,start , length )  

expressão
É um caracteres, binário, texto, ntext, ou imagemexpressão.

Iniciar
É um número inteiro ou bigint expressão que especifica onde os caracteres retornados devem iniciar. (A numeração é 1 com base, significando que o primeiro caractere na expressão é 1). Se Iniciar for menor que 1, a expressão retornada começará no primeiro caractere que é especificado no expressão. Nesse caso, o número de caracteres que são retornados é o maior valor de soma de Iniciar + comprimento- 1 ou 0. Se Iniciar é maior que o número de caracteres na expressão de valor, uma expressão de comprimento zero será retornada.

comprimento
É um inteiro positivo ou bigint que especifica quantos caracteres da expressão de expressão será retornado. Se comprimento é negativo, um erro será gerado e a instrução é encerrada. Se a soma de Iniciar e comprimento é maior que o número de caracteres em expressão, a expressão de valor inteiro, começando no Iniciar é retornado.

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

Expressão especificadaTipo de retorno
char/varchar/textovarchar
nchar/nvarchar/ntextnvarchar
binário/varbinary/imagemvarbinary

Os valores para Iniciar e comprimento deve ser especificado em número de caracteres para ntext, char, ou varchar tipos de dados e bytes para texto, imagem, binário, ou varbinary tipos de dados.

O expressão deve ser varchar (max) ou varbinary (max) quando o Iniciar ou comprimento contém um valor maior que 2147483647.

Ao usar agrupamentos de caracteres suplementares (SC), ambos Iniciar e comprimento contarão cada par substituto expressão como um único caractere. Para obter mais informações, consulte Collation and Unicode Support.

A. Usando SUBSTRING com uma cadeia de caracteres

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres. Do sys.databases tabela, esta consulta retorna o sistema de nomes de banco de dados na primeira coluna, a primeira letra do banco de dados na segunda coluna e os terceiro e quarto caracteres na coluna final.

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.

nameInicialThirdAndFourthCharacters
mestremST
tempdbtpacote de gerenciamento
modelomde
msdbmbanco de dados

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 dados de texto, ntext e de imagem

System_CAPS_ICON_note.jpg Observação


Para executar os exemplos a seguir, você deve instalar o pubs banco de dados.

O exemplo a seguir mostra como retornar os 10 primeiros caracteres de cada um texto e imagem coluna de dados no pub_info tabela do pubs banco de dados. texto dados são retornados como varchar, e imagem dados 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 da subcadeia de CARACTERES nos dois texto e ntext dados. 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 fim, um INNER JOIN recupera todos os números de identificação do Editor e o SUBSTRING de ambos os texto e ntext colunas de informações do publicador.

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;  

C. Usando SUBSTRING com uma cadeia de caracteres

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

-- 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.

LastName Initial

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

Barbariol A

Barber D

Barreto de Mattos P

O exemplo a seguir mostra como retornar o segundo, terceiro e quarto caracteres da constante de cadeia de caracteres abcdef.

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

Aqui está o conjunto de resultados.

x

-----

bcd

Funções de cadeia de caracteres & #40. O Transact-SQL e 41;

Contribuições da comunidade

ADICIONAR
Mostrar: