ALTER MODEL

이름, 태그, 기본 버전 또는 설명을 포함하여 기존 모델의 속성을 수정합니다.

이 명령에는 다음과 같은 세 가지 다른 변형이 있습니다.

구문

ALTER MODEL [ IF EXISTS ] <name> SET
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<version_name>']

ALTER MODEL [ IF EXISTS ] <model_name> SET TAG <tag_name> = '<tag_value>'

ALTER MODEL [ IF EXISTS ] <model_name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER MODEL [ IF EXISTS ] <model_name> VERSION <version_name> SET ALIAS = '<alias_name>'

ALTER MODEL [ IF EXISTS ] <model_name> VERSION <version_or_alias_name> UNSET ALIAS

ALTER MODEL <model_name> RENAME TO <new_name>
Copy

매개 변수

name

모델의 식별자(즉, 이름)를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

SET ...

설정할 모델 속성을 하나 이상 지정합니다.

COMMENT = 'string_literal'

모델의 설명을 설정합니다. COMMENT 명령을 사용하여 이 작업을 수행할 수도 있습니다.

DEFAULT_VERSION = 'version_name'

모델의 기본 버전(모델에서 메서드를 직접 호출할 때 메서드가 호출되는 버전)을 설정합니다. 버전 이름은 식별자 입니다.

시스템 별칭 DEFAULT는 기본 버전을 나타냅니다.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.

ALIAS = 'alias_name'

alias_name 을 버전의 별칭으로 설정합니다. 별칭이란 쉽게 재지정이 가능한 대체 이름입니다. 별칭은 버전 이름을 사용할 수 있는 대부분의 위치에서 사용할 수 있습니다. 1개의 버전은 최대 1개의 별칭을 가질 수 있습니다.

별칭 이름은 식별자 입니다. 이 이름은 모델에서 고유해야 하며 다음과 같은 시스템 별칭 이름과 중복될 수 없습니다.

  • DEFAULT 는 모델의 기본 버전을 나타냅니다.

  • FIRST 는 생성 시간을 기준으로 가장 오래된 버전의 모델을 나타냅니다.

  • LAST 는 생성 시점을 기준으로 최신 버전의 모델을 나타냅니다.

UNSET TAG tag_name [ , tag_name ... ]

모델에서 설정 해제할 하나 이상의 태그를 지정합니다.

UNSET ALIAS

이 모델 버전에 별칭이 있으면 제거합니다. 시스템 별칭 DEFAULT, FIRST, LAST는 제거할 수 없습니다. 버전 이름은 물론 별칭도 지정할 수 있습니다.

RENAME TO new_name

스키마의 다른 어떤 모델에서도 현재 사용하지 않는 새 식별자로 지정된 모델의 이름을 바꿉니다.

식별자에 대한 자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

선택적으로 오브젝트의 이름을 바꾸는 동안 오브젝트를 다른 데이터베이스 및/또는 스키마로 이동할 수 있습니다. 그러려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정하십시오.

참고

  • 대상 데이터베이스 및/또는 스키마가 이미 있어야 합니다. 또한, 새 위치에 이름이 같은 오브젝트가 있으면 안 됩니다. 그렇지 않으면 문이 오류를 반환합니다.

  • 오브젝트 소유자(즉, 오브젝트에 대한 OWNERSHIP 권한이 있는 역할) 역시 대상 스키마를 소유하지 않는 한 오브젝트를 관리되는 액세스 스키마로 이동하는 것은 금지됩니다.

모델의 이름이 바뀌면 그 오브젝트를 참조하는 다른 오브젝트도 새 이름으로 업데이트해야 합니다.

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

OWNERSHIP

모델

스키마에 이미 존재하는 오브젝트와 동일한 이름을 가진 임시 오브젝트를 생성하려면 오브젝트에 대한 OWNERSHIP 권한을 역할에 부여하거나 상속해야 합니다.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.