Função secret
Aplica-se a: Versão prévia do SQL do Databricks
Databricks Runtime 11.3 LTS e superior
Extrai um valor secreto com o scope
determinado e key
do serviço secreto do 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.
Retornos
Um STRING
.
Se a chave não puder ser recuperada, a função gerará INVALID_SECRET_LOOKUP.
Para retornar NULL
, use a função try_secret().
Para recuperar uma lista de todos os segredos, o usuário será autorizado a ver o uso da função list_secrets.
Condições de erro
INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT
: okey
não é uma cadeia de caracteres constante.INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT
: oscope
não é uma cadeia de caracteres constante.INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED
: o serviço de segredo do Databricks não está disponível.INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED
: okey
não pode ser encontrado emscope
.
Exemplos
> SELECT * FROM list_secrets();
scope key
------------ ---------------
secrets.r.us theAnswerToLife
> SELECT secret('secrets.r.us', 'theAnswerToLife');
fourtyTwo
> SELECT secret('secrets.r.us', 'WhatIsTheAnswerToLife');
Error: INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED