Ative e desative as incorporações vetoriais na sua instância

Esta secção descreve como configurar a sua instância do Cloud SQL para suportar o armazenamento, a indexação e a consulta de incorporações vetoriais.

As instâncias da edição Enterprise do Cloud SQL e da edição Enterprise Plus do Cloud SQL suportam incorporações vetoriais. Todas as versões do MySQL 8.0.36 e posteriores são suportadas.

Antes de começar

Certifique-se de que tem as funções de administrador do Cloud SQL e leitor do Compute na sua conta de utilizador.

Para mais informações, consulte o artigo Funções e autorizações.

Ative a flag da base de dados para incorporações vetoriais

Para ativar o suporte para incorporações vetoriais, tem de ativar as flags da base de dados MySQL.

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância na qual quer ativar o suporte de incorporação de vetores.

  • FLAGS: configure a seguinte flag do MySQL na sua instância:

    • cloudsql_vector: defina esta flag como on para ativar o armazenamento de incorporação de vetores e o suporte de pesquisa de similaridade de vetores. Esta flag está desativada por predefinição. Quando configura a flag, o comando tem um aspeto semelhante ao seguinte:

      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-a ou desativando-a), a instância é reiniciada automaticamente para que as alterações de configuração entrem em vigor.

Para mais informações sobre como configurar flags de base de dados para o MySQL, consulte o artigo Configure flags de base de dados.

Desative as incorporações vetoriais

Antes de desativar as incorporações vetoriais na sua instância, tem de eliminar explicitamente todos os índices vetoriais na instância. Para saber como encontrar uma lista de índices vetoriais na instância, consulte o artigo Monitorizar índices vetoriais.

A desativação do suporte de incorporações vetoriais impede a criação de novas colunas de incorporações vetoriais e índices vetoriais. Também impede a utilização da função approx_distance para pesquisas vetoriais. Para desativar o suporte para incorporações de vetores, defina a flag cloudsql_vector como off. Depois de configurar esta flag estática, a instância é reiniciada automaticamente para que a alteração de configuração entre em vigor.

Para desativar o suporte para incorporações vetoriais, defina a flag cloudsql_vector como off.

Por exemplo:

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

Substitua INSTANCE_NAME pelo nome da instância na qual está a desativar o suporte de incorporação vetorial.

O que se segue?