Функция try_secret

Область применения: Databricks SQL preview Databricks Runtime 15.0 и выше

Извлекает значение секрета с заданным scope и key из секретного сервиса Databricks, или NULL, если ключ извлечь не удается.

Синтаксис

try_secret ( scope, key )

Аргументы

• scope: константное строковое выражение, содержащее область извлекаемого секрета. Область — это пространство имен, в котором могут находиться несколько ключей.
• key: константное строковое выражение с ключом секрета, который необходимо извлечь.

Возвраты

STRING.

Если ключ не может быть получен, функция возвращается NULL. Чтобы создать INVALID_SECRET_LOOKUP вместо этого, используйте функцию secret().

Чтобы получить список всех секретов, пользователь может просмотреть функцию list_secrets .

Распространенные условия ошибки

• INVALID_SECRET_LOOKUP

Примеры

> SELECT * FROM list_secrets();
  scope         key
  ------------  ---------------
  secrets.r.us  theAnswerToLife

> SELECT try_secret('secrets.r.us', 'theAnswerToLife');
  fourtyTwo

> SELECT try_secret('secrets.r.us', 'WhatIsTheAnswerToLife');
  NULL

Связанные функции

• list_secrets табличная функция
• secret функция