CURRENT_SETTING

CURRENT_ SETTING renvoie la valeur actuelle du paramètre de configuration spécifié.

Cette fonction est équivalente à la commande SHOW.

Syntaxe

current_setting('parameter')

L’instruction suivante renvoie la valeur actuelle de la variable de contexte de session spécifiée.

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

Arguments

paramètre

Valeur de paramètre à afficher. Pour obtenir la liste des paramètres de configuration, consultez Référence de configuration

variable_name

Nom de la variable à afficher. Il doit s’agir d’une constante de type chaîne pour les variables de contexte de session.

error_if_undefined

(Facultatif) Valeur booléenne qui spécifie le comportement si le nom de la variable n’existe pas. Quand error_if_undefined est défini sur TRUE, sa valeur par défaut, Amazon Redshift génère une erreur. Quand error_if_undefined est défini sur FALSE, Amazon Redshift renvoie NULL. Amazon Redshift prend en charge le paramètre error_if_undefined uniquement pour les variables de contexte de session. Cette valeur ne peut pas être utilisée lorsque l’entrée est un paramètre de configuration.

Type de retour

Renvoie une chaîne CHAR ou VARCHAR.

Exemples

Pour renvoyer le paramètre actuel pour le paramètre query_group, utilisez l’exemple suivant.

SELECT CURRENT_SETTING('query_group');

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

Pour renvoyer le paramètre actuel pour la variable app_context.user_id, utilisez l’exemple suivant.

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