snow app version drop¶
애플리케이션 패키지에 정의된 버전을 삭제합니다. 버전은 명령에 인자로 전달하거나 manifest.yml 파일에서 읽을 수 있습니다. 패치 삭제는 허용되지 않습니다.
구문¶
snow app version drop
<version>
--interactive / --no-interactive
--force
--package-entity-id <package_entity_id>
--app-entity-id <app_entity_id>
--project <project_definition>
--env <env_overrides>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--workload-identity-provider <workload_identity_provider>
--private-key-file <private_key_file>
--token <token>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--oauth-client-id <oauth_client_id>
--oauth-client-secret <oauth_client_secret>
--oauth-authorization-url <oauth_authorization_url>
--oauth-token-request-url <oauth_token_request_url>
--oauth-redirect-uri <oauth_redirect_uri>
--oauth-scope <oauth_scope>
--oauth-disable-pkce
--oauth-enable-refresh-tokens
--oauth-enable-single-use-refresh-tokens
--client-store-temporary-credential
--format <format>
--verbose
--debug
--silent
--enhanced-exit-codes
인자¶
version삭제할 애플리케이션 패키지에 정의된 버전입니다. 기본값은
manifest.yml파일에 지정된 버전입니다.
선택 사항¶
--interactive / --no-interactive이 옵션을 활성화하면 표준 입력 및 출력이 터미널 디바이스가 아닌 경우에도 프롬프트가 표시됩니다. 대화형 셸 환경에서는 기본값이 True이고, 그렇지 않으면 False입니다.
--force이 옵션을 활성화하면 명령은 발생하는 모든 프롬프트를 암시적으로 승인합니다. 대화형 모드가 지정되지 않았고 치명적일 수 있는 작업을 수행하려는 경우 이 옵션을 활성화해야 합니다. 기본값은 설정 해제입니다. 기본값: False.
--package-entity-id TEXTdefinition_version이 2 이상인 경우 작업할 패키지 엔터티의 ID 입니다.
--app-entity-id TEXTdefinition_version이 2 이상인 경우 작업할 애플리케이션 엔터티의 ID 입니다.
-p, --project TEXTSnowflake 프로젝트가 저장된 경로입니다. 현재 작업 디렉터리로 기본 설정됩니다.
--env TEXT키=값 형식의 문자열입니다. 템플릿에 사용되는 환경 섹션의 변수를 재정의합니다. 기본값: [].
--connection, -c, --environment TEXTconfig.toml파일에 정의된 연결의 이름입니다. 기본값:default.--host TEXT연결을 위한 호스트 주소입니다. 연결에 지정된 값을 재정의합니다.
--port INTEGER연결의 포트입니다. 연결에 지정된 값을 재정의합니다.
--account, --accountname TEXTSnowflake 계정에 할당된 이름입니다. 연결에 지정된 값을 재정의합니다.
--user, --username TEXTSnowflake에 연결할 사용자 이름입니다. 연결에 지정된 값을 재정의합니다.
--password TEXTSnowflake 비밀번호입니다. 연결에 지정된 값을 재정의합니다.
--authenticator TEXTSnowflake 인증자입니다. 연결에 지정된 값을 재정의합니다.
--workload-identity-provider TEXT워크로드 ID 공급자(AWS, AZURE, GCP, OIDC). 연결에 지정된 값을 재정의합니다.
--private-key-file, --private-key-path TEXTSnowflake 개인 키 파일 경로입니다. 연결에 지정된 값을 재정의합니다.
--token TEXTSnowflake에 연결할 때 사용할 OAuth 토큰입니다.
--token-file-path TEXTSnowflake에 연결할 때 사용할 OAuth 토큰이 포함된 파일 경로입니다.
--database, --dbname TEXT사용할 데이터베이스입니다. 연결에 지정된 값을 재정의합니다.
--schema, --schemaname TEXT사용할 데이터베이스 스키마입니다. 연결에 지정된 값을 재정의합니다.
--role, --rolename TEXT사용할 역할입니다. 연결에 지정된 값을 재정의합니다.
--warehouse TEXT사용할 웨어하우스입니다. 연결에 지정된 값을 재정의합니다.
--temporary-connection, -xConfig에 정의된 연결 대신 명령줄 매개 변수로 정의된 연결을 사용합니다. 기본값: False.
--mfa-passcode TEXT다단계 인증(MFA)에 사용할 토큰입니다.
--enable-diag연결 진단 보고서를 생성할지 여부입니다. 기본값: False.
--diag-log-path TEXT생성된 보고서의 경로입니다. 기본값은 시스템 임시 디렉터리입니다. 기본값: <system_temporary_directory>.
--diag-allowlist-path TEXT허용 목록 매개 변수가 포함된 JSON 파일의 경로입니다.
--oauth-client-id TEXTSnowflake 통합을 위해 ID 공급자가 제공한 클라이언트 ID의 값입니다.
--oauth-client-secret TEXTSnowflake 통합을 위해 ID 공급자가 제공한 클라이언트 시크릿의 값입니다.
--oauth-authorization-url TEXT드라이버에 인증 코드를 제공하는 ID 공급자 엔드포인트입니다.
--oauth-token-request-url TEXT드라이버에 액세스 토큰을 제공하는 ID 공급자 엔드포인트입니다.
--oauth-redirect-uri TEXT인증 코드 리디렉션에 사용할 URI 입니다.
--oauth-scope TEXTID 공급자 승인 요청에서 요청된 범위입니다.
--oauth-disable-pkcePKCE (Proof Key for Code Exchange)를 비활성화합니다. 기본값:
False.--oauth-enable-refresh-tokens실제 액세스 토큰이 오래되었을 때 자동 재인증을 활성화합니다. 기본값:
False.--oauth-enable-single-use-refresh-tokens일회용 새로 고침 토큰 시맨틱에 옵트인할지 여부입니다. 기본값:
False.--client-store-temporary-credential임시 자격 증명을 저장합니다.
--format [TABLE|JSON|JSON_EXT|CSV]출력 형식을 지정합니다. 기본값: TABLE.
--verbose, -v로그 수준
정보이상에 대한 로그 항목을 표시합니다. 기본값: False.--debug로그 수준
디버그이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.--silent콘솔로의 중간 출력을 끕니다. 기본값: False.
--enhanced-exit-codes실패 유형에 따라 종료 오류 코드를 차별화하십시오. 기본값: False.
--help이 명령에 대한 도움말 텍스트를 표시합니다.
사용법 노트¶
참고
이 명령은 config.toml 파일에 대한 역할 또는 웨어하우스 재정의를 허용하지 않습니다. 대신, snowflake.yml 또는 snowflake.local.yml 의 네이티브 앱 정의에 추가합니다.
이 명령은 작업 중인 애플리케이션 패키지의 배포 값이 확인된 프로젝트 정의에 설정된 값과 다른 경우 경고를 표시하지만 계속 실행합니다.
버전을 제공하지 않으면 명령은
manifest.yml파일에 지정된 버전을 사용합니다.manifest.yml파일에 버전이 없는 경우 명령에서 오류가 발생합니다.릴리스 지시문에서 참조하는 버전을 삭제하려면 먼저 해당 릴리스 지시문을 다른 버전으로 설정한 다음 이 명령을 실행해야 합니다.
이 작업은 파괴적이므로 명령을 실행하기 전에 버전을 삭제할지 묻는 메시지가 표시됩니다.
--force옵션을 사용하여 프롬프트를 건너뛰고 버전을 삭제합니다.
예¶
이 예제에서는 유효한 snowflake.yml 또는 snowflake.local.yml 프로젝트 정의 파일이 있다고 가정합니다.
애플리케이션 패키지에서 기존 버전 V1 을 삭제하려면 다음 명령을 사용합니다.
snow app version drop V1 --connection="dev"
버전을 삭제하고 대화형 모드를 호출하려면 다음 명령을 사용합니다.
snow app version drop V1 --interactive --connection="dev"
대화형 셸에 있는 경우에도 버전을 삭제하고 대화형 모드를 우회하려면 다음 명령을 사용합니다.
snow app version drop V1 --force --connection="dev"