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
- parameter
-
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 comoFALSE
, o Amazon Redshift retornaNULL
. 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);