SHOW MODELS¶

アクセス権限のある機械学習モデルをリストします。

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

構文¶

SHOW MODELS [ LIKE '<pattern>' ]
            [ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]

Copy

LIKE 'pattern'

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

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

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

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

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

IN DATABASE [ db_name ] | SCHEMA [ schema_name ]

必要に応じて、コマンドのスコープを指定します。これは、コマンドがモデルを現在/指定のデータベースまたはスキーマのみにリストするか、アカウント全体に表示するかを決定します。

キーワード ACCOUNT を指定すると、コマンドは、現在のアカウントのデータベースすべてにあるすべてのスキーマの記録を取得します。

キーワード DATABASE を指定すると、次のようになります。

db_name を指定すると、コマンドは、指定されたデータベースのスキーマすべての記録を取得します。
:samp:`{db_name}`を指定しない場合、以下のようになります：
- 現在のデータベースがある場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。
- 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとスキーマの記録を取得します。

キーワード SCHEMA を指定すると、次のようになります。

修飾されたスキーマ名（例: my_database.my_schema）を指定すると、コマンドは、指定されたデータベースとスキーマの記録を取得します。
修飾されていない schema_name を指定すると、次のようになります。
- 現在のデータベースがある場合、コマンドは、現在のデータベースにある指定されたスキーマの記録を取得します。
- 現在のデータベースがない場合、コマンドは、エラー SQL compilation error: Object does not exist, or operation cannot be performed を表示します。
:samp:`{schema_name}`を指定しない場合、以下のようになります：
- 現在のデータベースがある場合は、次のようになります。
  - 現在のスキーマがある場合、コマンドは、現在のデータベースにある現在のスキーマの記録を取得します。
  - 現在のスキーマがない場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。
- 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとすべてのスキーマの記録を取得します。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

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

列	説明
created_on	モデルが作成された日時。
name	モデルの名前。
model_type	モデル型。ユーザーコードを含むモデルには USER_MODEL 、 Cortex Fine-tuning で作成されたモデルには CORTEX_FINETUNED です。
database_name	モデルが格納されているデータベース。
schema_name	モデルが格納されているスキーマ。
owner	モデルを所有するロールの名前。
comment	モデルのコメント。
versions	モデルのバージョンをリストした JSON 配列。
default_version_name	バージョンを指定せずにモデルを参照する場合に使用されるモデルのバージョン。
aliases	モデルバージョンのエイリアスを対応するモデルバージョン名にマッピングする SQL オブジェクト。

結果は、データベース名、スキーマ名、そしてモデル名の順に並べ替えられます。これは、データベースの結果に複数のスキーマからのモデルが含まれる可能性があり、ページネーションの崩れる可能性があることを意味します。ページネーションが期待通りに動作するためには、単一のスキーマに対して SHOW MODELS ステートメントを実行する必要があります。SHOW MODELS コマンドに IN SCHEMA schema_name パラメーターを使用することができます。あるいは、 SHOW MODELS を実行する前に USE SCHEMA schema_name を実行すると、現在のコンテキストでスキーマを使用することができます。

このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。