Partager via

Fonction try_secret

  • Article

S’applique à : coche pour oui Databricks SQL – préversioncoche marquée oui Databricks Runtime 15.0 et ultérieur

Extrait une valeur de secret avec les valeurs de scope et de key auprès du service des secrets Databricks, ou NULL si la clé ne peut pas être récupérée.

Syntaxe

try_secret ( scope, key )

Arguments

  • scope : expression de chaîne constante contenant l’étendue du secret à extraire. L’étendue est l’espace de noms dans lequel plusieurs clés peuvent résider.
  • key : expression de chaîne constante avec la clé du secret à extraire.

Retours

STRING.

Si la clé ne peut pas être récupérée, la fonction retourne NULL. Pour déclencher à la place INVALID_SECRET_LOOKUP, utilisez la fonction secret().

Pour récupérer une liste de tous les secrets que l’utilisateur est autorisé à voir, utilisez la fonction list_secrets.

Conditions d'erreur

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT : le key n’est pas une chaîne constante.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT : le scope n’est pas une chaîne constante.

Exemples

> 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