Condividi tramite

Funzione secret

  • Articolo

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

Estrae un valore segreto con il scope specificato e key dal servizio segreto Databricks.

Sintassi

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 genera INVALID_SECRET_LOOKUP. Per restituire NULL invece, usare la funzione try_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.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: il servizio segreto databricks non è disponibile.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: non è possibile trovare l'oggetto key all'interno di scope.

Esempi

> 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