Compartir a través de

Función secret

  • Artículo

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

Extrae un valor de secreto con los scope y key obtenidos del Servicio de secretos de Databricks.

Sintaxis

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 genera INVALID_SECRET_LOOKUP. Para devolver NULL en su lugar, use la función try_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.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: el servicio de secretos de Databricks no está disponible.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: key no se encuentra en scope.

Ejemplos

> 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