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 函式來獲取 list。
錯誤條件
-
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