Compartilhar via


SUBSTRING (Azure Stream Analytics)

Retorna parte de um caractere ou de um texto.

Syntax

SUBSTRING ( expression, start, length )

Observação

O índice/posição da função SUBSTRING tem base em 1.

Argumentos

expressão

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

start

É uma expressão bigint que especifica onde os caracteres retornados devem iniciar. Se o início é menor que 1, a expressão retornada começa no primeiro caractere que está especificado na expressão. Nesse caso, o número de caracteres que são retornados é o maior valor de soma de início + comprimento -1 ou 0. Se o início é maior que o número de caracteres na expressão de valor, uma expressão de comprimento zero é retornada.

length

É uma expressão bigint positiva que especifica quantos caracteres da expressão são retornados. Se o comprimento é negativo, um erro é gerado e a instrução é 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.

Tipos de retorno

nvarchar(max)

Exemplos

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

Consulte Também