Delen via


try_secret-functie

Van toepassing op:vinkje als ja aan Databricks SQL Preview vinkje als ja aan Databricks Runtime 15.0 en hoger

Extraheert een geheime waarde met de opgegeven scope en key uit de Databricks-geheime service, of NULL als de sleutel niet kan worden opgehaald.

Syntaxis

try_secret ( scope, key )

Argumenten

  • scope: Een constante tekenreeksexpressie die het bereik van het geheim bevat dat moet worden geëxtraheerd. Het bereik is de naamruimte waarin meerdere sleutels zich mogelijk bevinden.
  • key: Een constante tekenreeksexpressie met de sleutel van het geheim dat moet worden geëxtraheerd.

Retouren

A STRING.

Als de sleutel niet kan worden opgehaald, wordt de functie geretourneerd NULL. Als u in plaats daarvan INVALID_SECRET_LOOKUP wilt verhogen, gebruikt u de functie secret().

Gebruik de list_secrets functie om een list van alle geheimen op te halen die de gebruiker mag zien.

Foutvoorwaarden

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: Het key is geen constante tekenreeks.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: Het scope is geen constante tekenreeks.

Voorbeelden

> 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