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 saber como fazer upgrade da sua instância para uma versão mais recente que seja compatível com embeddings de vetor GA, consulte Manutenção de autoatendimento.

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

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 Enterprise e do Cloud SQL Enterprise Plus são compatíveis com embeddings de vetor. Todas as versões do MySQL 8.0.36 ou 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 habilitar 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 assim:

    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 os embeddings de vetor na sua instância, é preciso remover explicitamente todos os índices de vetor nela. Para saber como encontrar uma lista de índices de vetor na instância, consulte Monitorar índices de vetor.

Desativar o suporte a embeddings de vetor impede que você crie novas colunas de embeddings de vetor e índices de vetor. Ele 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 vetorial no Cloud SQL.
• Saiba como gerar embeddings de vetor.
• Saiba como criar índices de vetor.
• Saiba como fazer pesquisas em embeddings de vetores.