SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT

지정된 Snowflake 뷰(예: 특정 ACCOUNT_USAGE, ORGANIZATION_USAGE, READER_ACCOUNT_USAGE 또는 INFORMATION_SCHEMA 뷰) 또는 이 스키마 중 하나의 내장 테이블 함수에 대해 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT에 대한 이전 호출로 설정된 열 목록을 반환해요.

자세한 내용은 SHOW 명령 출력, Snowflake 뷰, 테이블 함수에서 새 열 처리를 참고하세요.

출처: Snowflake SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 함수 문서

본문

참고 항목: SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT, SYSTEM$GET_ALL_DEFAULT_COLUMNS_OVERRIDES

구문 (Syntax)

SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  '<object_type>',
  '<database_name>',
  '<schema_name>',
  '<object_name>'
)

인자 (Arguments)

  • 'object_type' — 객체의 유형이에요. Snowflake 뷰의 경우 'VIEW', 내장 테이블 함수의 경우 'FUNCTION'을 지정해요.
  • 'database_name' — 객체를 포함하는 데이터베이스의 이름이에요. 뷰의 경우 'SNOWFLAKE'를 지정하거나, INFORMATION_SCHEMA 뷰의 경우 빈 문자열을 지정해요. 테이블 함수의 경우 INFORMATION_SCHEMA 테이블 함수는 빈 문자열을, ACCOUNT_USAGE, ORGANIZATION_USAGE 또는 READER_ACCOUNT_USAGE 테이블 함수는 'SNOWFLAKE'를 지정해요.
  • 'schema_name' — 객체를 포함하는 스키마의 이름이에요. 뷰의 경우 SNOWFLAKE 데이터베이스의 스키마 이름이나 'INFORMATION_SCHEMA'를 지정해요. 테이블 함수의 경우 'INFORMATION_SCHEMA', 'ACCOUNT_USAGE', 'ORGANIZATION_USAGE', 'READER_ACCOUNT_USAGE'처럼 이를 포함하는 스키마의 이름을 지정해요.
  • 'object_name' — 객체의 이름이에요.

반환 값 (Returns)

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT에 대한 이전 호출로 지정된 열의 쉼표로 구분된 목록을 포함하는 VARCHAR 값을 반환해요. 열 이름은 대문자예요.

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT가 호출되지 않았거나 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT가 열 목록을 지우도록 호출된 경우 함수는 빈 문자열을 반환해요.

접근 제어 요구 사항 (Access Control Requirements)

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

사용 참고 (Usage Notes)

  • 이 함수를 호출하려면 (예: USE DATABASE를 실행하여) 사용 중인 데이터베이스가 있어야 해요. 사용 중인 데이터베이스가 없으면 함수 호출이 실패해요.

예제 (Examples)

다음 예제는 ACCOUNT_USAGE 스키마의 TABLES 뷰에 대해 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT에 대한 이전 호출로 지정된 열 목록을 반환해요.

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'TABLES'
);

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   'SNOWFLAKE',                                         |
|   'ACCOUNT_USAGE',                                     |
|   'TABLES'                                             |
| )                                                      |
|--------------------------------------------------------|
| TABLE_NAME,TABLE_SCHEMA,TABLE_TYPE                     |
+--------------------------------------------------------+

다음 예제는 INFORMATION_SCHEMA 스키마의 TABLES 뷰에 대해 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT에 대한 이전 호출로 지정된 열 목록을 반환해요.

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'ACCOUNT_USAGE',
  'TABLES'
);

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   '',                                                  |
|   'INFORMATION_SCHEMA',                                |
|   'TABLES'                                             |
| )                                                      |
|--------------------------------------------------------|
| TABLE_NAME,TABLE_SCHEMA,TABLE_TYPE                     |
+--------------------------------------------------------+

SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT가 호출되지 않았거나 SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT가 목록을 지우도록 호출된 경우 함수는 빈 문자열을 반환해요.

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'TABLES'
);

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  'SNOWFLAKE',
  'ACCOUNT_USAGE',
  'TABLES'
);

+--------------------------------------------------------+
| SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT( |
|   'VIEW',                                              |
|   'SNOWFLAKE',                                         |
|   'ACCOUNT_USAGE',                                     |
|   'TABLES'                                             |
| )                                                      |
|--------------------------------------------------------|
+--------------------------------------------------------+

다음 예제는 INFORMATION_SCHEMA 스키마의 TASK_HISTORY 테이블 함수에 대해 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT에 대한 이전 호출로 지정된 열 목록을 반환해요.

SELECT SYSTEM$GET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'FUNCTION',
  '',
  'INFORMATION_SCHEMA',
  'TASK_HISTORY'
);

더 알아보기