SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT

SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT

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

자세한 내용은 Handling new columns in SHOW command output, Snowflake views, and table functions을 참고하세요.

출처: Snowflake SQL Reference

본문

참고:

Syntax

SYSTEM$UNSET_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

작업이 성공하면 TRUE를 반환해요.

Access control requirements

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

Usage notes

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

Examples

다음 예제는 ACCOUNT_USAGE 스키마의 TABLES 뷰에 대해 이전 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 호출이 설정한 열 목록을 지워요:

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

다음 예제는 INFORMATION_SCHEMA 스키마의 TABLES 뷰에 대해 이전 SYSTEM$SET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT 호출이 설정한 열 목록을 지워요:

SELECT SYSTEM$UNSET_DEFAULT_COLUMNS_OVERRIDE_FOR_SYSTEM_OBJECT(
  'VIEW',
  '',
  'INFORMATION_SCHEMA',
  'TABLES'
);

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

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

더 알아보기 (Learn more)