SHOW VERSIONS IN MODEL

機械学習モデルのバージョンをリストします。モデルは複数のバージョンを持つことができ、そのうちの1つをデフォルトとして指定する必要があります(ALTER MODEL を参照)。

出力は、データベース、スキーマ、およびモデル名の辞書順に並べられたテーブルのメタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。

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

CREATE MODEL , DROP MODEL , ALTER MODEL, SHOW MODELS

構文

SHOW VERSIONS [ LIKE '<pattern>' ] IN MODEL <model_name>
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(% および _)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし(フィルタリングは出力に非適用)。

IN MODEL model_name

リストするバージョンを含むモデルの識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、識別子全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます(例: "My Object")。

モデル識別子が完全修飾されていない場合(db_name.schema_name.model_name または schema_name.model_name の形式)、コマンドは、セッションの現在のスキーマにあるモデルを探します。

出力

コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。

説明

created_on

モデルバージョンが作成された日時

name

バージョンの名前。

aliases

モデルバージョンのエイリアスがあれば、 ALTER MODEL を使用して割り当てたもの、および該当するシステムエイリアス(DEFAULT、 FIRST、または LAST) を含む。モデルのバージョンにエイリアスがない場合、この列には空の ARRAY ([])が含まれます。

database_name

バージョンが格納されているデータベース。

schema_name

バージョンが格納されているスキーマ。

model_name

このバージョンが属するモデルの名前。

is_default_version

このバージョンがモデルのデフォルトバージョンであるかどうかを示すブール値。

functions

このバージョンで使用可能な関数名の JSON 配列。

metadata

JSON メタデータをキーと値のペアとして含むオブジェクト(メタデータが指定されていない場合は {})。

user_data

モデル定義マニフェストの user_data セクションからの JSON オブジェクト(ユーザーデータが指定されていない場合は {})。

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者( ACCOUNTADMIN ロールを持つユーザー)とセキュリティ管理者( SECURITYADMIN ロールを持つユーザー)のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。このコマンドの出力をクエリするには、 パイプ演算子 を使用することもできます。