

 从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# CURRENT\$1SETTING
<a name="r_CURRENT_SETTING"></a>

 CURRENT\$1SETTING 返回指定配置参数的当前值。

此函数等效于 [SHOW](r_SHOW.md) 命令。

## 语法
<a name="r_CURRENT_SETTING-synopsis"></a>

```
current_setting('parameter')
```

以下语句返回指定会话上下文变量的当前值。

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

## 参数
<a name="r_CURRENT_SETTING-argument"></a>

 *parameter*   
要显示的参数值。有关配置参数的列表，请参阅[配置参考](cm_chap_ConfigurationRef.md)

 *variable\$1name *   
要显示的变量的名称。对于会话上下文变量，它必须是字符串常量。

 *error\$1if\$1undefined*   
（可选）一个布尔值，该值指定变量名不存在时的行为。当 error\$1if\$1undefined 设置为 `TRUE`（默认值）时，Amazon Redshift 会引发错误。当 error\$1if\$1undefined 设置为 `FALSE` 时，Amazon Redshift 会返回 `NULL`。Amazon Redshift 仅支持将 *error\$1if\$1undefined* 参数用于会话上下文变量。当输入为配置参数时，不能使用此项。

## 返回类型
<a name="r_CURRENT_SETTING-return-type"></a>

返回 `CHAR` 或 `VARCHAR` 字符串。

## 示例
<a name="r_CURRENT_SETTING-example"></a>

要返回 `query_group` 参数的当前设置，请使用以下示例。

```
SELECT CURRENT_SETTING('query_group');

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

要返回变量 `app_context.user_id` 的当前设置，请使用以下示例。

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