Ativar e desativar a pesquisa vetorial

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+ são compatíveis.

Antes de começar

Verifique se você tem os papéis de 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 flag de banco de dados cloudsql_vector do 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 sua instância:

    • cloudsql_vector: defina essa flag como on para ativar a funcionalidade de pesquisa vetorial do Cloud SQL. Essa sinalização 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 alterações 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 instância, é preciso eliminar 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.

Se você estiver usando o MySQL 8.4 ou anterior, desativar o suporte a embeddings de vetor impede que você crie novas colunas de embeddings de vetor. Se você estiver usando o MySQL 9.7 ou mais recente, não será possível criar í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