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 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。
出力列を参照する場合は、列名に:ref:
二重引用符<label-delimited_identifier>`で囲まれた識別子を使用します。たとえば、出力列 ``type`を選択するには、SELECT "type"を指定します。SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。