SHOW CORTEX SEARCH SERVICES¶
アクセス権限のある Cortex Search services を一覧表示します。
構文¶
SHOW CORTEX SEARCH SERVICES
[ LIKE PATTERN '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
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サービスプロパティとメタデータが提供されます:
列 |
データ型 |
説明 |
---|---|---|
|
TIMESTAMP_LTZ |
Cortex Search Serviceの作成時間。 |
|
TEXT |
サービスの名前。 |
|
TEXT |
サービスが存在するスキーマ。 |
|
TEXT |
サービスが存在するデータベース。 |
|
TEXT |
サービス・リフレッシュに使用されるウェアハウス。 |
|
TEXT |
サービスのコンテンツがベーステーブルの更新から遅れる最大時間を指定します。 |
|
TEXT |
サービスに関連するコメント。 |
|
TEXT |
サービスの作成に使用される SQL クエリ。 |
|
TEXT |
検索列の名前。 |
|
TEXT |
サービス内の属性列のコンマ区切りリスト。 |
|
TEXT |
サービス内のカラムのカンマ区切りリスト. |
例¶
次の例は、 mydb
データベースの PUBLIC スキーマで、表示権限を持っているCortex Search serviceをリストします。
USE DATABASE mydb;
SHOW CORTEX SEARCH SERVICES;