Compartir a través de

Función try_secret

  • Artículo

Se aplica a: casilla marcada como Sí versión preliminar de Databricks SQL casilla marcada como Sí Databricks Runtime 15.0 LTS y versiones posteriores

Extrae un valor de secreto con los scope y key obtenidos del servicio de secretos de Databricks o NULL si la clave no se puede recuperar.

Sintaxis

try_secret ( scope, key )

Argumentos

  • scope: expresión de cadena constante que contiene el ámbito del secreto que se va a extraer. El ámbito es el espacio de nombres en el que pueden residir varias claves.
  • key: expresión de cadena constante con la clave del secreto que se va a extraer.

Devoluciones

STRING.

Si la clave no se puede recuperar, la función devuelve NULL. Para generar INVALID_SECRET_LOOKUP en su lugar, use la función secret().

Para obtener una lista de todos los secretos que el usuario está autorizado a ver, use la función list_secrets.

Condiciones de error

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: key no es una cadena constante.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: scope no es una cadena constante.

Ejemplos

> 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