Compartilhar via


Função substring

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

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

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