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