ALTER CORTEX SEARCH SERVICE

Modifica as propriedades de um Cortex Search Service existente.

Sintaxe

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name>
  { SUSPEND | RESUME } [ { INDEXING | SERVING } ]

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' } ]
  [ WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>' ];
Copy

Parâmetros

name

Especifica o identificador para o Cortex Search Service alterar.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

{ SUSPEND | RESUME } ...

Suspende ou retoma a indexação, a veiculação ou ambos para um Cortex Search Service. É possível especificar uma das seguintes palavras-chave para indicar qual camada suspender ou retomar:

INDEXING

O destino que indica a camada de indexação do Cortex Search Service. Para obter mais detalhes, consulte Notas de uso.

SERVING

O destino que indica a camada de serviço do Cortex Search Service. Para obter mais detalhes, consulte Notas de uso.

Se você não especificar nenhuma palavra-chave, as camadas de indexação e de veiculação serão suspensas ou retomadas.

SET ...

Define uma ou mais propriedades ou parâmetros especificados a serem definidas para o Cortex Search Service:

TARGET_LAG = 'num { seconds | minutes | hours | days }'

Especifica o tempo máximo que o conteúdo do Cortex Search Service deve ficar atrás das atualizações das tabelas base especificadas na consulta de origem.

WAREHOUSE = warehouse_name

Especifica o warehouse a ser usado para executar a consulta de origem, criar o índice de pesquisa e mantê-lo atualizado de acordo com o destino TARGET_LAG.

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para o serviço de pesquisa.

Requisitos de controle de acesso

Privilégio

Objeto

OWNERSHIP

Cortex Search Service no qual você deseja modificar as propriedades.

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

Atenção

Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Estados INDEXING e SERVING

INDEXING é o destino que indica a camada de indexação do Cortex Search Service. Quando estiver no estado RUNNING, as alterações nas tabelas base referenciadas pela consulta de origem do serviço solicitarão atualizações dos dados materializados armazenados como parte do índice de pesquisa. Essas atualizações geram custo na forma de computação de warehouse e incorporações vetoriais. No estado SUSPENDED, as alterações nas tabelas base não irão disparar atualizações nem serão refletidas nos dados consultáveis do Cortex Search Service.

SERVING é o destino que indica a camada de serviço do Cortex Search Service. Este destino deve estar no estado RUNNING para que o serviço possa ser consultado. Quando estiver no estado suspenso, o Cortex Search Service não incorrerá em faturamento na forma de custos do Cortex Search Service.

Para considerações detalhadas de custo, consulte Considerações sobre custo.

As camadas INDEXING e SERVING do Cortex Search Service podem ser gerenciadas de forma independente. Por exemplo, se SERVING estiver no estado de execução enquanto INDEXING estiver suspenso, ainda é possível consulta o serviço. No entanto, o serviço não refletirá nenhuma alteração nos dados base, independentemente do TARGET_LAG, até que o INDEXING seja retomado e uma atualização seja concluída com sucesso.

Por outro lado, se INDEXING estiver em execução enquanto SERVING estiver suspenso, o índice continuará sendo atualizado. Quando SERVING for retomado, o índice carregado que se torna consultável refletirá os dados de origem mais atualizados.

Quando as palavras-chave SERVING e INDEXING não forem especificadas, ambos os destinos serão afetados pela ação especificada.

Exemplos

O exemplo a seguir altera o warehouse usado pelo Cortex Search Service nomeado de mysvc para my_new_wh:

ALTER CORTEX SEARCH SERVICE mysvc SET WAREHOUSE = my_new_wh;
Copy

O exemplo a seguir define o campo de comentário do Cortex Search Service nomeado de mysvc para new_comment:

ALTER CORTEX SEARCH SERVICE mysvc SET COMMENT = 'new_comment';
Copy

O exemplo a seguir altera o atraso de atualização de destino do Cortex Search Service nomeado de mysvc para 1 hour:

ALTER CORTEX SEARCH SERVICE mysvc SET TARGET_LAG = '1 hour';
Copy

O exemplo a seguir suspende a veiculação de um Cortex Search Service nomeado mysvc;

ALTER CORTEX SEARCH SERVICE mysvc SUSPEND SERVING;
Copy
Linguagem: Português