ALTER MODEL¶
이름, 태그, 기본 버전 또는 설명을 포함하여 기존 모델의 속성을 수정합니다.
이 명령에는 다음과 같은 세 가지 다른 변형이 있습니다.
ALTER MODEL … ADD VERSION 은 모델의 새 버전을 추가합니다.
ALTER MODEL … DROP VERSION 은 모델의 버전을 제거합니다.
ALTER MODEL … MODIFY VERSION 은 모델 버전의 설명 또는 메타데이터를 설정합니다.
구문¶
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>
매개 변수¶
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 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.