Função split
Aplica-se a: SQL do Databricks Runtime do Databricks
Divide str
em ocorrências que correspondam à regex
e retorna uma matriz com um comprimento de no máximo limit
.
Sintaxe
split(str, regex [, limit] )
Argumentos
str
: uma expressãoSTRING
a ser dividida.regexp
: uma expressãoSTRING
que é uma expressão regular Java usada para dividirstr
.limit
: uma expressão opcional padrãoINTEGER
como 0 (sem limite).
Retornos
Um ARRAY<STRING>
.
Se limit
> 0: o comprimento da matriz resultante não será maior que limit
, e a última entrada da matriz resultante conterá toda a entrada além do último regex
correspondente.
Se limit
<= 0: regex
será aplicado o máximo de vezes possível e a matriz resultante pode ser de qualquer tamanho.
Exemplos
> SELECT split('oneAtwoBthreeC', '[ABC]');
[one,two,three,]
> SELECT split('oneAtwoBthreeC', '[ABC]', -1);
[one,two,three,]
> SELECT split('oneAtwoBthreeC', '[ABC]', 2);
[one,twoBthreeC]
> SELECT split('oneAtwoBthreeC' COLLATE UTF8_BINARY, '[abc]');
[oneAtwoBthreeC]
> SELECT split('oneAtwoBthreeC' COLLATE UTF8_LCASE, '[abc]');
[one,two,three,]