Ativar e desativar embeddings de vetor na sua instância

MySQL   |  PostgreSQL   |  SQL Server

Para usar a versão GA da pesquisa vetorial, a versão de manutenção da instância precisa ser MYSQL_8_0_version.R20241208.01_00 ou mais recente, em que "versão" é o número da versão secundária. Para informações sobre como fazer upgrade da sua instância para uma versão mais recente que ofereça suporte a incorporações de vetor do GA, consulte Manutenção de autoatendimento.

Para informações sobre a sintaxe e o comportamento de embeddings vetoriais para a versão de visualização pública desse recurso, consulte Trabalhar com embeddings vetoriais (pré-lançamento).

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 do 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 flag do banco de dados para embeddings de vetor

Para ativar o suporte a embeddings de vetor, é preciso ativar as flags do banco de dados MySQL.

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

Substitua:

• INSTANCE_NAME: o nome da instância em que você quer ativar o suporte a embeddings de vetor.

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

  • cloudsql_vector: defina essa flag como on para ativar o suporte a armazenamento de embeddings de vetor e pesquisa de similaridade de vetor. Essa flag fica desativada por padrão. Quando você configura a flag, o comando fica parecido com 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 é 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 as inclusões de vetor na sua instância, você precisa excluir 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 e índices de vetor. Isso também impede que você use a 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 de vetor no Cloud SQL.
• Saiba como gerar embeddings de vetor.
• Saiba como criar índices de vetor.
• Saiba como realizar pesquisas em embeddings vetoriais.