Sdílet prostřednictvím

Funkce secret

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL Preview zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

Extrahuje hodnotu tajného kódu s danou scope a key z tajné služby Databricks.

Syntaxe

secret ( scope, key )

Argumenty

  • scope: Konstantní řetězcový výraz obsahující obor tajného klíče, který se má extrahovat. Obor je obor názvů, ve kterém se může nacházet více klíčů.
  • key: Konstantní řetězcový výraz s klíčem tajného klíče, který se má extrahovat.

Návraty

Úloha STRING.

Pokud klíč nelze načíst, funkce vyvolá INVALID_SECRET_LOOKUP. NULL Místo toho použijte funkci try_secret().

K načtení seznamu všech tajných kódů má uživatel oprávnění k zobrazení funkce list_secrets .

Chybové podmínky

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: Nejedná se key o konstantní řetězec.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: Nejedná se scope o konstantní řetězec.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Tajná služba Databricks není k dispozici.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: Nelze key nalézt v souboru scope.

Příklady

> 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