Condividi tramite

Funzione try_secret

  • Articolo

Si applica a: segno di spunta sì Databricks SQL preview segno di spunta sì Databricks Runtime 15.0 e versioni successive

Estrae un valore segreto con il servizio segreto specificato scope e key dal servizio segreto Databricks o NULL se la chiave non può essere recuperata.

Sintassi

try_secret ( scope, key )

Argomenti

  • scope: espressione stringa costante contenente l'ambito del segreto da estrarre. L'ambito è lo spazio dei nomi in cui possono risiedere più chiavi.
  • key: espressione stringa costante con la chiave del segreto da estrarre.

Valori restituiti

Un oggetto STRING.

Se la chiave non può essere recuperata, la funzione restituisce NULL. Per generare INVALID_SECRET_LOOKUP, usare invece la funzione secret().

Per recuperare un elenco di tutti i segreti, l'utente è autorizzato a visualizzare l'uso della funzione list_secrets .

Condizioni di errore

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANTkey: non è una stringa costante.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANTscope: non è una stringa costante.

Esempi

> 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