Alta affidabilità multiregionale

Deployment ad alta affidabilità

Quando utilizzi il servizio Agent Retrieval nella multiregione us, puoi usufruire di uno SLA di disponibilità più elevato e di un uptime continuo anche in caso di interruzione a livello di regione.

La località multiregionale us fornisce la stessa API del resto di Agent Retrieval, con alcune limitazioni. I tuoi dati nella località multiregionale us vengono replicati nelle regioni degli Stati Uniti continentali e tutti gli indici attivi nella località multiregionale us hanno server ridondanti di cui è stato eseguito il provisioning in ciascuna di queste regioni. In condizioni operative normali, le query vengono gestite dalla regione con la latenza ottimale per il client di rete. In caso di interruzione o perdita della capacità di gestione, il bilanciatore del carico di Google reindirizzerà la query alla regione disponibile più vicina. La configurazione e la manutenzione del bilanciamento del carico e della replica sono gestite interamente da Agent Retrieval.

NOTA: dato l'impegno di risorse hardware e di progettazione necessarie per supportare il recupero agentico con alta affidabilità, i progetti dei clienti possono essere inseriti nella multi-regione ad alta affidabilità solo dopo essere stati specificamente esaminati e inseriti nella lista consentita. Per richiedere l'accesso alla multi-regione ad alta affidabilità, compila il modulo di richiesta collegato.

Onboarding

Devi richiedere l'inserimento nella lista consentita per accedere alla multiregione ad alta affidabilità.

Dopo aver ricevuto la conferma che il tuo progetto è stato inserito nella lista consentita per l'accesso alla multi-regione ad alta affidabilità, puoi creare nuove raccolte, oggetti dati e indici nella località multi-regionale us. Segui la documentazione standard dell'API Agent Retrieval, sostituendo us dove normalmente specifichi una singola regione (ad esempio us-central1 o europe-central2).

Tutti i dati caricati e le operazioni eseguite nella regione multiregione us beneficiano di replica, ridondanza e disponibilità migliorate.

Fatturazione

Le tariffe di fatturazione per la località multi-regione sono superiori a quelle della singola regione standard, riflettendo i maggiori costi di replica e la priorità operativa più elevata.

Per i dettagli, consulta Prezzi.

Limitazioni

Ottimizzato per l'archiviazione non è implementato. Solo gli indici di livello Ottimizzato per le prestazioni possono essere sottoposti a deployment nella località multiregionale.

Le chiamate SearchDataObjects agli indici su vettori di embedding non normalizzati potrebbero segnalare metriche di distanza impreviste nella località multiregionale. Il recupero e il ranking dei punti dati da questi indici saranno corretti (nei limiti di un indice dei vicini più prossimi approssimativo). Ti consigliamo di fornire sempre vettori di embedding normalizzati o di fare affidamento sulla generazione automatica di embedding.

Solo DOT_PRODUCT_DISTANCE è supportato nella località multiregionale.

Gli embedding sparsi non sono supportati nella località multiregionale. Per le richieste di Vector Search in cui devono essere presenti token specifici in determinati campi, è possibile utilizzare l'operatore $search nell'espressione di filtro della richiesta.

Il campo Index.dedicated_infrastructure.autoscaling_spec nelle richieste CreateIndex e UpdateIndex non viene utilizzato nella località multiregionale.

Il campo SearchHint.IndexHint.dense_scann_params in SearchDataObjectsRequests non viene utilizzato nella località multiregionale. Gli indici ANN multiregionali sono ottimizzati per fornire un richiamo di circa il 95%, anche se questo può variare in base alle specifiche dei tuoi dati.

Esegui la migrazione da un deployment a livello di regione

Se hai dati in una raccolta di recupero agentico regionale, puoi utilizzare il seguente flusso di lavoro di alto livello per clonarli nella località us:

  • Esporta i dati della raccolta in un bucket nella regione che ospita la raccolta, rimuovendo gli etag.
  • Importa dal bucket in una raccolta ospitata nella località us.

Prima di iniziare

Assicurati di avere:

  • Un bucket nella regione di origine, da utilizzare come area di gestione temporanea per l'esportazione.
  • L'interfaccia a riga di comando gcloud installata.
  • Autorizzazione IAM di lettura sulla raccolta di origine, di scrittura sulla destinazione, di lettura e scrittura sul bucket.
  • Una raccolta di destinazione già creata in us con lo stesso schema dell'origine.

PROJECT_ID: il progetto che contiene la raccolta di cui eseguire la migrazione. I seguenti comandi presuppongono che il progetto di origine e quello di destinazione siano gli stessi.

SOURCE_LOCATION: la località della raccolta di origine, ad esempio us-central1.

SOURCE_COLLECTION: il nome della raccolta di cui eseguire la migrazione.

STAGING_BUCKET: il percorso di una directory all'interno di un bucket in cui vuoi esportare i dati della raccolta, ad esempio gs://your-bucket-id.

Procedura

Ogni snippet può essere copiato e incollato. Sostituisci i segnaposto nella parte superiore di ogni blocco con valori specifici per il progetto, la località di origine, la raccolta e i bucket.

1. Esporta dalla regione di origine

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"

La risposta include un nome dell'operazione come projects/.../locations/us-central1/operations/operation-.... Esegui il polling fino al giorno "done": true.

EXPORT_OPERATION_NAME

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

2. Importazione negli Stati Uniti

DEST_COLLECTION: il nome della raccolta dopo la migrazione (può essere lo stesso del nome originale).

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

Esegui il polling dell'operazione restituita nello stesso modo dell'esportazione:

IMPORT_OPERATION_NAME

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

3. Verifica l'importazione

  • Controlla gs://your-bucket-uscentral1/import-errors/ per verificare se sono presenti record rifiutati.
  • Confronta i conteggi dei record tra l'origine e la destinazione.
  • Esegui alcune query note su entrambi e confronta i risultati.