Ativar e desativar embeddings de vetor na sua instância

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, é necessário 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