次の方法で共有

try_secret 関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL プレビュー Databricks Runtime 15.0 以上

Databricks シークレット サービスから指定した 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