secret函式

適用於:核取記號為「是」 Databricks SQL 預覽 核取記號為「是」 Databricks Runtime 11.3 LTS 和更新版本

使用指定的 scope和 key從 Databricks 祕密服務擷取祕密值。

語法

secret ( scope, key )

引數

  • scope:常數位串表示式,包含要擷取之秘密的範圍。 範圍是多個索引鍵可能所在的命名空間。
  • key:具有要擷取之秘密索引鍵的常數位符串表達式。

退貨

STRING。

如果無法擷取索引鍵,函式會 引發INVALID_SECRET_LOOKUP。 若要改為傳回 NULL ,請使用 try_secret() 函式。

若要獲取使用者有權查看的所有秘密,可以使用 list_secrets 函式。

備註

Azure Databricks 會盡力從原始輸出中刪除秘密。 如需詳細資訊,請參閱祕密修訂。

常見錯誤條件

範例

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

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

> SELECT secret('secrets.r.us', 'WhatIsTheAnswerToLife');
  Error: INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED