Partilhar via


Função secret

Aplica-se a: Marque Sim Databricks SQL preview Marque Sim Databricks Runtime 11.3 LTS e superior

Extrai um valor secreto com o dado scope e key do serviço secreto Databricks.

Sintaxe

secret ( scope, key )

Argumentos

  • scope: Uma expressão de cadeia de caracteres constante que contém o escopo do segredo a ser extraído. O escopo é o namespace no qual várias chaves podem residir.
  • key: Uma expressão de cadeia de caracteres constante com a chave do segredo a ser extraído.

Devoluções

A STRING.

Para recuperar uma lista de todos os segredos que o usuário está autorizado a ver, use a função list_secrets .

Condições de erro

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: O key não é uma cadeia de caracteres constante.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: O scope não é uma cadeia de caracteres constante.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: O serviço secreto Databricks não está disponível.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: O key não pode ser encontrado em scope.

Exemplos

> SELECT * FROM list_secrets();
  scope         key
  ------------  ---------------
  secrets.r.us  theAnswerToLife

> SELECT secret('secrets.r.us', 'theAnswerToLife');
  fourtyTwo