CREATE APPLICATION PACKAGE

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

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

Native Apps Frameworkを使用して、アプリケーションのデータコンテンツとアプリケーションロジックを含む新しいアプリケーションパッケージを作成します。アプリケーションパッケージとは、以下のような追加の機能を指定するデータベースのことです。

  • アプリケーションのバージョン。

  • アプリケーションで利用可能なデータコンテンツ。

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

ALTER APPLICATION PACKAGE、 DROP APPLICATION PACKAGE、 SHOW APPLICATION PACKAGES

構文

CREATE APPLICATION PACKAGE [ IF NOT EXISTS ] <name>
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
Copy

必須パラメーター

name

アプリケーションパッケージの識別子を指定します。アカウントに対して一意である必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれている場合を除き、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

オプションのパラメーター

DATA_RETENTION_TIME_IN_DAYS = integer

アプリケーションパッケージでTime Travelアクション（CLONE および UNDROP）を実行できる日数を指定し、さらにデータベースで作成されたスキーマすべてのデフォルトのTime Travel保持時間を指定します。

詳細については、 Time Travelの理解と使用 をご参照ください。

このオブジェクトレベルパラメーターの詳細な説明、およびオブジェクトパラメーターの詳細については、 パラメーター をご参照ください。

値：

  • Standard Edition： 0 または 1

  • Enterprise Edition：

    • 永続データベースの場合は 0 ～ 90

デフォルト：

  • Standard Edition： 1

  • Enterprise Edition（またはそれ以上）： 1 （アカウントレベルで別のデフォルト値が指定されていない場合）

注釈

0 の値は、データベースのTime Travelを無効にします。

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Snowflakeがアプリケーションパッケージ内のテーブルのデータ保持期間を延長して、テーブル上のストリームが古くなるのを防ぐことができる最大日数を指定するオブジェクトパラメーター。

このパラメーターの詳細な説明については、 MAX_DATA_EXTENSION_TIME_IN_DAYS をご参照ください。

DEFAULT_DDL_COLLATION = 'collation_specification'

アプリケーションパッケージに追加されたすべてのスキーマとテーブルのデフォルトの 照合仕様 を指定します。デフォルトは、スキーマおよび個々のテーブルレベルで上書きできます。

パラメーターの詳細については、 DEFAULT_DDL_COLLATION をご参照ください。

COMMENT = 'string_literal'

アプリケーションパッケージのコメントを指定します。

デフォルト: 値なし

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

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

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

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

DISTRIBUTION = { INTERNAL | EXTERNAL }

コンシューマーが外部組織のアプリケーションパッケージに基づいてアプリケーションを作成できるかどうかを指定します。

  • INTERNAL は、アプリケーションパッケージが作成されたのと同じ組織内でコンシューマーがアプリケーションを作成できることを指定します。

  • EXTERNAL は、別の組織でコンシューマーがアプリケーションを作成できることを指定します。

    注釈

    DISTRIBUTION パラメーターを EXTERNAL に設定すると、アプリケーションパッケージに定義されている各アクティブバージョンとパッチの自動セキュリティ確認がトリガーされます。

    自動セキュリティ確認のステータスが APPROVED になるまで、以下の制限が適用されます。

    • バージョンやパッチにリリースディレクティブを設定することはできません。

    • アプリケーションパッケージのリストは公開できません。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

CREATE APPLICATION PACKAGE

アカウント

ACCOUNTADMIN ロールのみが、デフォルトでこの権限を持っています。権限は、必要に応じて他のロールに付与できます。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • アプリケーションパッケージを作成するには、アカウントに対する CREATE APPLICATION PACKAGE 権限が必要です。

  • アプリケーションパッケージに存在するオブジェクトの型や、それらのオブジェクトを所有するロール（データベースまたはアカウントレベル）には制限はありません。

  • 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のメタデータフィールド.

  • CREATE OR REPLACE <object> statements are atomic. That is, when an object is replaced, the old object is deleted and the new object is created in a single transaction.

例

CREATE APPLICATION PACKAGE hello_snowflake_package;
Copy
+-----------------------------------------------------------------------+
| status                                                                |
|-----------------------------------------------------------------------|
| Application Package 'hello_snowflake_package' created successfully.   |
+-----------------------------------------------------------------------+
言語: 日本語