ALTER APPLICATION

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

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

Native Apps Frameworkにインストールされたアプリケーションのプロパティを変更します。インストールされているアプリケーションを特定のバージョンやパッチにアップグレードするには、 ALTER APPLICATION を使用します。このコマンドは、アプリケーションのデバッグモードを有効または無効にするためにも使用されます。

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

CREATE APPLICATION、 DESCRIBE APPLICATION、 DROP APPLICATION、 SHOW APPLICATIONS

構文

ALTER APPLICATION [ IF EXISTS ] <name> SET
  [ COMMENT = '<string-literal>' ]
  [ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
  [ DEBUG_MODE = { TRUE | FALSE } ]

ALTER APPLICATION [ IF EXISTS ] <name> UNSET
  [ COMMENT ]
  [ SHARE_EVENTS_WITH_PROVIDER ]
  [ DEBUG_MODE ]

 ALTER APPLICATION <name> UPGRADE

 ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

 ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

 ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

 ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

 ALTER APPLICATION <name> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]
Copy

パラメーター

name

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

SET

アプリケーションに設定する1つ（または複数）のプロパティを指定します（空白、コンマ、または改行で区切り）。設定できるプロパティの詳細については、 CREATE APPLICATION をご参照ください。

COMMENT = '{string}'

アプリケーションのコメントを追加するか、既存のコメントを上書きします。

:code:`DEBUG_MODE = { TRUE | FALSE | `

インストールされているアプリケーションのデバッグモードを有効または無効にします。

  • TRUE は、インストールされたアプリケーションのデバッグモードを有効にします。

  • FALSE は、インストールされたアプリケーションのデバッグモードを無効にします。

以下の条件を満たす場合のみ、アプリケーションに DEBUG_MODE を設定できます。

  • インストールされたアプリケーションは、アプリケーションパッケージと同じアカウントにある。

  • インストールされたアプリケーションは開発モードで作成されている。

    開発モードは、明示的ステージ、バージョン、パッチと合わせてインストールされている。

  • インストールされたアプリケーションに対する OWNERSHIP 権限があり、使用するロールには、インストールされたアプリケーションの作成に使用したアプリケーションパッケージに対する DEVELOP 権限が付与されている。

SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }

ログとイベントデータをプロバイダーと共有するかどうかを指定します。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントにあるタグの指定の詳細については、 オブジェクトおよび列のタグクォータ をご参照ください。

UPGRADE

アプリケーションプロバイダーがインスタンスをアップグレードする必要があることを示した場合に、アプリケーションのアップグレードを実行します。

アプリケーションは、プロバイダーがアップグレードする必要があると示した時点で自動的にアップグレードされますが、このコマンドを使用すると、自動アップグレードを待たずに直ちにアップグレードを実行することができます。このコマンドは、リストから、またはステージやバージョンを指定せずにインストールされる非開発モードのアプリケーションでのみ使用でき、主にアプリケーションのアップグレード処理のテストをサポートすることを目的としています。

UPGRADE USING VERSION version_name [ PATCH patch_num ]

アプリケーションを指定されたバージョンにアップグレードします。 patch_num が指定されていない場合は、最新のパッチが使用されます。このコマンドは、バージョンとパッチを指定してインストールしたアプリケーションに対してのみ有効です。

UPGRADE USING <path_to_version_directory>

path_to_stage で指定されたパスにある名前付きステージ上のファイルを使用して、アプリケーションをアップグレードします。

この句は、名前付きステージからアプリケーションをインストールした場合にのみ適用されます。

UNSET

アプリケーションの設定を解除する1つ（または複数）のプロパティやセッションパラメーターを指定します。これにより、デフォルトにリセットされます。

単一の ALTER ステートメントで複数のプロパティ/パラメーターをリセットできます。ただし、各プロパティ/パラメーターはコンマで区切る 必要があります 。プロパティ/パラメーターをリセットするときは、名前のみを指定します。プロパティ/パラメーターの値を指定すると、エラーが返されます。

  • COMMENT

  • DEBUG_MODE は、インストールされたアプリケーションのデバッグモードを無効にします。この句は、意味的には DEBUG_MODE = FALSE を設定するのと同じです。

  • TAG tag_name [ , tag_name ... ]

  • REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]

    アプリケーションの 永続参照の設定を解除 します。引数が渡されない場合は、アプリケーションに設定されているすべての永続参照を解除します。

使用上の注意

  • オプションのパラメーター値を指定しない場合、これらのパラメーター値は manifest.yml ファイルから取得されます。マニフェストとコマンド実行時の両方で値を指定した場合は、コマンドで指定された値が優先されます。

  • Regarding metadata:

    注意

    Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Snowflakeのメタデータフィールド.

言語: 日本語