- 类别:
:doc:`/sql-reference/functions-system`(信息)
SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND¶
返回通过先前调用 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 所设置的列的列表。
有关更多信息,请参阅 处理 SHOW 命令输出和 Snowflake 视图中的新列。
- 另请参阅:
SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND、SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND、SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES
语法¶
SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
'<object_type>'
)
实参¶
'object_type'SHOW 命令的对象类型。例如,对于 SHOW TABLES 命令,请指定
'TABLES'。对于 SHOW NOTIFICATION INTEGRATIONS 命令,请指定'NOTIFICATION INTEGRATIONS'。
返回¶
返回一个 VARCHAR 值,其中包含前次调用 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 所指定的列的逗号分隔列表。列名称为小写。
如果未调用 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND,或者如果调用 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 以清除列的列表,该函数会返回一个空字符串。
访问控制要求¶
只有账户管理员(被授予 ACCOUNTADMIN 角色的用户)可以调用此函数。
示例¶
以下示例返回通过前次调用 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 为 SHOW TABLES 命令指定的列的列表:
SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
'TABLES'
);
+-------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND( |
| 'TABLES' |
| ) |
|-------------------------------------------------------|
| name,database_name,kind,comment |
+-------------------------------------------------------+
如果未调用 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND,或者如果调用 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND 以清除列表,该函数会返回一个空字符串:
SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
'TABLES'
);
SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
'TABLES'
);
+-------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND( |
| 'TABLES' |
| ) |
|-------------------------------------------------------|
| |
+-------------------------------------------------------+