ALTER APPLICATION PACKAGE¶
Native Apps Frameworkにある既存のアプリケーションパッケージのプロパティを変更します。
- こちらもご参照ください。
CREATE APPLICATION PACKAGE、 DROP APPLICATION PACKAGE、 SHOW APPLICATION PACKAGES、 SHOW VERSIONS、 SHOW RELEASE DIRECTIVES
構文¶
ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
[ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
[ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
[ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
[ COMMENT = <string-literal> ]
[ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
[ MULTIPLE_INSTANCES = TRUE ]
ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
[ DATA_RETENTION_TIME_IN_DAYS ]
[ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
[ DEFAULT_DDL_COLLATION ]
[ COMMENT ]
[ DISTRIBUTION ]
ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
パラメーター¶
name
変更するアプリケーションパッケージの識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
SET ...
アプリケーションパッケージに設定する1つ(または複数)のプロパティを指定します(空白、コンマ、または改行で区切り)。
DATA_RETENTION_TIME_IN_DAYS = num
データベースでTime Travelアクション(CLONE および UNDROP)を実行できる日数を指定し、さらにデータベースで作成されたすべてのスキーマのデフォルトのTime Travel保持時間を指定します。
指定できる値は、使用しているSnowflake Editionによって異なります。
Standard Edition:
0
または1
Enterprise Edition(またはそれ以上):
0
から90
MAX_DATA_EXTENSION_TIME_IN_DAYS = integer
Snowflakeがデータベース内のテーブルのデータ保持期間を延長して、テーブル上のストリームが古くなるのを防ぐことができる最大日数を指定するオブジェクトパラメーター。
このパラメーターの詳細については、 MAX_DATA_EXTENSION_TIME_IN_DAYS をご参照ください。
DEFAULT_DDL_COLLATION = 'collation_specification'
次のデフォルトの 照合仕様 を指定します。
データベース内の既存のテーブルに追加された新しい列。
データベースに追加された新しいテーブルのすべての列。
パラメーターを設定しても、既存の列の照合仕様は 変更されません 。
パラメーターの詳細については、 DEFAULT_DDL_COLLATION をご参照ください。
DEFAULT_DDL_COLLATION = 'collation_specification'
次のデフォルトの 照合仕様 を指定します。
データベース内の既存のテーブルに追加された新しい列。
データベースに追加された新しいテーブルのすべての列。
パラメーターを設定しても、既存の列の照合仕様は 変更されません 。
パラメーターの詳細については、 DEFAULT_DDL_COLLATION をご参照ください。
COMMENT = 'string_literal'
データベースのコメントを追加するか、既存のコメントを上書きします。
DISTRIBUTION = { INTERNAL | EXTERNAL }
リストのデータ製品としてアプリケーションパッケージを使用する場合に、プロバイダーが作成できるリストのタイプを指定します。
INTERNAL
は、プロバイダーが、アプリケーション・パッケージが作成されたのと同じ組織内でのみプライベート・リストを作成できることを示します。DISTRIBUTION プロパティが INTERNAL に設定されている場合、自動セキュリティスキャンは実行されません。EXTERNAL
は、プロバイダーが、アプリケーションパッケージが作成されたのと同じ組織の外部でリストを作成できることを示します。
DISTRIBUTION プロパティと自動セキュリティスキャンの設定に関する情報については、 自動セキュリティスキャンを実行する をご参照ください。
注釈
DISTRIBUTION
パラメーターをEXTERNAL
に設定すると、アプリケーションパッケージに定義されている各アクティブバージョンとパッチの自動セキュリティ確認がトリガーされます。自動セキュリティ確認のステータスが
APPROVED
になるまで、以下の制限が適用されます。バージョンやパッチにリリースディレクティブを設定することはできません。
アプリケーションパッケージのリストは公開できません。
MULTIPLE_INSTANCES = TRUE
コンシューマーがアプリケーションパッケージからアプリケーションの複数のインスタンスをインストールできるようにします。このプロパティは、試用または収益化リストに含まれるアプリケーションパッケージには設定できません。
複数のインスタンスが許可されている場合、コンシューマーはアカウントに最大10インスタンスのアプリをインストールできます。
注意
このプロパティをtrueに設定した後は、
FALSE
に設定したり、後で設定を解除したりすることができません。
UNSET ...
アプリケーションパッケージの設定を解除するプロパティやパラメーターを1つ(または複数)指定します。
DATA_RETENTION_TIME_IN_DAYS
MAX_DATA_EXTENSION_TIME_IN_DAYS
EXTERNAL_VOLUME
CATALOG
DEFAULT_DDL_COLLATION
TAG tag_name [ , tag_name ... ]
COMMENT
単一の ALTER ステートメントで複数のプロパティ/パラメーターをリセットできます。ただし、各プロパティ/パラメーターはカンマで区切る 必要があります 。プロパティ/パラメーターをリセットするときは、名前のみを指定します。プロパティの値を指定すると、エラーが返されます。
使用上の注意¶
オプションのプロパティの値を指定しない場合、コマンドはアプリのマニフェストファイルで指定された値を使用します。
コマンドとアプリのマニフェストファイルでプロパティに値を指定した場合は、コマンドで指定した値が優先されます。
2つのバージョンがアクティブな場合(例: 現在のバージョンのロールアウトが終了していない場合)は、新しいバージョンを追加するとエラーになります。
新しいバージョンはデフォルトのパッチ番号0で追加されます。
メタデータについて:
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
例¶
ALTER APPLICATION PACKAGE hello_snowflake_package SET
COMMENT = 'Altered the Hello Snowflake app.';
+-------------------------------------------+
| status |
|-------------------------------------------|
| Statement executed successfully. |
+-------------------------------------------+