CREATE VERSIONED SCHEMA

CREATE VERSIONED SCHEMA

CREATE OR ALTER VERSIONED SCHEMA 명령은 새 버전 스키마(versioned schema)를 만들거나 기존 버전 스키마를 수정하는 명령이에요. 이 명령은 Native Apps Framework의 애플리케이션 인스턴스에서만 지원됩니다.

출처: CREATE VERSIONED SCHEMA

본문

새 버전 스키마를 만들거나 기존 버전 스키마를 수정하는 Preview Feature — Open 명령입니다. 모든 계정에서 사용할 수 있어요. 이 명령은 Native Apps Framework의 애플리케이션 인스턴스에서만 지원됩니다.

관련 명령: CREATE APPLICATION, CREATE APPLICATION PACKAGE

Syntax

CREATE OR ALTER VERSIONED SCHEMA <name>
  [ WITH MANAGED ACCESS ]
  [ DATA_RETENTION_TIME_IN_DAYS = ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = '<string_literal>' ]

Required parameters (필수 파라미터)

  • name — 스키마의 식별자를 지정해요. 스키마가 생성되는 애플리케이션 인스턴스 내에서 고유해야 합니다. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열을 큰따옴표로 감싸지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분합니다. 자세한 내용은 Identifier requirements 문서를 참고하세요.

Optional parameters (선택 파라미터)

  • WITH MANAGED ACCESS — 관리형 버전 스키마를 지정해요. 관리형 접근 버전 스키마는 스키마 소유자에게 권한 관리를 중앙화합니다. 일반 버전 스키마에서는 객체의 소유자(즉 객체에 OWNERSHIP 권한을 가진 역할)가 자신의 객체에 대한 추가 권한을 다른 역할에 부여할 수 있어요. 관리형 스키마에서는 스키마 소유자가 미래 권한을 포함한 스키마 내 객체의 모든 권한 부여를 관리합니다. 객체 소유자는 객체에 대한 OWNERSHIP 권한을 유지하지만, 권한 부여를 관리할 수 있는 것은 스키마 소유자뿐입니다.
  • DATA_RETENTION_TIME_IN_DAYS = <integer> — 스키마에서 Time Travel 작업(CLONE과 UNDROP)을 수행할 수 있는 일 수와, 스키마에서 생성되는 모든 테이블의 기본 Time Travel 보존 시간을 지정해요. 자세한 내용은 Understanding & using Time Travel 문서를 참고하세요. 값: 문서를 참고. 기본값: 문서를 참고.

    참고 값이 0이면 스키마의 Time Travel을 사실상 비활성화해요.

  • MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> — 스키마의 테이블에 있는 스트림이 오래되도록(stale) 되는 것을 방지하기 위해 Snowflake가 스키마 내 테이블의 데이터 보존 기간을 연장할 수 있는 최대 일 수를 지정하는 객체 파라미터. 자세한 내용은 MAX_DATA_EXTENSION_TIME_IN_DAYS 문서를 참고하세요.
  • DEFAULT_DDL_COLLATION = '<collation_specification>' — 스키마에 추가되는 모든 테이블의 기본 데이터 정렬(collation) 사양을 지정해요. 기본값은 개별 테이블 수준에서 재정의할 수 있어요. 자세한 내용은 DEFAULT_DDL_COLLATION 문서를 참고하세요.
  • COMMENT = '<string_literal>' — 스키마에 대한 주석을 지정해요. 기본값: 값 없음

Access control requirements (접근 제어 요구 사항)

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.

참고 일반적으로 버전 스키마는 설정 스크립트(set up script)에서 만들지만, 버전 스키마는 다음과 같은 방법으로도 만들 수 있어요.

Usage notes (사용 참고 사항)

버전 스키마는 Native Apps Framework에서 애플리케이션의 스키마 버전 관리에 사용돼요.

더 알아보기 (Learn more)