SHOW VERSIONS IN MODEL¶
機械学習モデルのバージョンをリストします。モデルは複数のバージョンを持つことができ、そのうちの1つをデフォルトとして指定する必要があります(ALTER MODEL を参照)。
出力は、データベース、スキーマ、およびモデル名の辞書順に並べられたテーブルのメタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。
- こちらもご参照ください。
構文¶
SHOW VERSIONS [ LIKE '<pattern>' ] IN MODEL <model_name>
パラメーター¶
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 |
モデル定義マニフェストの |
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者( ACCOUNTADMIN ロールを持つユーザー)とセキュリティ管理者( SECURITYADMIN ロールを持つユーザー)のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。このコマンドの出力をクエリするには、 パイプ演算子 を使用することもできます。