mask 函数

适用于: 勾选“是” Databricks SQL 勾选“是” Databricks Runtime 12.2 LTS 及更高版本

返回输入 str 的掩码版本。

在 Databricks SQL 和 Databricks Runtime 13.3 LTS 及更高版本中,此函数支持命名参数调用

语法

mask(str [, upperChar [, lowerChar [, digitChar [, otherChar ] ] ] ] )

参数

  • str:一个 STRING 表达式。
  • upperChar:用于替换大写字符的单字符 STRING 文本。 默认为 'X'。 如果 upperCharNULL,则大写字符保持未掩码状态。
  • lowerChar:用于替换小写字符的单字符 STRING 文本。 默认为 'x'。 如果 lowerCharNULL,则小写字符保持未掩码状态。
  • digitChar:用于替换数字的单字符 STRING 文本。 默认为 'n'。 如果 digitCharNULL,则数字保持未掩码状态。
  • otherChar:用于替换任何其他字符的单字符 STRING 文本。 默认值为 NULL,即使这些字符保持未掩码状态。

返回

一个 STRING。

示例

> 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-&^ % 서울 Ä