CREATE MODEL¶
現在指定のスキーマで新しい機械学習モデルを作成するか、既存のモデルを置き換えます。このコマンドは Snowparkモデルレジストリ で使用するために提供されています。Python API で使用するために提供されるものであり、 SQL を使用してモデルを作成するためのものではありません。
モデルはバージョン管理されています。すべてのモデルには最低1つのバージョンがあり、バージョンはデフォルトとして指定することができます。モデルにバージョンを追加するには、 ALTER MODEL ... ADD VERSION を使用します。
モデルのいくつかのプロパティは変更することができ(ALTER MODEL を参照)、任意の数のバージョンを追加することができますが、モデルオブジェクト自体は不変です。
- こちらもご参照ください。
ALTER MODEL、 ALTER MODEL ... ADD VERSION、 DROP MODEL、 SHOW MODELS
構文¶
CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> FROM internalStage;
条件:
internalStage ::=
@[<namespace>.]<int_stage_name>[/<path>]
| @[<namespace>.]%<table_name>[/<path>]
| @~[/<path>]
その他の内部ステージの詳細については、 ローカルファイルに対する内部ステージの選択 をご参照ください。
パラメーター¶
name
新しいモデルの識別子(つまり、名前)を指定する文字列。モデルが作成されるスキーマに対して一意である必要があります。
また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません(例:
"My object"
)。二重引用符で囲まれた識別子も大文字と小文字が区別されます。詳細については、 識別子の要件 をご参照ください。
internalStage
モデルのファイルを含む内部ステージを指定します。これらのファイルの必要なレイアウトは、現時点でドキュメント化されていません。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
---|---|---|
CREATE MODEL |
スキーマ |
スキーマの USAGE による暗示 |
OWNERSHIP |
モデル |
スキーマに既存のオブジェクトと同じ名前の仮オブジェクトを作成するには、ロールにオブジェクトの権限(OWNERSHIP)を付与するか継承する必要があります。 |
スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。