共用方式為


try_secret函式

適用於:已勾選是 Databricks SQL 預覽 已勾選是 Databricks Runtime 15.0 和更新版本

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