`mask` 函式

發行項
04/18/2024

適用於： 檢查標示為是 Databricks SQL Databricks Runtime 12.2 LTS 和更新版本

傳回輸入 str的遮罩版本。

在 Databricks SQL 和 Databricks Runtime 13.3 LTS 和更新版本中，此函式支援具名參數調用。

語法

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

引數

strSTRING：表達式。
upperChar：用來取代大寫字元的單一字元 STRING 常值。預設值為 'X'。如果 upperChar 為 NULL，則大寫字元會保持未遮罩。
lowerChar：用來取代小寫字元的單一字元 STRING 常值。預設值為 'x'。如果 lowerChar 為 NULL，小寫字元仍保持未遮罩。
digitChar：用來取代數字的單一字元 STRING 常值。預設值為 'n'。如果 digitChar 為 NULL，則數位會保持未遮罩。
otherChar：用來替代任何其他字元的單一字元 STRING 常值。默認值為 NULL，這會讓這些字元保持未遮罩。

傳回

字串。

範例

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