Alta disponibilidade multirregional

Implantação de alta disponibilidade

Ao usar o serviço de recuperação de agentes na multirregião us, você se beneficia de um SLA de disponibilidade de serviço mais forte e de um tempo de atividade contínuo, mesmo no caso de uma interrupção regional.

A multirregião us oferece a mesma API que o restante da Recuperação de Agentes, com algumas limitações. Seus dados no local multirregional us são replicados para regiões em todo o território continental dos Estados Unidos, e todos os índices ativos na multirregião us têm servidores redundantes provisionados em cada uma dessas regiões. Em condições normais de operação, as consultas são exibidas na região em que o cliente de rede tem latência ideal. No caso de uma interrupção ou perda de capacidade de exibição, o balanceador de carga do Google redirecionará sua consulta para a região disponível mais próxima. A configuração e a manutenção do balanceamento de carga e da replicação são totalmente gerenciadas pela Recuperação de Agentes.

OBSERVAÇÃO: devido ao compromisso de recursos de hardware e engenharia necessários para oferecer suporte à recuperação de agentes com alta disponibilidade, os projetos dos clientes só podem ser integrados à multirregião de alta disponibilidade depois de serem especificamente avaliados e incluídos na lista de permissões. Para solicitar acesso à multirregião de alta disponibilidade, preencha o formulário de solicitação vinculado.

Integração

É preciso solicitar a inclusão na lista de permissões para acessar a multirregião de alta disponibilidade.

Depois de receber a confirmação de que seu projeto foi incluído na lista de permissões para acessar a multirregião de alta disponibilidade, você poderá criar novas coleções, objetos de dados e índices no local multirregional us. Siga a documentação padrão da API Agent Retrieval, substituindo us onde você normalmente especificaria uma única região (como us-central1 ou europe-central2).

Todos os dados enviados e as operações realizadas na multirregião us se beneficiam da replicação, redundância e maior disponibilidade aprimoradas.

Faturamento

As taxas de faturamento para o local multirregional são mais altas do que para a região única padrão, refletindo os custos maiores de replicação e a prioridade operacional mais alta.

Para mais detalhes, consulte Preços.

Limitações

A otimização para armazenamento não está implementada. Somente os índices do nível de desempenho otimizado podem ser implantados no local multirregional.

As chamadas de SearchDataObjects para índices em vetores de embedding não normalizados podem informar métricas de distância inesperadas no local multirregional. A recuperação e a classificação de pontos de dados desses índices estarão corretas (dentro das limitações de um índice de vizinho mais próximo aproximado). Recomendamos que você sempre forneça vetores de embedding normalizados ou use a geração automática de embeddings.

Somente DOT_PRODUCT_DISTANCE é compatível no local multirregional.

Não há suporte para embeddings esparsos no local multirregional. Para solicitações de busca vetorial em que tokens específicos precisam estar presentes em determinados campos, o operador $search pode ser usado na expressão de filtro da solicitação.

O campo Index.dedicated_infrastructure.autoscaling_spec nas solicitações CreateIndex e UpdateIndex não é usado no local multirregional.

O campo SearchHint.IndexHint.dense_scann_params em SearchDataObjectsRequests não é usado no local multirregional. Os índices ANN multirregionais são ajustados para fornecer aproximadamente 95% de recall, embora o recall possa variar de acordo com as especificidades dos seus dados.

Migrar de uma implantação regional

Se você tiver dados em uma coleção regional de recuperação de agentes, o seguinte fluxo de trabalho de alto nível poderá ser usado para clonar esses dados no local us:

  • Exportar os dados da coleção para um bucket na região que hospeda a coleção, removendo as etags.
  • Importe do bucket para uma coleção hospedada no local us.

Antes de começar

Verifique se você tem:

  • Um bucket na região de origem, que será usado como área de preparo de exportação.
  • A CLI gcloud instalada.
  • Permissão do IAM de leitura na coleção de origem, gravação no destino, leitura e gravação no bucket.
  • Uma coleção de destino já criada no us com o mesmo esquema da origem.

PROJECT_ID: o projeto que contém a coleção a ser migrada. Os comandos a seguir pressupõem que os projetos de origem e destino são os mesmos.

SOURCE_LOCATION: o local da coleção de origem, como us-central1.

SOURCE_COLLECTION: o nome da coleção a ser migrada.

STAGING_BUCKET: o caminho para um diretório em um bucket para o qual você quer exportar os dados da coleção, como gs://your-bucket-id.

Etapas

Cada snippet pode ser copiado e colado. Substitua os marcadores de posição na parte de cima de cada bloco por valores específicos do projeto, do local de origem, da coleção e dos buckets.

1. Exportar da região de origem

cat > request.json <<EOF
{
  "gcsDestination": {
    "exportUri": "STAGING_BUCKET/export/",
    "format": "JSONL"
  },
  "field_filter": {
    "excluded_fields": {
      "fields": ["etag"]
    }
  }
}
EOF

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d @request.json \
  "https://vectorsearch.googleapis.com/v1/projects/PROJECT_ID/locations/SOURCE_LOCATION/collections/SOURCE_COLLECTION:exportDataObjects"

A resposta inclui um nome de operação como projects/.../locations/us-central1/operations/operation-.... Faça uma sondagem até "done": true.

EXPORT_OPERATION_NAME

gcloud vector-search operations describe "EXPORT_OPERATION_NAME" \
  --location="SOURCE_LOCATION"

2. Importar para os EUA

DEST_COLLECTION: o nome da coleção após a migração (pode ser o mesmo que o nome original).

gcloud vector-search collections import-data-objects "DEST_COLLECTION" \
  --location="us" \
  --project="PROJECT_ID" \
  --gcs-import-contents-uri="STAGING_BUCKET/export/" \
  --gcs-import-error-uri="STAGING_BUCKET/import-errors/" \
  --gcs-import-output-uri="STAGING_BUCKET/import-output/" \
  --async

Consulte a operação retornada da mesma forma que a exportação:

IMPORT_OPERATION_NAME

gcloud vector-search operations describe "IMPORT_OPERATION_NAME" \
  --location="us"

3. Verificar a importação

  • Verifique se há registros rejeitados em gs://your-bucket-uscentral1/import-errors/.
  • Compare as contagens de registros entre a origem e o destino.
  • Execute algumas consultas conhecidas em ambos e compare os resultados.