適用於:
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_CONSTANTkey:不是常數位串。 -
INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANTscope:不是常數位串。
範例
> 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