Modificare il quorum a due regioni

Questa pagina descrive come controllare lo stato di integrità del quorum a due regioni di Spanner e come modificare manualmente il quorum in caso di interruzioni del servizio.

Per saperne di più sulle regioni doppie, consulta Configurazione delle istanze a due regioni di Spanner .

Controllare lo stato del quorum a due regioni

Puoi controllare lo stato del quorum a due regioni nei seguenti modi:

Nella pagina Panoramica database

  1. Vai alla pagina Istanze Spanner nella Google Cloud console.

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza con una configurazione a due regioni.

  3. Fai clic sul nome del database.

  4. In Panoramica, cerca la riga Quorum, che mostra lo stato del quorum a due regioni dell'istanza:

    • Se il quorum viene raggiunto in entrambe le regioni, lo stato mostra Due regioni.

    • Se è stato eseguito un failover manuale o gestito da Google, vedrai il nome della regione di pubblicazione (ad esempio, asia-south1).

Utilizzare la dashboard Informazioni sul sistema

Dopo aver creato una configurazione a due regioni, puoi visualizzare la metrica Sequenza temporale dell'integrità del quorum a due regioni nella dashboard Informazioni sul sistema a livello di istanza.

Per saperne di più, consulta Visualizzare la dashboard Informazioni sul sistema.

Utilizzare l'API REST di Monitoring o gcloud CLI

Puoi utilizzare l'API REST di Monitoring o gcloud CLI per controllare l'integrità del quorum a due regioni.

API REST di Monitoring

Utilizza l'API projects.timeSeries.list di Monitoring per eseguire query sulla sequenza temporale dell'integrità del quorum a due regioni e verificare se una regione è integra in un determinato momento.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: il tuo ID progetto.
  • DUAL_REGION_LOCATION: la posizione della regione nell'area a due regioni che vuoi controllare.
  • START_TIME: l'ora di inizio della query. Ti consigliamo di utilizzare 5 minuti prima dell'ora corrente.
  • END_TIME: l'ora di fine della query. Ti consigliamo di utilizzare l'ora corrente.

Metodo HTTP e URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries

Corpo JSON della richiesta: 

{
  "name": "PROJECT_ID",
  "aggregation.alignmentPeriod": "60s",
  "aggregation.crossSeriesReducer": "REDUCE_FRACTION_TRUE",
  "aggregation.groupByFields": "resource.labels.location",
  "aggregation.perSeriesAligner": "ALIGN_NEXT_OLDER",
  "filter": "metric.labels.quorum_availability = "Healthy" AND metric.type = "spanner.googleapis.com/instance/dual_region_quorum_availability" AND resource.labels.location = "DUAL_REGION_LOCATION"",
  "interval.startTime": "START_TIME",
  "interval.endTime": "END_TIME"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "timeSeries": [
    {
      "metric": {
        "type": "spanner.googleapis.com/instance/dual_region_quorum_availability"
      },
      "resource": {
        "type": "spanner_instance",
        "labels": {
          "project_id": "spanner-project",
          "location": "australia-southeast1"
        }
      },
      "metricKind": "GAUGE",
      "valueType": "DOUBLE",
      "points": [
        {
          "interval": {
            "startTime": "2024-07-11T05:41:23Z",
            "endTime": "2024-07-11T05:41:23Z"
          },
          "value": {
            "doubleValue": 1
          }
        }
      ]
    }
  ],
  "unit": "10^2.%"
}

Se non vedi una risposta simile, la tua regione potrebbe non essere integra e potresti dover modificare il quorum a due regioni da due regioni a una singola regione.

gcloud CLI

  1. Scarica il dual-region-quorum-health-check-script.sh file.

    Questo script bash controlla l'integrità della regione della tua singola regione. Se la regione è integra, lo script esegue il gcloud spanner databases change-quorum comando per eseguire manualmente il failover del quorum a due regioni da due regioni a una singola regione.

  2. Sostituisci le seguenti variabili nello script:

    • PROJECT: il tuo ID progetto.
    • INSTANCE: il tuo ID istanza.
    • DATABASE: il tuo ID database.
    • SERVING_LOCATION: la posizione della regione nell'area a due regioni che vuoi controllare.

  3. Esegui lo script nell'ambiente di sviluppo che preferisci. Per saperne di più, consulta Installare gcloud CLI e configurare l'API Spanner.

  4. Esegui manualmente il failback se la tua regione non era integra e si è verificato un failover.

Modificare il quorum a due regioni da due regioni a una singola regione (failover)

Per eseguire manualmente il failover in caso di interruzione regionale o di un problema di partizionamento della rete:

Google Cloud Console

  1. Vai alla pagina Istanze Spanner nella Google Cloud console.

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza con una configurazione a due regioni.

  3. Fai clic su Informazioni sul sistema nel menu di navigazione.

  4. Trova la metrica Sequenza temporale dell'integrità del quorum a due regioni.

  5. Se la sequenza temporale dell'integrità del quorum a due regioni mostra un'interruzione in una regione, fai clic su Modifica quorum regione.

    Si apre Cloud Shell.

  6. Per modificare il quorum a due regioni da due regioni a una singola regione, inserisci il seguente comando nella scheda gcloud CLI: gcloud spanner databases change-quorum. Per istruzioni dettagliate, consulta la scheda gcloud.

gcloud CLI

Utilizza il gcloud spanner databases change-quorum comando per modificare il quorum a due regioni da due regioni a una singola regione.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --single-region --serving-location=SERVING_LOCATION
    [--etag=ETAG]

Sostituisci quanto segue:

  • DATABASE_ID: l'identificatore permanente del database.

  • INSTANCE_ID: l'identificatore permanente dell'istanza.

  • SERVING_LOCATION: la configurazione dell'istanza regionale a cui vuoi eseguire il failover. Ad esempio, se asia-south1 (Mumbai) non è integra e vuoi eseguire il failover a asia-south2 (Delhi), inserisci asia-south2. Assicurati che SERVING_LOCATION sia la regione integra. La scelta di una regione errata per il failover comporta l'indisponibilità del database, che non è recuperabile prima che la regione torni online.

Flag facoltativi:

  • --etag=ETAG: l'ETAG argomento può essere utilizzato per la protezione di riproduzione.

Per controllare lo stato dell'operazione di modifica del quorum, esegui il gcloud spanner databases describe comando. Il campo quorumInfo fornisce informazioni sull'operazione.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Modificare il quorum a due regioni da una singola regione a due regioni (failback)

Per eseguire manualmente il failback dopo che la regione interrotta è integra o dopo che il problema di partizionamento della rete è stato risolto:

Google Cloud Console

  1. Vai alla pagina Istanze Spanner nella Google Cloud console.

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza con una configurazione a due regioni.

  3. Fai clic su Informazioni sul sistema nel menu di navigazione.

  4. Trova la metrica Sequenza temporale dell'integrità del quorum a due regioni.

  5. Nella sequenza temporale dell'integrità del quorum a due regioni, fai clic su Modifica quorum regione.

    Si apre Cloud Shell.

  6. Per modificare il quorum a due regioni da una singola regione a due regioni, inserisci il seguente comando nella scheda gcloud CLI: gcloud spanner databases change-quorum. Per istruzioni dettagliate, consulta la scheda gcloud.

gcloud CLI

Utilizza il gcloud spanner databases change-quorum comando per modificare il quorum a due regioni da una singola regione a due regioni.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --dual-region
    [--etag=ETAG]

Sostituisci quanto segue:

  • DATABASE_ID: l'identificatore permanente del database.

  • INSTANCE_ID: l'identificatore permanente dell'istanza.

Flag facoltativi:

  • --etag=ETAG: l'ETAG argomento può essere utilizzato per controllo della contemporaneità ottimistica.

Per controllare lo stato dell'operazione di modifica del quorum, esegui il gcloud spanner databases describe comando. Il campo quorumInfo fornisce informazioni sull'operazione.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Passaggi successivi