SUBSTRING (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de análise do SQLWarehouse no Microsoft Fabric

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

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe para SQL Server.

SUBSTRING ( expression , start , length )

Sintaxe para o Banco de Dados SQL do Azure, a Instância Gerenciada de SQL do Azure, o Azure Synapse Analytics, o PDW (Analytics Platform System) e o ponto de extremidade de análise de WAREHOUSE e SQL no Microsoft Fabric.

SUBSTRING ( expression , start [ , length ] )

Argumentos

expressão

Um caractere, binário, texto, ntext ou expressãode imagem.

começar

Uma expressão inteira ou bigint que especifica onde os caracteres retornados começam. (A numeração é baseada em 1, ou seja, o primeiro caractere da expressão é 1). Se a inicialização for menor que 1, a expressão retornada começará no primeiro caractere especificado na expressão. Nesse caso, o número de caracteres retornados é o maior valor da soma do + inicial - 1 ou 0. Se start for maior que o número de caracteres na expressão de valor, uma expressão de comprimento zero será retornada.

comprimento

Uma expressão inteira ou bigint positiva que especifica quantos caracteres da expressão são retornados. Se lenght for negativo, um erro será gerado e a instrução será encerrada. 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. Se o comprimento for omitido, todos os caracteres da posição inicial até o final da expressão serão retornados.

Você pode usar a subcadeia de caracteres com um argumento de comprimento opcional no Banco de Dados SQL do Azure, na Instância Gerenciada de SQL do Azure, no Azure Synapse Analytics, no PDW (Analytics Platform System) e no ponto de extremidade de análise do Warehouse e do SQL no Microsoft Fabric. No entanto, se você usar NULL por comprimento, SUBSTRING retornará NULL. Revisão E. Use SUBSTRING com argumento de comprimento opcional para um exemplo.

Tipos de retorno

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

Comentários

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.

A expressão deve ser varchar(max) ou varbinary(max) quando o início ou o comprimento contiver um valor maior que 2.147.483.647.

Caracteres complementares (pares alternativos)

Quando você usa ordenações de caractere suplementar (SC), tanto o início quanto o comprimento contam cada par substituto na expressão como um único caractere. Para obter mais informações, consulte Suporte de agrupamento e unicode.

Exemplos

a. Usar SUBSTRING com uma cadeia de caracteres

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres. 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.

SELECT name,
       SUBSTRING(name, 1, 1) AS Initial,
       SUBSTRING(name, 3, 2) AS ThirdAndFourthCharacters
FROM sys.databases
WHERE database_id < 5;

Veja a seguir o conjunto de resultados.

Para exibir o segundo, o terceiro e o quarto caracteres da constante abcdefde cadeia de caracteres, use a consulta a seguir.

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

Veja a seguir o conjunto de resultados.

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

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

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. Dados de text são retornados como varchar, e dados de image são retornados como varbinary.

USE pubs;
GO

SELECT pub_id,
       SUBSTRING(logo, 1, 10) AS logo,
       SUBSTRING(pr_info, 1, 10) AS pr_info
FROM pub_info
WHERE pub_id = '1756';

Veja a seguir o conjunto de resultados.

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

O exemplo a seguir mostra o efeito dos dados de SUBSTRINGtexto 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 editor e a SUBSTRING das colunas de informações de editor 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 FOREIGN KEY
        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 AS pr
     INNER JOIN npub_info AS npr
         ON pr.pub_id = npr.pub_id
ORDER BY pr.pub_id ASC;

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

C. Usar SUBSTRING com uma cadeia de caracteres

O exemplo a seguir mostra como retornar somente uma parte de uma cadeia de caracteres. dbo.DimEmployee Na tabela, essa consulta retorna o nome da família 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;

Veja a seguir o conjunto de resultados.

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.

USE ssawPDW;

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

Veja a seguir o conjunto de resultados.

x
-----
bcd

D. Usar SUBSTRING com NULL argumento de comprimento

SELECT SUBSTRING('123abc', 4, NULL) AS [NULL length];

Veja a seguir o conjunto de resultados.

NULL length
-----------
NULL

E. Usar SUBSTRING com argumento de comprimento opcional

Aplica-se a: Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure, Análise do Azure Synapse, PDW (Analytics Platform System) e ponto de extremidade de análise de WAREHOUSE e SQL no Microsoft Fabric

O exemplo a seguir mostra como retornar apenas uma parte de uma cadeia de caracteres de uma determinada posição inicial. Como o argumento de comprimento não é fornecido, o comprimento é padrão para retornar os caracteres restantes na cadeia de caracteres.

SELECT SUBSTRING('123abc', 4) AS y;

Veja a seguir o conjunto de resultados.

y
-----
abc

F. Usar SUBSTRING sem um argumento de comprimento para encontrar partes de substituição no inventário AdventureWorks2022

USE AdventureWorks2022;
GO

SELECT [ProductDescriptionID],
       [Description],
       SUBSTRING([Description], LEN('Replacement') + 1) AS [Replacement-Part]
FROM [Production].[ProductDescription]
WHERE [Description] LIKE 'Replacement%';

Veja a seguir o conjunto de resultados.

Conteúdo relacionado

• ESQUERDA (Transact-SQL)
• LTRIM (Transact-SQL)
• DIREITA (Transact-SQL)
• RTRIM (Transact-SQL)
• STRING_SPLIT (Transact-SQL)
• GUARNIÇÃO (Transact-SQL)
• Funções de cadeia de caracteres (Transact-SQL)