list_secrets 表函数

适用于: 勾选“是” Databricks SQL 预览版 勾选“是” Databricks Runtime 11.3 LTS 及更高版本

返回所有范围中的所有密钥或用户有权从 Databricks 机密服务查看的特定范围。

语法

list_secrets ( [ scopeStr ] )

参数

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

  • scopeStr:要在其中搜索的范围。 如果未提供,则返回所有范围。

返回

一个表,其中包含两个列:

  • scope STRING NOT NULL:密钥的命名空间。
  • key STRING NOT NULL:密钥本身

若要返回特定密钥的机密值,请使用 secret(scope, key)

错误条件

  • INVALID_SECRET_LOOKUP.LIST_SECRETS_FAILED:Databricks 机密服务不可用。

示例

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

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

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