ALTERAPPLICATIONPACKAGE ... VERSION

Snowflake logo in black (no text) プレビュー機能 --- オープン

政府リージョンを除くすべての AWS リージョンのアカウントで利用可能です。その他のサポート対象クラウドプラットフォームの詳細については、Snowflakeの担当者にお問い合わせください。

Native Apps Frameworkにある既存のアプリケーションパッケージのバージョニングを変更します。

こちらもご参照ください。

ALTER APPLICATION PACKAGE、 ALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE

構文

ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>

ALTER APPLICATION PACKAGE <name> ADD PATCH FOR VERSION [<version_identifier>]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]
Copy

パラメーター

name

変更するアプリケーションパッケージの識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

ADD VERSION [ version_identifier ] USING path_to_version_directory

path_to_version_directory で指定されたステージの場所へのパスにあるアプリケーションファイルを使用して、バージョンまたはパッチを追加します。

このバージョンの識別子を指定するには、 version_identifier を使用します。マニフェストファイルで version_identifier を指定しない場合は、このコマンドの一部として version_identifier を指定する必要があります。このコマンドの一部として version_identifier を指定すると、マニフェストファイルで指定された version_identifier よりも優先されます。

[ LABEL = 'display_label' ]

LABEL 句を使用して、この新しいバージョンのラベルを指定できます。このラベルはコンシューマーに表示されます。LABEL 句を省略すると、 manifest.yml ファイルで指定されたラベルが使用されます。

DROP VERSION version_identifier

指定されたバージョン名のバージョンをドロップします。

指定されたバージョン識別子のバージョンをドロップします。バージョンをドロップできるのは、そのバージョンを参照しているリリースディレクティブがない場合のみです。ドロップは非同期処理で、すべてのアプリケーションインスタンスが古いバージョンから正常にアップグレードされ、ドロップするバージョンで実行されているコードがなくなると完了します。

アプリケーションインスタンスの状態をモニターするには、 APPLICATION_STATE ビュー ビューを使用します。 SHOW VERSIONS コマンドを使用して、ドロップされたバージョンのステータスをモニターします。

ADD PATCH FOR VERSION version_identifier . USING path_to_version_directory [ LABEL = 'display_label' ]

指定されたパスにあるアプリケーションファイルを使用して、指定されたバージョン（version_identifier）のパッチをステージの場所（path_to_version_directory）に追加します。

LABEL 句を使用して、この新しいパッチのラベルを指定することができます。このラベルはコンシューマーに表示されます。LABEL 句を省略すると、 manifest.yml ファイルで指定されたラベルが使用されます。

使用上の注意

  • バージョン識別子には最大30文字までの制限があります。

  • 1つのバージョンは最大130個のパッチを含むことができます。

  • バージョンの変更には、アプリケーションの OWNERSHIP 権限を持つロール、または MANAGE VERSIONS グローバル権限が必要です。

  • オプションのプロパティの値を指定しない場合、コマンドはアプリケーションマニフェストファイルで指定された値を使用します。

    コマンドとアプリケーションマニフェストファイルでプロパティに値を指定した場合は、コマンドで指定した値が優先されます。

  • 2つのバージョンがアクティブな場合、たとえば、現在のバージョンのロールアウトが終了していない場合は、新しいバージョンを追加するとエラーになります。

例

ALTER APPLICATION PACKAGE hello_snowflake_package
  ADD VERSION v1_1
  USING '@hello_snowflake_code.core.hello_snowflake_stage';
Copy
+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1    |     0 |
+---------------------------------------------------------------------------------------+---------+-------+
言語: 日本語