Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

UNSET

Remove uma variável de sessão ou limpa a configuração em tempo de execução definida com SET para a sessão atual. Disponível a partir do StackQL v1.0.

Veja também:
[SET] [ Variáveis de sessão ] [ Sessões de provider ]


Sintaxe​

unsetStatement::=

UNSETSESSIONvariableNameconfigurationPath','variableNameconfigurationPath';'

 
 

UNSET [ SESSION ] <target> [, <target> ...];

target
Qualquer alvo aceito por SET: um nome de variável simples ou entre aspas duplas, ou um caminho de configuração entre aspas duplas e prefixado com cifrão.

SESSION
Opcional, e o único escopo que existe: UNSET SESSION name e UNSET name são a mesma instrução, porque toda variável e toda configuração pertencem à sessão atual. UNSET GLOBAL é rejeitado com configuration scope "global" is not supported; use SESSION.

UNSET name equivale a SET name = DEFAULT. Os alvos de uma lista são removidos em ordem, e remover um nome que não está definido não é um erro. Desreferenciar uma variável depois que ela foi removida falha antes que qualquer solicitação seja feita ao provider.

AlvoEfeito
nameRemove a variável de sessão.
"$.auth.<provider>.<field>"Exclui esse campo do contexto de autenticação da sessão do provider. O valor em vigor antes da substituição não é restaurado.
"$.providers.<alias>"Remove a vinculação do alias do provider.
"$.secrets.<name>"Exclui o segredo do repositório da sessão. Para um repositório persistente do sistema operacional, isso exclui o valor armazenado.
"$.secret_store"Descarta a vinculação atual do repositório e começa com uma memória de sessão vazia. Os valores já persistidos em um repositório do sistema operacional não são excluídos.

Exemplos​

Remover uma variável​

A variável é removida da sessão, então a consulta comentada falha com variable "$region" is not defined em vez de ser executada com um valor desatualizado ou vazio. Defina o nome novamente para reutilizá-lo.

SET region = 'ap-southeast-2';
UNSET region;

/*
SELECT name FROM aws.s3.buckets WHERE region = $region;
-- FAILS with variable "$region" is not defined
*/

Remover vários alvos​

Uma instrução pode remover variáveis e caminhos de configuração ao mesmo tempo, e os alvos são processados em ordem. Aqui, uma variável simples, uma variável com um nome com pontos e uma substituição de credencial são removidas em uma única lista.

UNSET region, "providers.saved", "$.auth.github.credentialsenvvar";

Tornar explícito o escopo da sessão​

Estas duas instruções fazem a mesma coisa: SESSION nomeia o único escopo que existe. A forma explícita é adequada para scripts que também são executados em bancos de dados que distinguem o estado da sessão do estado global. A instrução comentada falha porque não existe estado compartilhado.

UNSET region;
UNSET SESSION region;

/*
UNSET GLOBAL region;
-- FAILS with configuration scope "global" is not supported; use SESSION
*/

Limpar uma substituição de credencial​

O campo definido anteriormente com SET "$.auth.github.credentialsenvvar" é excluído do contexto de autenticação da sessão do provider do GitHub, e os outros campos desse contexto não são alterados. O valor em vigor antes da substituição não é restaurado, então defina o campo novamente se o provider ainda precisar dele.

UNSET "$.auth.github.credentialsenvvar";

Remover um alias de provider e seu segredo​

O alias production foi vinculado com SET "$.providers.production" e faz referência, por meio de auth_secret, a um segredo armazenado em $.secrets.production. Remover os dois em uma única instrução desfaz a vinculação, de modo que production.s3.buckets deixa de ser uma relação válida, e exclui o segredo do repositório da sessão. SESSION é opcional aqui, como em todos os lugares.

UNSET SESSION "$.providers.production", "$.secrets.production";