CURRENT_SETTING - Amazon Redshift

自 2025 年 11 月 1 日起,Amazon Redshift 將不再支援建立新的 Python UDFs。如果您想要使用 Python UDFs,請在該日期之前建立 UDFs。現有的 Python UDFs將繼續如常運作。如需詳細資訊,請參閱部落格文章

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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

(選用) Boolean 值,指定變數名稱不存在時的行為。當 error_if_undefined 設定為 TRUE (這是預設設定),Amazon Redshift 擲回錯誤。當 error_if_undefined 設定為 FALSE,Amazon Redshift 傳回 NULL。Amazon Redshift 僅支援工作階段內容變數的 error_if_undefined 參數。當輸入是組態參數時,不能使用此選項。

傳回類型

傳回 CHARVARCHAR 字串。

範例

若要傳回 query_group 參數的目前設定,請使用下列範例。

SELECT CURRENT_SETTING('query_group'); +-----------------+ | current_setting | +-----------------+ | unset | +-----------------+

若要傳回變數 app_context.user_id 的目前設定,請使用下列範例。

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