애플리케이션 수정하기
애플리케이션 수정하기 (ALTER APPLICATION)
이 기능은 중화인민공화국에서는 사용할 수 없어요.
%naf%는 지원되는 클라우드 플랫폼에서 일반적으로 사용할 수 있어요. 자세한 내용은 Support for private connectivity, VPS, and government regions를 참고하세요.
설치된 %native-app%의 속성을 수정해요. ALTER APPLICATION을 사용하여 앱을 특정 버전이나 패치로 업그레이드할 수 있어요. 이 명령은 앱의 다른 속성을 설정하는 데에도 사용돼요.
함께 보기:
CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION, SHOW APPLICATIONS
출처: 문서
본문
Syntax
ALTER APPLICATION [ IF EXISTS ] SET
[ COMMENT = '' ]
[ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
[ DEBUG_MODE = { TRUE | FALSE } ]
[ AUTHORIZE_RESTRICTED_PROVIDER_REMOTE_OPERATIONS_UNTIL = { '' | 'INDEFINITE' | 'NEVER' } ]
ALTER APPLICATION [ IF EXISTS ] UNSET
[ COMMENT ]
[ SHARE_EVENTS_WITH_PROVIDER ]
[ DEBUG_MODE ]
[ AUTHORIZE_RESTRICTED_PROVIDER_REMOTE_OPERATIONS_UNTIL ]
ALTER APPLICATION [ IF EXISTS ] RENAME TO
ALTER APPLICATION SET FEATURE POLICY [ FORCE ]
ALTER APPLICATION UNSET FEATURE POLICY;
ALTER APPLICATION SET MAINTENANCE POLICY [ FORCE ]
ALTER APPLICATION UNSET MAINTENANCE POLICY
ALTER APPLICATION SET TAG = '' [ , = '' ... ]
ALTER APPLICATION UNSET TAG [ , ... ]
ALTER APPLICATION SET SHARED TELEMETRY EVENTS (', ...])
ALTER APPLICATION SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }
ALTER APPLICATION UNSET REFERENCES [ ( '' [ , '' ] ) ]
ALTER APPLICATION UPGRADE
ALTER APPLICATION UPGRADE USING VERSION [ PATCH ]
ALTER APPLICATION UPGRADE USING
Parameters
name
변경할 앱의 식별자를 지정합니다. 식별자에 공백, 특수 문자, 또는 대소문자가 섞인 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자는 대소문자를 구분합니다.
SET
앱에 설정할 하나 이상의 속성을 지정합니다. (속성은 공백, 쉼표, 또는 새 줄로 구분합니다.) 설정할 수 있는 속성에 대한 자세한 내용은 CREATE APPLICATION을 참조하세요.
COMMENT = '{string}'
앱에 주석을 추가하거나 기존 주석을 덮어씁니다.
DEBUG_MODE = { TRUE | FALSE }
설치된 앱에 대해 디버그 모드를 활성화하거나 비활성화합니다.
TRUE는 설치된 앱에 디버그 모드를 활성화합니다.FALSE는 설치된 앱에 디버그 모드를 비활성화합니다.
다음 조건이 모두 충족되는 경우에만 앱에 DEBUG_MODE를 설정할 수 있습니다.
-
설치된 앱이 애플리케이션 패키지와 동일한 계정에 있어야 합니다.
-
설치된 앱이 개발 모드로 생성되어야 합니다.
개발 모드는 명시적 스테이지, 버전, 또는 패치와 함께 설치됩니다.
-
설치된 앱에 대한 OWNERSHIP 권한이 있고, 설치된 앱을 생성하는 데 사용된 애플리케이션 패키지에 대해 사용자의 역할에 DEVELOP 권한이 부여되어 있어야 합니다.
SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }
로그 및 이벤트 데이터를 공급자와 공유할지 여부를 지정합니다.
AUTHORIZE_RESTRICTED_PROVIDER_REMOTE_OPERATIONS_UNTIL = { '' | 'INDEFINITE' | 'NEVER' }
공급자가 앱에서 restricted remote app operations (예: run_sql 작업)을 수행할 수 있는지 여부를 지정합니다.
'': 지정된 타임스탬프까지 공급자가 제한된 원격 앱 작업을 수행하도록 승인합니다.'INDEFINITE': 공급자가 제한된 원격 앱 작업을 무기한 수행하도록 승인합니다.'NEVER': 제한된 원격 앱 작업에 대한 승인을 취소합니다.
기본값: 'NEVER'
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
tag 이름과 태그 문자열 값을 지정합니다.
태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.
문에서 태그를 지정하는 방법에 대한 자세한 내용은 을 참조하세요.
UNSET
앱에 대해 설정을 해제할 하나 이상의 속성 및/또는 세션 매개변수를 지정하며, 이를 통해 기본값으로 재설정합니다.
단일 ALTER 문으로 여러 속성/매개변수를 재설정할 수 있습니다. 단, 각 속성/매개변수는 쉼표로 구분해야 합니다. 속성/매개변수를 재설정할 때는 이름만 지정해야 하며, 속성/매개변수에 값을 지정하면 오류가 반환됩니다.
-
COMMENT -
DEBUG_MODE설치된 앱에 대한 디버그 모드를 비활성화합니다. 이 절은DEBUG_MODE = FALSE로 설정하는 것과 의미상 동일합니다. -
SHARE_EVENTS_WITH_PROVIDER -
AUTHORIZE_RESTRICTED_PROVIDER_REMOTE_OPERATIONS_UNTIL제한된 공급자 원격 앱 작업에 대한 승인을 취소합니다. 이는AUTHORIZE_RESTRICTED_PROVIDER_REMOTE_OPERATIONS_UNTIL = 'NEVER'로 설정하는 것과 의미상 동일합니다. -
TAG tag_name [ , tag_name ... ]
-
REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]
앱에 대해 Unsets a persistent reference를 수행합니다. 인수가 전달되지 않으면 앱에 설정된 모든 영구 참조를 해제합니다.
RENAME TO new_app_name
앱의 새 식별자를 지정합니다. 이 식별자는 계정 내에서 고유해야 합니다.
SET FEATURE POLICY policy_name [ FORCE ]
앱에 적용할 기능 정책을 지정합니다. 앱에 기능 정책이 이미 설정된 경우, 먼저 기능 정책을 해제하지 않고도 FORCE를 사용하여 기능 정책을 설정할 수 있습니다.
UNSET FEATURE POLICY
앱에서 기능 정책을 제거합니다. 앱에서 기능 정책이 제거되면, 계정 수준 기능 정책이 존재하는 경우 해당 정책이 적용됩니다.
SET MAINTENANCE POLICY policy_name [ FORCE ]
앱에 적용할 maintenance policy를 지정합니다. 앱에 유지 관리 정책이 이미 설정된 경우, 먼저 유지 관리 정책을 해제하지 않고도 FORCE를 사용하여 유지 관리 정책을 설정할 수 있습니다.
UNSET MAINTENANCE POLICY
앱에서 유지 관리 정책을 제거합니다. 앱에서 유지 관리 정책이 제거되면, 계정 수준 유지 관리 정책이 존재하는 경우 해당 정책이 적용됩니다.
SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )
앱에 대해 활성화할 선택적 이벤트 정의를 지정합니다.
SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }
TRUE로 설정하면 앱에 필요한 모든 이벤트 정의가 활성화됩니다. 그러나 선택적 이벤트 정의는 계속 비활성화된 상태로 유지됩니다. 앱에 대한 선택적 이벤트 정의를 설정하려면 SET SHARED TELEMETRY EVENTS 절을 사용하세요.
이 값을 TRUE로 설정한 후 앱에 필수 이벤트 정의가 있는 경우 값을 다시 FALSE로 재설정할 수 없습니다.
UNSET REFERENCES[ ( 'reference_name' [ , 'reference_alias' ] ) ]
앱에서 지정된 참조를 제거합니다.
UPGRADE
공급자가 앱에 대한 새 버전 또는 패치를 게시한 경우 앱을 업그레이드합니다.
공급자가 앱의 릴리스 지시문을 설정하면 앱이 자동으로 업그레이드됩니다. 그러나 이 명령을 사용하면 자동 업그레이드가 실행될 때까지 기다리지 않고 즉시 업그레이드를 시작할 수 있습니다. 이 명령은 개발 모드로 생성되지 않은 앱에서만 사용할 수 있습니다. 개발 모드의 앱은 리스팅에서 설치되거나 스테이지 또는 버전을 지정하지 않고 설치되며, 주로 업그레이드 프로세스를 테스트하기 위한 것입니다.
UPGRADE USING VERSION version_name [ PATCH patch_num ]
앱을 지정된 버전으로 업그레이드합니다. patch_num이 지정되지 않으면 최신 패치가 사용됩니다. 이 명령은 버전과 패치를 지정하여 설치된 앱에만 유효합니다.
UPGRADE USING path_to_stage
path_to_stage로 지정된 경로의 명명된 스테이지에 있는 파일을 사용하여 앱을 업그레이드합니다.
이 절은 명명된 스테이지에서 앱을 설치한 경우에만 적용됩니다.
사용 참고 사항
- 선택적 매개변수에 값을 지정하지 않으면 해당 매개변수의 값은
manifest.yml파일에서 가져옵니다. 매니페스트와 명령 실행 시 모두 값을 지정하면 명령에서 지정한 값이 우선합니다. - 메타데이터 관련: