View a markdown version of this page

CURRENT_SETTING - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

CURRENT_SETTING

CURRENT_SETTING retorna o valor atual do parâmetro de configuração especificado.

Essa função é equivalente ao comando SHOW.

Sintaxe

current_setting('parameter')

A instrução a seguir retorna o valor atual da variável de contexto de sessão especificada.

current_setting('variable_name')
current_setting('variable_name'[, error_if_undefined])

Argumentos

Parâmetro

Valor de parâmetro a exibir. Para obter uma lista dos parâmetros de configuração, consulte Referência da configuração

variable_name

O nome da variável a ser exibida. Ela deve ser uma constante de string para variáveis de contexto de sessão.

error_if_undefined

(Opcional) Um valor booliano opcional que especifica o comportamento caso o nome da variável não exista. Quando error_if_undefined é definido como TRUE, que é o padrão, o Amazon Redshift lança um erro. Quando error_if_undefined é definido como FALSE, o Amazon Redshift retorna NULL. O Amazon Redshift é compatível com o parâmetro error_if_undefined somente para variáveis de contexto de sessão. Isso não pode ser usado quando a entrada é um parâmetro de configuração.

Tipo de retorno

Retorna uma string CHAR ou VARCHAR.

Exemplos

Para retornar a configuração atual para o parâmetro query_group, use o exemplo a seguir.

SELECT CURRENT_SETTING('query_group');

+-----------------+
| current_setting |
+-----------------+
| unset           |
+-----------------+

Para retornar a configuração atual para a variável app_context.user_id, use o exemplo a seguir.

SELECT CURRENT_SETTING('app_context.user_id', FALSE);