CREATE SNOWFLAKE.ML.CLASSIFICATION

新しい分類モデルを作成するか、現在のスキーマまたは指定されたスキーマの既存のモデルを置き換えます。

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

DROP SNOWFLAKE.ML.CLASSIFICATION

構文

CREATE [ OR REPLACE ] SNOWFLAKE.ML.CLASSIFICATION [ IF NOT EXISTS ] <model_name> (
    INPUT_DATA => <input_data>,
    TARGET_COLNAME => '<target_colname>',
    [CONFIG_OBJECT => <config_object>],
)
[ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
[ COMMENT = '<string_literal>' ]
Copy

パラメーター

必須

input_data

トレーニングデータへの 参照。参照を使用すると、制限付き権限で実行されるトレーニングプロセスで、アクティブロールの権限を使用してデータにアクセスできるようになります。データがすでにそのような形式になっている場合は、テーブルまたはビューへの参照を使用できます。または、 クエリ参照 を使用して、データを取得するために実行するクエリを指定することもできます。

INPUT_DATA には、分類モデルによって消費されるトレーニングデータ全体が含まれている必要があります。TARGET_COLNAME 引数に名前のない列は、トレーニング変数（特徴量）とみなされます。入力データの列の順番は重要ではありません。

特徴量列は STRING、 NUMERIC、または BOOLEAN のいずれかである必要があります。STRING と BOOLEAN 列はカテゴリ特徴量として扱われ、 NUMERIC 列は連続特徴量とみなされます。数値列をカテゴリとして扱うには、 STRING にキャストします。

target_colname

トレーニングデータの各行のラベル（ターゲット値）を含む列の名前。ターゲット列は、 BOOLEAN、 NUMERIC、 STRING のいずれかです。

オプション

config_object

キーと値のペアで追加のトレーニングオプションを指定する OBJECT。

キー

型

デフォルト

説明

評価する

BOOLEAN

TRUE

評価メトリクスを生成すべきかどうか。TRUE の場合は、 evaluation_config のパラメーターを使用して、評価用モデルが追加でトレーニングされます。

on_error

STRING

'ABORT'

モデルトレーニングタスクのエラー処理メソッドを指定する文字列定数。サポートされる値は次のとおりです。

  • 'ABORT': 行のいずれかがエラーになった場合は、トレーニング操作全体を中止します。

  • 'SKIP': エラーが発生した行をスキップします。結果の代わりにエラーが表示されます。

evaluation_config

OBJECT

NULL

サンプル外評価メトリクスの生成方法を指定する、オプションの構成オブジェクト。現在、そのようなオプションは1つしかありません。

  • test_fraction （FLOAT）: テスト（評価）データとして使用するデータセットの割合。

評価構成が指定されていない場合、デフォルトの動作は、評価セットに少数クラスのインスタンスを最低500個含めるようにし、データセットの全テストの20%に制限します。このアプローチは、モデルの評価とトレーニングのバランスを保つもので、特に少数クラスのためのものです。

アクセス制御の要件

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

権限/ロール

オブジェクト

メモ

CREATE SNOWFLAKE.ML.CLASSIFICATION

スキーマ

予算の作成に使用されるロールには、予算を作成するスキーマに対するこの権限が付与されている必要があります。

OWNERSHIP

スキーマ

スキーマに既存のオブジェクトと同じ名前の仮オブジェクトを作成するには、ロールにオブジェクトの権限（OWNERSHIP）を付与するか継承する必要があります。

model_name !mladmin

SNOWFLAKE.ML.CLASSIFICATION インスタンス

このロールはモデル自体にスコープされ、最初は所有者に付与されます。所有者は、モデルのすべてのメソッドを呼び出すことを許可するために、他のユーザーにこのロールを付与することができます。 モデルロールと使用権限 をご参照ください。

model_name !mlconsumer

SNOWFLAKE.ML.CLASSIFICATION インスタンス

このロールはモデル自体にスコープされ、最初は所有者に付与されます。所有者は、モデルの予測メソッド（PREDICT など）を呼び出すことを許可するために、他のユーザーにこのロールを付与することができます。 モデルロールと使用権限 をご参照ください。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

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

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

例

例 をご参照ください。

言語: 日本語