ALTER APPLICATION

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

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

CREATE APPLICATIONDESCRIBE APPLICATIONDROP APPLICATIONSHOW 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}'

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

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 ファイルから取得されます。マニフェストとコマンド実行時の両方で値を指定した場合は、コマンドで指定された値が優先されます。

  • メタデータについて:

    注意

    Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。