Ativar e desativar a pesquisa vetorial

MySQL   |  PostgreSQL   |  SQL Server

Observação: Para usar a versão de disponibilidade geral (GA) da pesquisa vetorial do MySQL, a versão de manutenção da instância precisa ser a versão MYSQL_8_0_36.R20241208.01_00 ou mais recente. Para saber como fazer upgrade da instância para uma versão mais recente que ofereça suporte a embeddings de vetor de DG, consulte Realizar manutenção de autoatendimento.

Para informações sobre a sintaxe e o comportamento dos embeddings de vetor na versão de prévia desse recurso, consulte Trabalhar com embeddings de vetor (prévia).

Se você já estiver usando a versão de DG da pesquisa vetorial no Cloud SQL para MySQL 8.0 ou 8.4 e quiser fazer upgrade para o Cloud SQL para MySQL 9.7, então revise as diferenças no suporte vetorial do MySQL no Cloud SQL para MySQL 9.7 antes de fazer o upgrade da versão principal para o Cloud SQL para MySQL 9.7.

Nesta seção, descrevemos como configurar sua instância do Cloud SQL para permitir o armazenamento, a indexação e a consulta de embeddings de vetor.

As instâncias do Cloud SQL edição Enterprise e Cloud SQL edição Enterprise Plus são compatíveis com embeddings de vetor. Todas as versões do MySQL 8.0.36 e mais recentes são compatíveis.

Antes de começar

Verifique se você tem os papéis Administrador do Cloud SQL e Leitor do Compute na sua conta de usuário.

Para mais informações, consulte Papéis e permissões.

Ativar a funcionalidade de busca vetorial usando a flag de banco de dados

Para ativar o suporte ao armazenamento de embeddings de vetor no banco de dados no Cloud SQL para MySQL 8.4 e versões anteriores, ative a flag de banco de dados MySQL cloudsql_vector.

Se você estiver usando o Cloud SQL para MySQL 9.7 ou mais recente, ative a cloudsql_vector flag de banco de dados MySQL para adicionar suporte à criação de índices de vetor e à realização de pesquisas ANN

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

Substitua:

• INSTANCE_NAME: o nome da instância em que você quer ativar a funcionalidade de pesquisa vetorial.

• FLAGS: configure a seguinte flag do MySQL na instância:

  • cloudsql_vector: defina essa flag como on para ativar a funcionalidade de pesquisa vetorial do Cloud SQL. Essa flag está desativada por padrão. Ao configurar a flag, o comando fica semelhante a este:

    gcloud sql instances patch my-instance \
    --database-flags=cloudsql_vector=on
    

    A flag cloudsql_vector é estática. Depois de atualizar a instância com a flag (ativando ou desativando), ela será reiniciada automaticamente para que as mudanças de configuração entrem em vigor.

Para mais informações sobre como configurar flags de banco de dados para o MySQL, consulte Configurar flags de banco de dados.

Desativar embeddings de vetor

Antes de desativar embeddings de vetor na instância, é necessário remover explicitamente todos os índices de vetor na instância. Para saber como encontrar uma lista de índices de vetor na instância, consulte Monitorar índices de vetor.

A desativação do suporte a embeddings de vetor impede a criação de novas colunas de embeddings de vetor se você estiver usando o MySQL 8.4 ou versões anteriores. Se você estiver usando o MySQL 9.7 ou mais recente, não será possível criar índices de vetor. Isso também impede o uso da função approx_distance para pesquisas vetoriais. Para desativar o suporte a embeddings de vetor, defina a flag cloudsql_vector como off. Depois de configurar essa flag estática, a instância é reiniciada automaticamente para que a mudança na configuração entre em vigor.

Para desativar o suporte a embeddings de vetor, defina a flag cloudsql_vector como off.

Exemplo:

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

Substitua INSTANCE_NAME pelo nome da instância em que você está desativando o suporte a embeddings de vetor.

A seguir

• Leia a visão geral sobre a pesquisa vetorial no Cloud SQL.
• Saiba como gerar embeddings de vetor.
• Saiba como criar índices de vetor.
• Saiba como realizar pesquisas em embeddings de vetor.