分享方式：

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 函式的所有秘密清單。

錯誤條件

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANTkey：不是常數位串。
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANTscope：不是常數位串。
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED:D atabricks 秘密服務無法使用。
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILEDkey：在 中scope找不到 。

範例

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

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

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