SHOW CORTEX SEARCH SERVICES

Lista os Cortex Search Services para os quais você tem privilégios de acesso.

Sintaxe

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

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

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

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

STARTS WITH 'name_string'

Opcionalmente, filtra a saída do comando com base nos caracteres que aparecem no início do nome do objeto. A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.

Por exemplo, as seguintes cadeias de caracteres retornam resultados diferentes:

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

. Padrão: sem valor (nenhuma filtragem é aplicada à saída)

LIMIT rows [ FROM 'name_string' ]

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. O número real de linhas retornadas pode ser menor que o limite especificado. Por exemplo, o número de objetos existentes é menor que o limite especificado.

A subcláusula opcional FROM 'name_string' serve efetivamente como um “cursor” para os resultados. Isso permite obter o número especificado de linhas seguindo a primeira linha cujo nome do objeto corresponde à cadeia de caracteres especificada:

  • A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.

  • A cadeia de caracteres não precisa incluir o nome completo do objeto; também é permitido usar nomes parciais.

Padrão: nenhum valor (nenhum limite é aplicado à saída)

Nota

Para comandos SHOW que oferecem suporte às cláusulas FROM 'name_string' e STARTS WITH 'name_string', você pode combinar ambas as cláusulas na mesma instrução. No entanto, ambas as condições devem ser cumpridas ou elas se cancelam mutuamente e nenhum resultado é retornado.

Além disso, os objetos são devolvidos em ordem lexicográfica por nome, portanto FROM 'name_string' só retorna linhas com um valor lexicográfico maior que as linhas retornadas por STARTS WITH 'name_string'.

Por exemplo:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' não retornaria nenhum resultado.

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' não retornaria nenhum resultado.

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' retornariam resultados (se alguma linha corresponder às cadeias de caracteres de entrada).

Saída

A saída do comando fornece as propriedades e metadados do Cortex Search Service nas seguintes colunas:

Coluna

Tipo de dados

Descrição

created_on

TIMESTAMP_LTZ

Hora de criação do Cortex Search Service.

name

TEXT

Nome do serviço.

schema_name

TEXT

O esquema no qual o serviço reside.

database_name

TEXT

O banco de dados no qual o serviço reside.

warehouse

TEXT

O warehouse usado para atualizações de serviço.

target_lag

TEXT

O tempo máximo que o conteúdo do serviço deve ficar atrasado em relação às atualizações das tabelas base.

comment

TEXT

Quaisquer comentários associados ao serviço.

definition

TEXT

Consulta SQL usada para criar o serviço.

search_column

TEXT

Nome da coluna de pesquisa.

attribute_columns

TEXT

Lista separada por vírgulas de colunas de atributo no serviço.

columns

TEXT

Lista de colunas separadas por vírgulas no serviço.

Exemplos

O exemplo a seguir lista o Cortex Search Service que você tem privilégios para exibir no esquema PUBLIC do banco de dados mydb:

USE DATABASE mydb;

SHOW CORTEX SEARCH SERVICES;
Copy