카테고리:

시스템 함수 (제어)

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND

SHOW <오브젝트> 명령이 실행된 경우 반환되어야 하는 열을 제어합니다.

SHOW COMMAND에 새 열이 도입되어 결과의 고정 수 또는 열 순서에 따라 달라지는 스크립트 또는 코드에 문제가 발생하는 경우 이 함수를 호출할 수 있습니다. SHOW 명령 출력 및 Snowflake 뷰에서 새 열 처리하기 섹션을 참조하십시오.

참고 항목:

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND , SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND , SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

구문

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  '<object_type>',
  '<list_of_columns>'
)
Copy

인자

'object_type'

SHOW 명령에 대한 오브젝트 유형입니다. 예를 들어, SHOW TABLES 명령의 경우 ``’TABLES’``를 지정합니다. SHOW NOTIFICATION INTEGRATIONS 명령의 경우 ``’NOTIFICATION INTEGRATIONS’``를 지정합니다.

list_of_columns

SHOW 명령의 출력에서 반환되어야 하는 쉼표로 구분되거나 공백으로 구분된 열 목록입니다.

열 이름은 대문자, 소문자 또는 대소문자 혼합으로 지정할 수 있습니다.

모든 열을 반환하려면 빈 문자열을 지정하거나 :doc:`system_unset_default_columns_override_for_show_command`를 호출합니다.

반환

작업이 성공한 경우 TRUE를 반환합니다.

액세스 제어 요구 사항

계정 관리자(ACCOUNTADMIN 역할이 부여된 사용자)만 이 함수를 호출할 수 있습니다.

다음 예제에서는 name, database_name, kind, comment 열만 반환하도록 SHOW TABLES 명령을 구성합니다.

SELECT SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SHOW_COMMAND(
  'TABLES',
  'name, database_name, kind, comment'
);
Copy

SHOW TABLES 명령을 실행하면 지정된 열만 반환합니다.

SHOW TABLES;
Copy
+------------------+---------------+-------+---------+
| name             | database_name | kind  | comment |
|------------------+---------------+-------+---------|
| DEPARTMENT_TABLE | MY_DB         | TABLE |         |
| EMPLOYEE_TABLE   | MY_DB         | TABLE |         |
+------------------+---------------+-------+---------+

SHOW TERSE TABLES 명령을 실행하면 ``comment``를 제외하고 지정된 열만 반환하며, TERSE를 지정하는 경우 일반적으로 반환되지 않습니다.

SHOW TERSE TABLES;
Copy
+------------------+-------+---------------+
| name             | kind  | database_name |
|------------------+-------+---------------|
| DEPARTMENT_TABLE | TABLE | MY_DB         |
| EMPLOYEE_TABLE   | TABLE | MY_DB         |
+------------------+-------+---------------+