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 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 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