通过

try_secret 函数

  • 项目

适用于：勾选“是” Databricks SQL 预览版 勾选“是” Databricks Runtime 15.0 及更高版本

从 Databricks 机密服务中提取具有给定 scope 和 key 的机密值，如果无法检索密钥，则为 NULL。

语法

try_secret ( scope, key )

参数

  • scope：一个常量字符串表达式，其中包含要提取的机密的范围。 范围是可能存在多个键的命名空间。
  • key：一个常量字符串表达式，其中包含要提取的机密的密钥。

返回

一个 STRING。

如果无法检索密钥，函数将返回 NULL。 若要改为引发 INVALID_SECRET_LOOKUP，请使用 secret() 函数。

若要检索用户有权查看的所有机密的列表，请使用 list_secrets 函数。

错误条件

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT：key 不是常量字符串。
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT：scope 不是常量字符串。

示例

> 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