CURRENT_SETTING

CURRENT_SETTING は、指定された構成パラメータの現在の値を返します。

この関数は、SHOWコマンドに相当します。

構文

current_setting('parameter')

次のステートメントは、指定されたセッションコンテキスト変数の現在の値を返します。

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

引数

parameter

表示するパラメータ値。設定パラメータの一覧については、「設定リファレンス」を参照してください。

variable_name

設定する変数の名前。これは、セッションコンテキスト変数の文字列定数でなければなりません。

error_if_undefined

(オプション) 変数名が存在しない場合の動作を指定するブール値。error_if_undefined がデフォルト値の TRUE に設定されている場合、Amazon Redshift はエラーをスローします。error_if_undefined が FALSE に設定されている場合、Amazon Redshift は NULL を返します。Amazon Redshift は、セッションコンテキスト変数に対してのみ error_if_undefined パラメータをサポートします。これは、入力が設定パラメータの場合には使用できません。

戻り型

文字列 CHAR または VARCHAR を返します。

例

query_group パラメータの現在の設定を返すには、次の例を使用します。

SELECT CURRENT_SETTING('query_group');

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

変数 app_context.user_id の現在の設定を返すには、次の例を使用します。

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