Compartilhar via


Função mask

Aplica-se a:verificação marcada como sim Databricks SQLverificação marcada como sim 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ão STRING.
  • upperChar: um literal de STRING de um único caractere usado para substituir caracteres em maiúscula. O padrão é 'X'. Se upperChar for NULL, os caracteres em maiúscula permanecerão sem máscara.
  • lowerChar: um literal de STRING de um único caractere usado para substituir caracteres em minúscula. O padrão é 'x'. Se lowerChar for NULL, os caracteres em minúscula permanecerão sem máscara.
  • digitChar: um literal de STRING de um único caractere usado para substituir algarismos. O padrão é 'n'. Se digitChar for NULL, os algarismos permanecerão sem máscara.
  • otherChar: um literal de STRING 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-&^ % 서울 Ä