Функция 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'. Если upperChar есть NULL, верхний регистр символов остается незамеченным.
  • lowerChar: один символьный STRING литерал, используемый для замены символов нижнего регистра. Значение по умолчанию — 'x'. Если lowerChar это NULL, символы нижнего регистра остаются незамеченными.
  • digitChar: один символьный STRING литерал, используемый для замены цифр. Значение по умолчанию — 'n'. Если digitChar это NULL, цифры остаются незамеченными.
  • 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-&^ % 서울 Ä

-- Replacement characters must be single characters
> SELECT mask('AbCD123-@$#', 'Qa');
  Error: DATATYPE_MISMATCH.INPUT_SIZE_NOT_ONE
  • Last updated on