Função substring

Aplica-se a: SQL do Databricks Runtime do Databricks

Retorna a substring de expr que começa em pos e tem o comprimento len. Essa função é um sinônimo para substr função.

Sintaxe

substring(expr, pos [, len])

substring(expr FROM pos [FOR len] ] )

Argumentos

• expr: Uma expressão BINARY ou STRING.
• pos: uma expressão numérica integral que especifica a posição inicial.
• len: uma expressão numérica integral opcional.

Retornos

Um STRING.

pos é de base 1. Se pos for negativo, o início será determinado pela contagem de caracteres (ou bytes para BINARY) do final.

Se len for menor que 1, o resultado será vazio.

Se len for omitido, a função retornará os caracteres ou os bytes começando com pos.

Exemplos

> SELECT substring('Spark SQL', 5);
 k SQL
> SELECT substring('Spark SQL', -3);
 SQL
> SELECT substring('Spark SQL', 5, 1);
 k
> SELECT substring('Spark SQL' FROM 5);
 k SQL
> SELECT substring('Spark SQL' FROM -3);
 SQL
> SELECT substring('Spark SQL' FROM 5 FOR 1);
 k
> SELECT substring('Spark SQL' FROM -10 FOR 5);
 Spar

Funções relacionadas

• substr função