SUBSTRATO

✅ Azure Stream Analytics ✅ Fabric Eventstream

Retorna parte de um caractere ou texto.

Sintaxe

SUBSTRING ( expression, start, length )

Observação

O índice/posição para a função SUBSTRING é baseado em 1.

Argumentos

expressão

É uma expressão de caractere ou uma coluna do tipo nvarchar(max).

começar

É uma expressão bigint que especifica onde os caracteres retornados começam. Se start 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 de início + comprimento- 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 bigint positiva que especifica quantos caracteres da expressão serão retornados. Se o comprimento for negativo, um erro será gerado e a instrução será encerrada. Se a soma de início e comprimento for maior que o número de caracteres na expressão, toda a expressão de valor que começa no início será retornada.

Tipos de devolução

nvarchar (máx.)

Exemplos

SELECT
    'abcdefg' AS x,
    SUBSTRING('abcdefg',2,4) AS substringX
FROM Input

x	substringX
ABCDEFG	BCDE

Ver também

• ESQUERDA
• DIREITO