SHOW CORTEX SEARCH SERVICES

アクセス権限のある Cortex Search services を一覧表示します。

構文

SHOW CORTEX SEARCH SERVICES
  [ LIKE PATTERN '<pattern>' ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

パラメーター

LIKE 'pattern'

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

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

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

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

STARTS WITH 'name_string'

オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します

たとえば、次の文字列は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. デフォルト: 値なし(フィルターは出力に適用されない)

LIMIT rows [ FROM 'name_string' ]

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト:値なし(出力に制限は適用されない)

注釈

FROM 'name_string' 句と STARTS WITH 'name_string' 句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

例:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します(入力文字列に一致する行がある場合)。

出力

コマンド出力では、次の列にCortex Searchサービスプロパティとメタデータが提供されます:

データ型

説明

created_on

TIMESTAMP_LTZ

Cortex Search Serviceの作成時間。

name

TEXT

サービスの名前。

schema_name

TEXT

サービスが存在するスキーマ。

database_name

TEXT

サービスが存在するデータベース。

warehouse

TEXT

サービス・リフレッシュに使用されるウェアハウス。

target_lag

TEXT

サービスのコンテンツがベーステーブルの更新から遅れる最大時間を指定します。

comment

TEXT

サービスに関連するコメント。

definition

TEXT

サービスの作成に使用される SQL クエリ。

search_column

TEXT

検索列の名前。

attribute_columns

TEXT

サービス内の属性列のコンマ区切りリスト。

columns

TEXT

サービス内のカラムのカンマ区切りリスト.

次の例は、 mydb データベースの PUBLIC スキーマで、表示権限を持っているCortex Search serviceをリストします。

USE DATABASE mydb;

SHOW CORTEX SEARCH SERVICES;
Copy