Função mask
Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e versões posteriores
Retorna uma versão mascarada da entrada str
.
No Databricks SQL e Databricks Runtime 13.3 LTS e superior, essa função dá suporta à invocação de parâmetro nomeado.
Sintaxe
mask(str [, upperChar [, lowerChar [, digitChar [, otherChar ] ] ] ] )
Argumentos
str
: uma expressãoSTRING
.upperChar
: um literal deSTRING
de um único caractere usado para substituir caracteres em maiúscula. O padrão é'X'
. SeupperChar
forNULL
, os caracteres em maiúscula permanecerão sem máscara.lowerChar
: um literal deSTRING
de um único caractere usado para substituir caracteres em minúscula. O padrão é'x'
. SelowerChar
forNULL
, os caracteres em minúscula permanecerão sem máscara.digitChar
: um literal deSTRING
de um único caractere usado para substituir algarismos. O padrão é'n'
. SedigitChar
forNULL
, os algarismos permanecerão sem máscara.otherChar
: um literal deSTRING
de um único caractere usado para substituir qualquer outro caractere. O padrão éNULL
, que deixa esses caracteres sem máscara.
Retornos
Uma STRING.
Exemplos
> SELECT mask('AaBb123-&^ % 서울 Ä');
XxXxnnn-&^ % 서울 X
> SELECT mask('AaBb123-&^ % 서울 Ä', 'Z', 'z', '9', 'X');
ZzZz999XXXXXXXXXZ
> SELECT mask('AaBb123-&^ % 서울 Ä', lowerchar => 'z', otherchar => 'X');
AzBz123XXXXXXXXXÄ
> SELECT mask('AaBb123-&^ % 서울 Ä', otherchar => '?');
AaBb123?????????Ä
> SELECT mask('AaBb123-&^ % 서울 Ä', NULL, NULL, NULL, NULL);
AaBb123-&^ % 서울 Ä