snow app publish¶

구문¶

snow app publish
  --version <version>
  --patch <patch>
  --channel <channel>
  --directive <directive>
  --interactive / --no-interactive
  --force
  --create-version
  --from-stage
  --label <label>
  --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>
  --private-key-file <private_key_file>
  --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>
  --format <format>
  --verbose
  --debug
  --silent

인자¶

없음

선택 사항¶

--version TEXT

제공된 릴리스 채널에 게시할 버전과 릴리스 지시문입니다. --create-version 플래그를 사용하지 않는 한 버전은 반드시 존재해야 합니다.

--patch INTEGER

해당 버전의 기본 패치 번호입니다. 릴리스 지시문을 설정할 때 사용됩니다. --create-version 플래그를 사용하지 않는 한 패치는 반드시 존재해야 합니다.

--channel TEXT

게시할 릴리스 채널의 이름입니다. 공급자가 제공하지 않으면 기본 릴리스 채널이 사용됩니다. 기본값: DEFAULT.

--directive TEXT

지정된 버전과 패치로 업데이트할 릴리스 지시문의 이름입니다. 공급자가 제공하지 않으면 기본 릴리스 지시문이 사용됩니다. 기본값: DEFAULT.

--interactive / --no-interactive

이 옵션을 활성화하면 표준 입력 및 출력이 터미널 디바이스가 아닌 경우에도 프롬프트가 표시됩니다. 대화형 셸 환경에서는 기본값이 True이고, 그렇지 않으면 False입니다.

--force

이 옵션을 활성화하면 명령은 발생하는 모든 프롬프트를 암시적으로 승인합니다. 대화형 모드가 지정되지 않았고 치명적일 수 있는 작업을 수행하려는 경우 이 옵션을 활성화해야 합니다. 기본값은 설정 해제입니다. 기본값: False.

--create-version

제공된 --version 및 --patch 값을 기반으로 새 버전 또는 패치를 만듭니다. 제공되지 않은 경우 매니페스트 값으로 대체합니다. 기본값: False.

--from-stage

활성화된 경우 Snowflake CLI 는 스테이지와 먼저 동기화하지 않고 현재 애플리케이션 패키지 스테이지에서 버전을 생성합니다. --create-version 플래그와 함께만 사용할 수 있습니다. 기본값: False.

--label TEXT

컨슈머에게 표시되는 버전에 대한 레이블입니다. --create-version 플래그와 함께만 사용할 수 있습니다.

--package-entity-id TEXT

definition_version이 2 이상일 때 작동할 패키지 엔터티의 ID입니다.

--app-entity-id TEXT

definition_version이 2 이상일 때 작동할 애플리케이션 엔터티의 ID입니다.

-p, --project TEXT

Snowflake 프로젝트가 있는 경로입니다. 기본값은 현재 작업 디렉터리입니다.

--env TEXT

키=값 형식의 문자열. 템플릿에 사용되는 env 섹션의 변수를 재정의합니다. 기본값: [].

--connection, -c, --environment TEXT

config.toml 파일에 정의된 연결의 이름입니다. 기본값: default.

--host TEXT

연결을 위한 호스트 주소입니다. 연결에 지정된 값을 재정의합니다.

--port INTEGER

연결의 포트입니다. 연결에 지정된 값을 재정의합니다.

--account, --accountname TEXT

Snowflake 계정에 할당된 이름입니다. 연결에 지정된 값을 재정의합니다.

--user, --username TEXT

Snowflake에 연결할 사용자 이름입니다. 연결에 지정된 값을 재정의합니다.

--password TEXT

Snowflake 비밀번호입니다. 연결에 지정된 값을 재정의합니다.

--authenticator TEXT

Snowflake 인증자입니다. 연결에 지정된 값을 재정의합니다.

--private-key-file, --private-key-path TEXT

Snowflake 개인 키 파일 경로입니다. 연결에 지정된 값을 재정의합니다.

--token-file-path TEXT

Snowflake에 연결할 때 사용해야 하는 OAuth 토큰이 포함된 파일 경로입니다.

--database, --dbname TEXT

사용할 데이터베이스입니다. 연결에 지정된 값을 재정의합니다.

--schema, --schemaname TEXT

사용할 데이터베이스 스키마입니다. 연결에 지정된 값을 재정의합니다.

--role, --rolename TEXT

사용할 역할입니다. 연결에 지정된 값을 재정의합니다.

--warehouse TEXT

사용할 웨어하우스입니다. 연결에 지정된 값을 재정의합니다.

--temporary-connection, -x

config에서 정의된 연결 대신, 명령줄 매개 변수로 정의된 연결을 사용합니다. 기본값: False.

--mfa-passcode TEXT

다단계 인증(MFA)에 사용할 토큰입니다.

--enable-diag

Python 커넥터 진단 테스트를 실행합니다. 기본값: False.

--diag-log-path TEXT

진단 보고서 경로입니다. 기본값: <temporary_directory>.

--diag-allowlist-path TEXT

선택적 허용 목록에 대한 진단 보고서 경로입니다.

--format [TABLE|JSON]

출력 형식을 지정합니다. 기본값: TABLE.

--verbose, -v

로그 수준 정보 이상에 대한 로그 항목을 표시합니다. 기본값: False.

--debug

로그 수준 디버그 이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.

--silent

콘솔로의 중간 출력을 끕니다. 기본값: False.

--help

이 명령에 대한 도움말 텍스트를 표시합니다.

사용법 노트¶

snow app publish 명령을 사용하면 릴리스 채널에 Snowflake Native App 버전을 추가한 다음 제공된 버전과 패치를 사용하도록 선택한 릴리스 지시문을 설정할 수 있습니다.

릴리스 채널 및 릴리스 지시문에 대한 자세한 내용은 고객에게 Snowflake Native App 게시하기 섹션을 참조하십시오.

이 명령은 지정된 버전을 릴리스 채널에 추가합니다. 릴리스 채널이 최대 버전 수에 도달한 경우 릴리스 지시문에서 참조하지 않는 가장 오래된 버전이 릴리스 채널에서 제거됩니다. 릴리스 채널에 버전이 추가되면 릴리스 채널 내의 릴리스 지시문이 제공된 버전과 패치를 사용하도록 업데이트됩니다.

애플리케이션 패키지에 릴리스 채널을 활성화하지 않은 경우 제공된 버전과 패치를 사용하도록 릴리스 지시문만 업데이트됩니다. 릴리스 채널이 제공되지 않거나 기본 릴리스 채널을 사용하는 경우에는 릴리스 채널 활성화 여부와 관계없이 동일한 명령을 사용할 수 있습니다.

이 명령은 애플리케이션 패키지에 버전과 패치가 이미 존재한다고 가정합니다. 버전과 패치가 존재하지 않으면 명령이 실패합니다.

이 명령을 사용할 때 새 버전 또는 패치를 만들려면 --create-version 옵션을 사용하십시오. 이 옵션을 사용하면 --from-stage 또는 --label 과 같은 옵션을 사용할 수 있습니다. 자세한 내용은 snow app version create 명령을 참조하십시오.

새 버전을 만드는 규칙은 snow app version create 명령과 동일한 규칙입니다. 즉, Snowflake CLI 는 버전 필드가 누락된 경우 매니페스트 파일에 동일한 대체 논리를 사용합니다.

예¶

• 버전 1과 패치 2를 기본 릴리스 채널의 기본 릴리스 지시문 또는 패키지의 기본 릴리스 지시문에 게시합니다. 이 예에서는 릴리스 채널이 활성화되어 있지 않습니다.

  snow app publish --version v1 --patch 2
  

  Copy

• 버전 1과 패치 2를 ALPHA 릴리스 채널의 customers_group_1 릴리스 지시문에 게시합니다.

  snow app publish --version v1 --patch 2 --channel ALPHA --directive customers_group_1
  

  Copy

• 버전 1과 패치 2를 QA 릴리스 채널의 기본 릴리스 지시문에 게시합니다.

  snow app publish --version v1 --patch 2 --channel QA
  

  Copy

• 새 버전을 만들어 기본 릴리스 채널의 사용자 지정 early_adopters 릴리스 지시문에 게시합니다.

  snow app publish --version v2 --create-version --directive early_adopters
  

  Copy

• 기존 버전에 패치를 추가하고 기본 릴리스 채널의 기본 릴리스 지시문에 게시합니다. --create-version 을 사용하여 패치 번호를 제공하거나 생략하여 다음 사용 가능한 패치 번호를 사용해야 합니다.

  snow app publish --version v2 --create-version
  

  Copy

• 스테이지에 파일을 먼저 동기화하지 않고 스테이지의 내용으로 새 패치를 만든 다음 기본 릴리스 채널의 기본 릴리스 지시문에 게시합니다.

  snow app publish --version v2 --patch 11 --create-version --from-stage
  

  Copy