snowアプリ公開¶
リリースチャンネルにバージョンを追加し、リリースディレクティブを 新しいバージョンとパッチで更新します。
構文¶
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
key=value形式の文字列。テンプレートに使用される env セクションの変数をオーバーライドする。デフォルト: []
--connection, -c, --environment TEXT
config.toml
ファイルで定義されている接続の名前。デフォルト:デフォルト
--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
構成で定義された接続ではなく、コマンドラインパラメーターで定義された接続を使用します。デフォルト: 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
ログレベル
info
以上のログエントリを表示します。デフォルト: false。--debug
ログレベル
debug
以上のログ エントリを表示します。デバッグログには追加情報が含まれます。デフォルト: false。--silent
コンソールへの中間出力をオフにします。デフォルト: false。
--help
このコマンドのヘルプテキストを表示します。
使用上の注意¶
snow app publish
コマンドは Snowflake Native App バージョンをリリースチャンネルに追加し、選択されたリリースディレクティブが提供されたバージョンとパッチを使うようにセットします。
リリースチャンネルとリリースディレクティブの詳細情報については、 Snowflake Native App を顧客に公開します。 を参照してください。
注釈
リリースチャンネル機能はリージョンによって可用性が異なる場合があります。詳細については、Snowflakeサポートにお問い合わせください。
リリース・チャンネル機能が可用性でない場合は、このコマンドの:codenowrap:--channel
パラメーターは無視できます。
このコマンドは、指定されたバージョンをリリース・チャンネルに追加します。リリースチャンネルが最大バージョン数に達した場合、どのリリースディレクティブでも参照されていない最も古いバージョンがリリースチャンネルから削除されます。バージョンがリリースチャンネルに追加された後、リリースチャンネル内のリリースディレクティブは提供されたバージョンとパッチを使用するように更新されます。
リリースチャンネルがアプリケーションパッケージに対して有効になっていない場合、 release ディレクティブだけが提供されたバージョンとパッチを使うように更新されます。リリースチャネルがプロバイダーから提供されていない場合、またはデフォルトのリリースチャネルを使用している場合は、リリースチャネルが有効になっているかどうかにかかわらず、同じコマンドを使用できます。
このコマンドは、バージョンとパッチがアプリケーション・パッケージに既に存在していることを前提としています。バージョンとパッチが存在しない場合、コマンドは失敗します。
このコマンドを使用して新しいバージョンやパッチを作成するには、--create-version
オプションを使用します。このオプションを使うと、--from-stage
または:codenowrap:--label
のようなオプションが使えます。詳細情報については、 snow app version create コマンドも参照してください。
新しいバージョンを作成するルールは、 snow app version create コマンドと同じルールです。つまり、 Snowflake CLI は、バージョンフィールドが欠落している場合、マニフェストファイルと同じフォールバックロジックを使用します。
例¶
バージョンv1とパッチ2をデフォルトリリースチャンネルのデフォルトリリースディレクティブ、またはパッケージのデフォルトリリースディレクティブに公開してください。この例では、リリース・チャンネルは有効になっていません。
snow app publish --version v1 --patch 2
バージョンv1とパッチ2を、 ALPHA リリースチャンネルの:codenowrap:
customers_group_1
リリースディレクティブに公開してください。snow app publish --version v1 --patch 2 --channel ALPHA --directive customers_group_1
QA リリースチャンネルのデフォルトリリースディレクティブにバージョンv1とパッチ2を公開してください。
snow app publish --version v1 --patch 2 --channel QA
新しいバージョンを作成し、デフォルトのリリースチャンネルのカスタムの:codenowrap:
early_adopters
リリースディレクティブに公開します。snow app publish --version v2 --create-version --directive early_adopters
既存のバージョンにパッチを追加し、デフォルトリリースチャンネルのデフォルトリリースディレクティブに公開します。
--create-version
を使用し、パッチ番号をプロバイダーで指定するか、次に使用可能なパッチ番号を使用するために省略する必要があります。snow app publish --version v2 --create-version
ステージにファイルを同期せずに、ステージの内容から新しいパッチを作成し、デフォルトリリースチャンネルのデフォルトリリースディレクティブに公開します。
snow app publish --version v2 --patch 11 --create-version --from-stage