try_secret Função

Aplica-se a: Visualização do Databricks SQL Databricks Runtime 15.0 e superior

Extrai um valor secreto utilizando o scope e o key fornecidos do serviço secreto Databricks, ou NULL caso a chave não seja possível de recuperar.

Sintaxe

try_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

Um STRING.

Se a chave não puder ser recuperada, a função retornará NULL. Para lançar INVALID_SECRET_LOOKUP em vez disso, use a função secret().

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.

Exemplos

> 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

Funções relacionadas

• list_secrets função de tabela
• secret Função