Поделиться через

Функция secret

Область применения:отмечено 'Да' Databricks SQL предварительная версия отмечено 'Да' Databricks Runtime 11.3 LTS и выше

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

Синтаксис

secret ( scope, key )

Аргументы

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

Возвраты

STRING.

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

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

Условия ошибок

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: key не является константной строкой.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: scope не является константной строкой.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: секретная служба Databricks недоступна.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: scope не удается найти key в пределах.

Примеры

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

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

> SELECT secret('secrets.r.us', 'WhatIsTheAnswerToLife');
  Error: INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED