SHOW MODELS

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

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

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

CREATE MODEL、 DROP MODEL、 ALTER MODEL、 SHOW VERSIONS IN MODEL

構文

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 を指定すると、コマンドは、指定されたデータベースのスキーマすべての記録を取得します。

  • db_name を指定しない場合は、次のようになります。

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとスキーマの記録を取得します。

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

  • 修飾されたスキーマ名（例: my_database.my_schema）を指定すると、コマンドは、指定されたデータベースとスキーマの記録を取得します。

  • 修飾されていない schema_name を指定すると、次のようになります。

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにある指定されたスキーマの記録を取得します。

    • 現在のデータベースがない場合、コマンドは、エラー SQL compilation error: Object does not exist, or operation cannot be performed を表示します。

  • schema_name を指定しない場合は、次のようになります。

    • 現在のデータベースがある場合は、次のようになります。

      • 現在のスキーマがある場合、コマンドは、現在のデータベースにある現在のスキーマの記録を取得します。

      • 現在のスキーマがない場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとすべてのスキーマの記録を取得します。

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

  • データベース: DATABASE がデフォルトです（つまり、コマンドは、現在のデータベースで表示する権限を持つモデルを返します）。

  • データベースなし: アカウントスコープはデフォルトです（つまり、コマンドは、アカウントで表示する権限を持つモデルを返します）。

出力

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

列

説明

created_on

モデルが作成された日時。

name

モデルの名前。

database_name

モデルが格納されているデータベース。

schema_name

モデルが格納されているスキーマ。

owner

モデルを所有するロールの名前。

comment

モデルのコメント。

versions

モデルのバージョンをリストした JSON 配列。

default_version_name

バージョンを指定せずにモデルを参照する場合に使用されるモデルのバージョン。

使用上の注意

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

言語: 日本語