Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizza il ripristino di emergenza (DR) avanzato

MySQL | PostgreSQL | SQL Server

Questa pagina descrive come utilizzare il ripristino di emergenza (DR) avanzato. RE avanzata offre due funzionalità principali:

Il failover della replica consente di eseguire il failover dell'istanza principale alla replica di DR immediatamente in caso di guasto regionale.
Il cambio ti consente di invertire i ruoli dell'istanza principale e una replica di RE senza perdita di dati. Puoi utilizzare lo switchover per ripristinare lo stato di deployment originale di un deployment dopo il failover della replica oppure per testare il DR.

La RE avanzata è supportata solo sulle istanze della versione Cloud SQL Enterprise Plus.

Prima di iniziare

Se prevedi di utilizzare Google Cloud SDK, devi utilizzare la versione 470.0.0 o successiva e i comandi gcloud beta. Per verificare la versione Google Cloud SDK, esegui gcloud --version. Per aggiornare Google Cloud SDK, esegui gcloud components update.

Per installare Google Cloud SDK, consulta Installa gcloud CLI.

Designare una replica RE

Per eseguire RE avanzato, devi prima designare una replica di RE tra regioni.

Requisiti per le repliche RE

La replica di lettura di RE designata deve soddisfare i seguenti requisiti:

Deve essere un'istanza Cloud SQL Enterprise Plus
Deve essere la stessa versione principale e secondaria del database del database principale con MySQL 8.0.31 o versioni successive
Deve trovarsi in una regione diversa dall'istanza principale
Deve essere una replica di lettura diretta. non può essere una replica a cascata
Oltre a utilizzare i valori predefiniti, la replica di RE non può avere configura i seguenti flag:
- replicate_do_db
- replicate_ignore_db
- replicate_do_table
- replicate_wild_do_table
- replicate_ignore_table
- replicate_wild_ignore_table
Devi archiviare i log delle transazioni utilizzati per la PITR in Cloud Storage
Non può essere una replica esterna

Consigli per le repliche RE

Questa sezione fornisce consigli per la replica DR. Le seguenti possono aiutarti a evitare problemi di prestazioni del deployment:

Utilizza le stesse dimensioni del disco dell'istanza principale o abilita la crescita automatica.
Utilizza una configurazione HA coerente. Se abiliti l'alta disponibilità sull'istanza principale abilitazione dell'alta disponibilità sulla replica di RE.
Utilizza una configurazione coerente della cache dei dati. Se attivi la cache dei dati l'istanza principale, quindi abilitare anche la cache dei dati sulla replica di RE.
Configura eventuali flag di database appropriati per la replica di DR prima e dopo eventuali operazioni di switchover o failover della replica.

Crea una replica per soddisfare i requisiti delle repliche RE

Se l'istanza principale non ha già una replica di lettura tra regioni chesoddisfa i requisiti delle repliche di ripristino di emergenza, creane una.

Console

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova l'istanza principale.
Nella colonna Azioni, fai clic sul menu Altre azioni.
Seleziona Crea replica di lettura.
Nel campo ID istanza, inserisci un nome per la replica di DR.
Nel campo Versione database, MySQL 8.0 è già selezionato.
Nel campo Versione secondaria, mantieni la versione secondaria preselezionata. La replica DR e l'istanza principale devono condividere la stessa versione secondaria del database.
Nella sezione Scegli la disponibilità per regione e zona della pagina, procedi nel seguente modo:
- Seleziona una regione diversa da quella dell'istanza principale.
- Facoltativo. Seleziona Più zone per la replica di DR.
- Facoltativo. Seleziona le zone principali e secondarie per la replica di ripristino di emergenza.
Nella sezione Personalizza l'istanza della pagina, puoi aggiornare le impostazioni per la tua replica RE. Per ulteriori dettagli su ciascuna impostazione, consulta la pagina Informazioni sulle impostazioni delle istanze.
Per Forme macchina, seleziona lo stesso tipo di macchina dell'istanza principale.
Per Flag, configura tutti i flag richiesti per il tuo database.
Fai clic su Crea replica.

Cloud SQL crea un backup dell'istanza principale e la replica. Tornerai alla pagina dell'istanza principale.

gcloud

Per creare una replica che soddisfi i requisiti di una replica di RE, esegui questo comando:

gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME \
   --region=REPLICA_REGION_NAME \
   --database-version=DATABASE_VERSION \
   --tier=MACHINE_TYPE \
   --availability-type=AVAILABILITY_TYPE
   --edition="ENTERPRISE_PLUS"

Sostituisci le seguenti variabili:

REPLICA_NAME: il nome della replica di RE.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
REPLICA_REGION_NAME: specifica una regione diversa da quella dell'istanza principale.
DATABASE_VERSION: specifica la stringa di versione che corrisponde alla principale e secondaria dell'istanza principale, ad esempio MYSQL_8_0_31.
Le versioni principali e secondarie del database devono essere uguali sia per la replica principale sia per quella di DR.
MACHINE_TYPE: specifica lo stesso tipo di macchina dell'istanza principale. Ti consigliamo di scegliere un tipo di macchina che corrisponda a quello dell'istanza principale.
AVAILABILITY_TYPE: se l'istanza principale è configurata per l'alta disponibilità, ti consigliamo di specificare REGIONAL per attivarla.
EDITION: specifica ENTERPRISE_PLUS.

REST v1

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

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
Stringa di versione DATABASE_VERSION: che corrisponde alle istanze principali e minore dell'istanza principale, ad esempio MYSQL_8_0_31. La la versione principale e quella secondaria del database devono essere uguali sia per Replica di RE.
REPLICA_NAME: il nome dell'istanza di replica di RE che stai creando.
REPLICA_REGION: la regione dell'istanza della replica RE. La regione della replica deve essere diversa dalla regione dell'istanza principale.
MACHINE_TYPE: specifica lo stesso tipo di macchina dell'istanza principale. Ti consigliamo di selezionare lo stesso tipo di macchina dell'istanza principale.
AVAILABILITY_TYPE: se l'istanza principale è configurata per l'alta disponibilità, ti consigliamo di specificare REGIONAL per attivare l'alta disponibilità.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Corpo JSON della richiesta:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "DATABASE_VERSION",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "replicationType": "ASYNCHRONOUS",
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_UD/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
Stringa di versione DATABASE_VERSION: che corrisponde alle istanze principali e minore dell'istanza principale, ad esempio MYSQL_8_0_31. La la versione principale e quella secondaria del database devono essere uguali sia per Replica di RE.
REPLICA_NAME: il nome dell'istanza di replica RE che stai creando.
REPLICA_REGION: la regione dell'istanza della replica RE. La regione della replica deve essere diversa dalla regione dell'istanza principale.
MACHINE_TYPE: specifica lo stesso tipo di macchina dell'istanza principale. Me consiglia che le dimensioni del disco corrispondano a quelle dell'istanza principale.
AVAILABILITY_TYPE: se l'istanza principale è configurata per livello elevato la disponibilità, ti consigliamo di specificare REGIONAL per attivare la disponibilità del servizio.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

Corpo JSON della richiesta:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "DATABASE_VERSION",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "replicationType": "ASYNCHRONOUS",
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_UD/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Specifica la replica di RE per l'istanza principale

Le seguenti procedure descrivono come designare uno dei di un'istanza principale come replica di RE per il cambio o la replica di failover.

Console

Per designare una replica RE per un'istanza principale:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova e seleziona l'istanza principale. Viene visualizzata la pagina Panoramica dell'istanza principale.
Nel menu di navigazione, fai clic su Repliche.
Nell'elenco delle repliche di lettura, trova la replica di lettura tra regioni designare come replica di RE.
Per la replica, fai clic sul pulsante more_vert Azioni e seleziona Definisci come replica RE.
Fai clic su Conferma.

gcloud

Per designare una replica DR per un'istanza principale, utilizza il seguente comando:

gcloud beta sql instances patch PRIMARY_INSTANCE_NAME \
   --failover-dr-replica-name=REPLICA_NAME

Sostituisci le seguenti variabili:

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
REPLICA_NAME: il nome della replica RE.

REST v1

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

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
REPLICA_NAME: il nome della replica RE.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Corpo JSON della richiesta:

{
  "replicationCluster": {
     "failoverDrReplicaName": "REPLICA_NAME"
   }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
REPLICA_NAME: il nome della replica RE.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Corpo JSON della richiesta:

{
  "replicationCluster": {
     "failoverDrReplicaName": "REPLICA_NAME"
   }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Modificare la designazione della replica RE

Se la replica soddisfa i requisiti, puoi designare un'altra replica come replica di DR. La replica RE precedente perde la replica RE designazione.

Console

Per modificare la replica DR per un'istanza principale:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova e seleziona l'istanza principale. Viene visualizzata la pagina Panoramica dell'istanza principale.
Nel menu di navigazione, fai clic su Repliche.
Nell'elenco delle repliche di lettura, individua la replica di lettura tra regioni che vuoi designare come nuova replica di DR.
Per la replica, fai clic sul pulsante more_vert Azioni e seleziona Designa come replica di DR.

gcloud

Per modificare la replica DR, esegui di nuovo il comando designate e specifica una replica DR diversa.

REST

Per modificare la replica RE, effettua la richiesta API designata e specificare un valore diversa replica di RE.

Visualizza la designazione di replica RE

Puoi verificare quale replica di RE è assegnata all'istanza principale utilizzando il metodo gcloud CLI o l'API Cloud SQL Admin. Puoi anche controllare se una replica è designata come replica RE.

Per scoprire quale replica di DR è designata per un'istanza principale, segui la procedura riportata di seguito.

Console

Per scoprire quale replica di lettura è la replica di DR designata per un'istanza principale:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova e seleziona l'istanza principale. Nella pagina Panoramica relativa ai e l'istanza principale.
Nel menu di navigazione, fai clic su Repliche.
Nell'elenco delle repliche di lettura, verifica che MySQL disaster recovery replica venga visualizzato nella colonna Tipo per la replica DR designata.

gcloud

Per scoprire quale istanza è la replica DR designata di un'istanza principale, utilizza il seguente comando:

gcloud beta sql instances describe PRIMARY_INSTANCE_NAME

Sostituisci la seguente variabile:

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale

L'output di questo comando contiene il campo failoverDrReplica che identifica la replica DR designata.

REST v1

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
  . . .
  "replicaNames": [
    "my-instance-replica"
  ],
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.5.4.1"
    }
  ],
  "instanceType": "CLOUD_SQL_INSTANCE",
   . . .
  "connectionName": "my-project:us-east1:my-instance",
  "name": "my-instance",
  "region": "us-east1",
  "gceZone": "us-east1-c",
  "secondaryGceZone": "us-east1-b",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "failoverDrReplicaName": "my-project:my-instance-replica"
   },
  "createTime": "2024-03-15T18:11:03.596Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}
}

REST v1beta4

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
  . . .
  "replicaNames": [
    "my-instance-replica"
  ],
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.5.4.1"
    }
  ],
  "instanceType": "CLOUD_SQL_INSTANCE",
   . . .
  "connectionName": "my-project:us-east1:my-instance",
  "name": "my-instance",
  "region": "us-east1",
  "gceZone": "us-east1-c",
  "secondaryGceZone": "us-east1-b",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "failoverDrReplicaName": "my-project:my-instance-replica"
   },
  "createTime": "2024-03-15T18:11:03.596Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}
}

Per verificare se una replica è una replica DR, utilizza una delle seguenti procedure.

Console

Per verificare se un'istanza replica è una replica di DR:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova l'istanza di replica.
Verifica che MySQL disaster recovery replica venga visualizzato nella colonna Tipo per la replica DR designata.

gcloud

Per verificare se un'istanza di replica è una replica RE, esegui questo comando:

gcloud beta sql instances describe REPLICA_NAME

Sostituisci la seguente variabile:

REPLICA_NAME: il nome della replica di lettura che vuoi verifica

Se la replica è una replica DR, l'output del comando contiene il campo drReplica=true.

REST v1

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
REPLICA_NAME: il nome della replica.

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-perf-optimized-N-8",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    . . .
    },
  "masterInstanceName": "my-project:my-instance",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.3.2.1"
    }
  ],
  . . .
  "instanceType": "READ_REPLICA_INSTANCE",
  . . .
"connectionName": "my-project:us-east4:my-instance-replica",
  "name": "my-instance-replica",
  "region": "us-east4",
  "gceZone": "us-east4-b",
  "secondaryGceZone": "us-east4-c",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "drReplica": true
  },
  "createTime": "2024-03-15T18:17:44.655Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

REST v1beta4

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud che contiene l'istanza.
REPLICA_NAME: il nome della replica.

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-perf-optimized-N-8",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    . . .
    },
  "masterInstanceName": "my-project:my-instance",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.3.2.1"
    }
  ],
  . . .
  "instanceType": "READ_REPLICA_INSTANCE",
  . . .
"connectionName": "my-project:us-east4:my-instance-replica",
  "name": "my-instance-replica",
  "region": "us-east4",
  "gceZone": "us-east4-b",
  "secondaryGceZone": "us-east4-c",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "drReplica": true
  },
  "createTime": "2024-03-15T18:17:44.655Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Rimuovi la replica RE

Puoi cancellare la designazione della replica RE da un'istanza principale. Tuttavia, se non è assegnata alcuna replica di RE a un'istanza principale, non puoi eseguire lo switchover o il failover della replica.

Console

Per rimuovere una replica RE designata da un'istanza principale:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova e seleziona l'istanza principale. Viene visualizzata la pagina Panoramica dell'istanza principale.
Nel menu di navigazione, fai clic su Repliche.
Nell'elenco delle repliche di lettura, individua la replica di lettura tra regioni che vuoi rimuovere.
Per la replica, fai clic sul pulsante more_vert Azioni e seleziona Rimuovi come replica RE.
Fai clic su Conferma.

gcloud

Per rimuovere la designazione di replica RE, esegui questo comando sull'istanza principale istanza:

gcloud beta sql instances patch PRIMARY_INSTANCE_NAME \
  --clear-failover-dr-replica-name

Sostituisci la seguente variabile:

PRIMARY_INSTANCE_NAME: il nome dell'istanza principale da cui vuoi rimuovere la replica designata di RE

REST v1

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
Imposta una stringa vuota per il campo failoverDrReplicaName.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Corpo JSON della richiesta:

{
  "replicationCluster": {
     "failoverDrReplicaName": ""
   }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
Imposta una stringa vuota per il campo failoverDrReplicaName.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

Corpo JSON della richiesta:

{
  "replicationCluster": {
     "failoverDrReplicaName": ""
   }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Esegui il cambio

Dopo aver designato una replica di DR, puoi eseguire l'operazione di switchover. Tuttavia, come best practice, evita di eseguire l'operazione di cambio nel le seguenti circostanze:

L'istanza principale è in uso attivamente.
Sono in corso operazioni di amministrazione, come il backup automatico o l'attivazione o la disattivazione dell'alta disponibilità (HA).

Per evitare un timeout, valuta la possibilità di eseguire il cambio quando il volume delle transazioni è basso.

Al termine del cambio, l'operazione esegue un backup della nuova istanza principale (la precedente replica di RE) non appena la nuova istanza principale viene promosso. Al termine del backup, il recupero point-in-time (PITR) viene attivato completamente sulla nuova istanza principale. Questo backup può richiedere da 5 a 15 minuti per il completamento, a seconda delle dimensioni del disco. La copertura PITR inizia solo al termine di questo backup. Per ulteriori informazioni sulle considerazioni utilizzando il PITR con RE avanzata, Usa il PITR con RE avanzato.

Terminata l'operazione di commutazione, noterai che la direzione la replica è invertita.

Prima di iniziare

Prima di eseguire il cambio, segui questi passaggi:

Specificare una replica RE. Puoi eseguire un cambio solo tra l'istanza principale e la replica di RE designata.
Verifica che l'istanza principale e la replica di DR siano online.
Esegui un backup on demand dell'istanza principale. Questo backup è una misura di sicurezza nel caso in cui tu debba recuperare da eventuali errori imprevisti.

Esegui l'operazione di switchover

Console

Per eseguire il cambio, procedi nel seguente modo:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova la replica RE designata dell'istanza principale.
Fai clic sull'istanza della replica RE. Nella pagina Panoramica relativa ai viene visualizzata la replica RE.
Fai clic sul pulsante Cambia.
Nella pagina Esegui il cambio tra la l'istanza principale e la replica di DR, inserisci il nome dell'istanza principale nel campo ID istanza.
Fai clic su Passaggio.

gcloud

Per effettuare il cambio, esegui questo comando:

gcloud beta sql instances switchover REPLICA_NAME
   [--db-timeout=TIMEOUT_DURATION ]

Sostituisci le seguenti variabili:

REPLICA_NAME: il nome della replica di RE designata con cui vuoi che l'istanza principale cambi ruolo.
TIMEOUT_DURATION: facoltativo. il periodo di timeout per consentire delle operazioni di database sull'istanza.

Se non specifichi questo parametro, l'operazione di switchover include un timeout di 10 minuti.

Puoi aumentare il valore di questo timeout specificando il parametro --db-timeout. Sostituisci TIMEOUT_DURATION con un periodo di tempo di massimo 24 ore, inclusa una notazione iniziale per il valore formato. Ad esempio, per 30 secondi, specifica 30s. Per 24 ore, specifica 24h. Puoi anche specificare unità frazionarie del periodo di tempo utilizzando decimali fino a 9 cifre. Ad esempio, per 30,5 minuti, specifica 30.5m.

Se non hai operazioni in attesa, puoi diminuire il valore di questo timeout.

REST v1

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud del principale e la replica di RE.
REPLICA_NAME: il nome della replica di RE.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "SWITCHOVER",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud del principale e la replica di RE.
REPLICA_NAME: il nome della replica di RE.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "SWITCHOVER",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Esegui il ripristino di emergenza richiamando un failover della replica

In caso di errore a livello di regione o di emergenza, puoi eseguire RE di richiamare un'operazione di failover della replica sulla replica di RE designata. Per eseguire di un failover della replica, promuovi la risorsa Replica di RE. A differenza del passaggio, la promozione della replica di DR è immediata.

Poiché la replica di DR assume immediatamente il ruolo dell'istanza principale, è possibile che la replica non contenga tutti i dati dell'istanza principale precedente a causa del ritardo della replica. Per questo motivo, un failover della replica può comportare la perdita di dati.

Nell'ambito del processo di promozione, il failover della replica esegue un backup del nuovo principale (la precedente replica di RE) subito dopo che la replica di RE diventa nuova istanza principale. Al termine del backup, il recupero point-in-time (PITR) è completamente abilitato sulla nuova istanza principale. Il completamento del backup può richiedere da 5 a 15 minuti, a seconda delle dimensioni del disco della nuova (e della vecchia) istanza principale. Durante questo periodo di backup, il PITR non è disponibile.

Quando la vecchia istanza principale torna online, il processo di failover della replica esegue un backup. Una volta eseguito il backup, la vecchia istanza principale viene viene ricreata come replica di lettura della nuova istanza principale. In questo processo, la vecchia istanza principale perde i log delle transazioni PITR precedenti che non sono ancora stati salvati in Cloud Storage. Pertanto, il failover della replica non garantisce che tutti i log delle transazioni utilizzati per il PITR sulla vecchia istanza principale vengano conservati.

Per ulteriori informazioni sulle considerazioni sull'uso del PITR con RE avanzata, vedi Usa il PITR con RE avanzato.

Importante: dopo aver richiamato l'operazione di failover della replica, puntare le applicazioni in modo che usi l'indirizzo IP della nuova istanza principale.

Prima di iniziare

Prima di eseguire il failover della replica, segui questi passaggi:

Se non l'hai già fatto, designare una replica RE. Puoi eseguire un failover della replica solo tra l'istanza principale e la replica di RE designata.
Assicurati che la replica di DR sia online e funzionante.

Esegui l'operazione di failover della replica

Console

Per eseguire l'operazione di failover della replica:

Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

Vai a Istanze Cloud SQL
Trova la replica RE designata dell'istanza principale.
Fai clic sull'istanza della replica di RE. Nella pagina Panoramica relativa ai viene visualizzata la replica RE.
Fai clic sul pulsante Failover della replica.
Nella pagina Esegui il failover della replica tra la l'istanza principale e la replica di DR, inserisci il nome dell'istanza principale nel campo ID istanza per confermare di voler procedere con l'operazione.
Per avviare il failover della replica, fai clic su Failover della replica.

gcloud

Per invocare un failover della replica alla replica di DR, utilizza il seguente comando:

gcloud beta sql instances promote-replica \
   REPLICA_NAME --failover

Sostituisci la seguente variabile:

REPLICA_NAME: il nome della replica di RE

REST v1

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
REPLICA_NAME: il nome della replica RE.
ENABLE_REPLICA_FAILOVER: imposta su true per utilizzare il failover della replica. Se imposti false, l'API utilizza il normale valore promoteReplica senza failover della replica.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "PROMOTE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PROJECT_ID: l'ID o il numero del progetto Google Cloud dell'istanza principale e della replica di RE.
REPLICA_NAME: il nome della replica RE.
ENABLE_REPLICA_FAILOVER: imposta su true per utilizzare il failover della replica. Se imposti false, l'API utilizza il normale valore promoteReplica senza failover della replica.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "PROMOTE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Controllare lo stato del failover di una replica

Il failover della replica avviene in due fasi. La prima fase è la promozione della replica DR. La seconda fase è la ricreazione la vecchia istanza principale come replica di lettura.

Per controllare lo stato del failover della replica, controlla lo stato di ogni fase.

Controlla lo stato della prima fase.
Console

Per verificare se la replica di DR è stata promossa a un'istanza autonoma:
1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
  
  Vai a Istanze Cloud SQL
2. Trova il nome della replica DR che hai promosso.
3. Verifica che MySQL 8.0 venga visualizzato nella colonna Tipo per la nuova istanza principale.
gcloud
Per controllare lo stato, esegui il seguente comando:
```
gcloud sql instances describe DR_REPLICA_NAME
```
Sostituisci la seguente variabile:
- DR_REPLICA_NAME: il nome della replica di RE promossa
Nell'output, verifica che venga visualizzato il seguente campo e è diventata un'istanza Cloud SQL principale autonoma:
```
instanceType: CLOUD_SQL_INSTANCE
```
Per verificare il completamento della seconda fase, controlla il messaggio RECONFIGURE_OLD_PRIMARY nel log delle operazioni dell'istanza.

L'aspetto di questo messaggio dipende da quando il vecchio principale restituisce online, il che può richiedere minuti giorni in caso di disastro.

Per saperne di più su come controllare i log delle operazioni su un'istanza, consulta Visualizzare i log delle istanze.

Usa il PITR con RE avanzata

Sia con lo switchover sia con il failover della replica, non appena la replica di DR viene promossa a istanza principale, vengono apportate le seguenti modifiche per supportare il backup e il PITR:

La configurazione del backup, inclusa la pianificazione automatica del backup, è dalla precedente istanza principale alla nuova istanza principale.
Se è disattivato, il flag di configurazione del log bin viene attivato per abilitare la PITR.
Viene utilizzato un nuovo backup per supportare PITR sulla nuova istanza principale.
Il criterio di conservazione del log delle transazioni è stato copiato dalla precedente istanza principale alla nuova istanza principale.

Sia per la configurazione del backup sia per i criteri di conservazione dei log delle transazioni, consigliamo di verificare che le impostazioni ereditate dalla vecchia istanza principale siano corrette per la nuova istanza principale.

Inizio della copertura PITR

Al termine dell'operazione di switchover, Cloud SQL pianifica i backup automatici e esegue il primo backup della nuova istanza principale. Se vuoi che la copertura PITR inizi prima del previsto, ti consigliamo di verificare che il primo backup sia riuscito. L'istanza principale appena promossa ha la copertura PITR solo dopo il completamento del primo backup automatico.

Per ulteriori informazioni su come visualizzare i backup disponibili per un consulta l'istanza Visualizza un elenco dei backup.

Copertura PITR per le istanze durante il cambio e il failover della replica

Quando un'istanza partecipa a un'operazione di cambio o failover della replica, l'istanza trascorre del tempo come replica di lettura. Il PITR e il ripristino di un backup sono supportati durante il periodo di tempo in cui l'istanza viene utilizzata come replica di lettura. Se vuoi eseguire il PITR in un punto nel tempo precedente all'evento di switchover (quando l'istanza era principale), puoi emettere il comando di clonazione per scegliere come target il momento in cui l'istanza era principale. Non puoi richiedere PITR su un momento in cui l'istanza era una replica di lettura.

Se non riesci a eseguire il PITR perché l'istanza principale era una lettura replica al momento desiderato, dovrai tentare la richiesta PITR sulla che era come istanza principale attiva al momento dell'interesse.

Analogamente, puoi ripristinare un backup eseguito in un momento in cui la replica era un'istanza principale. Mentre l'istanza è una replica, il comando di ripristino deve scegliere come target un'istanza autonoma diversa e non può essere ripristinato replicare.

Per determinare quale istanza usare per la richiesta PITR, utilizza le operazioni dall'elenco di lettura. L'elenco delle operazioni per un'istanza può aiutarti a determinare quando un'istanza è stata sottoposta a operazioni di switchover o failover della replica.

Split-Brain durante il failover della replica

È possibile che si verifichi " split-brain" quando l'istanza principale continua accettare scritture mentre una replica viene promossa utilizzando il failover della replica. Dopo la promozione della replica, quando la vecchia istanza principale è di nuovo disponibile, viene ricostruita come replica dell'istanza promossa e viene eseguito un backup finale. Questo backup può essere utilizzato per recuperare eventuali dati con problemi di coerenza che non sono stati scritti nella replica promossa.

Eliminazione di backup e log delle transazioni sulle repliche

Se un'istanza principale che è stata abilitata con PITR e i backup diventa una risorsa automaticamente la replica, l'ultimo backup e criterio di conservazione PITR del periodo mentre l'istanza principale viene conservata e applicata durante il periodo come replica. Uniforme anche se la nuova istanza principale non sta eseguendo backup, i backup precedenti i log delle transazioni utilizzati per il PITR vengono eliminati nella replica di lettura in base l'ultimo criterio configurato.

Ad esempio, se l'istanza è configurata per avere backup automatici giornalieri e conservare 7 backup con 7 giorni di log PITR, quando questa istanza diventa una replica di lettura, tutti gli elementi precedenti a 7 giorni vengono eliminati una volta al giorno.

Se devi eliminare i backup prima, puoi rimuoverli manualmente. Per ulteriori informazioni, consulta Eliminare un backup.

Limitazioni

Il DR avanzato non è supportato per le istanze Cloud SQL che utilizzano Private Service Connect.
Non puoi designare un'istanza di replica di lettura della versione Enterprise Plus di Cloud SQL come replica di ripristino di emergenza se l'istanza principale memorizza i log delle transazioni per il recupero point-in-time (PITR) su disco. Per controllare dove un'istanza archivia i log per la replica incrementale in tempo reale, consulta Controllare la posizione di archiviazione dei log delle transazioni utilizzati per la replica incrementale in tempo reale.
Non puoi designare una replica esterna come replica RE.

Risoluzione dei problemi

Problema	Risoluzione dei problemi
Operazione di cambio non riuscita.	Assicurati che l'istanza soddisfi tutti i requisiti delle repliche di DR dichiarati. Controlla il volume delle transazioni nel database. Cambia protegge i log binari dell'istanza principale in Cloud Storage prima che esegue il cambio. Se il volume delle transazioni è elevato, l'operazione potrebbe scadere. Valuta la possibilità di riprovare l'operazione quando il carico delle transazioni è più basso.
L'operazione di switchover non è riuscita e l'istanza principale è bloccata in modalità di sola lettura.	Esegui un riavvio del database per ripristinare la modalità di scrittura dell'istanza principale.
L'operazione di switchover è stata completata, ma la console Google Cloud non mostra i nuovi ruoli invertiti per le istanze.	Aggiorna il browser per visualizzare la topologia aggiornata.
Failover della replica non riuscito.	Assicurati che sia designata una replica di RE per l'istanza principale ed è online. Se il failover alla replica RE non è andato a buon fine, promuovi a un di lettura standard (non RE).
Impossibile capire se la replica non è in corso	Connettiti alla replica e digita: show slave status; Se la replica è in corso, la prima colonna "`Slave_IO_State`" mostra "`Waiting for master to send event`" e il campo "`Last_IO_Error`" è vuoto. Se la replica non avviene, la prima colonna `"Slave_IO_State"` mostra `"Connecting to master"`. e il campo `"Last_IO_Error"` mostra un errore simile a `"error connecting to master '[email protected]:3306"`. Puoi anche visualizzare lo stato della replica delle repliche nel Dashboard di monitoraggio di Cloud SQL. Per saperne di più, consulta Monitorare le istanze Cloud SQL.
Hai ricevuto il seguente messaggio di errore: `"Instance was converted into a replica between the target PITR time and the last available base backup. PITR logs are not available for the period instance was a replica. Please clone from the instance that was primary at time %s"`	Non puoi eseguire il recupero point-in-time per un periodo di tempo in cui un'istanza è stata sottoposta a un cambio a una replica. I log PITR non sono disponibili per il momento in cui l'istanza era una replica. Esamina l'elenco delle operazioni per l'istanza per determinare se l'istanza era una replica in quel momento Utilizza l'elenco delle operazioni per determinare quale istanza era principale in quel momento. Clona l'istanza per eseguire il PITR.
Hai ricevuto il seguente messaggio di errore: `"You can only designate a disaster recovery (DR) replica for primary instances that are storing their PITR logs in Cloud Storage. PITR logs of the instance %s are not stored in Cloud Storage"`	L'istanza principale non ha ancora spostato la posizione di archiviazione dei suoi log delle transazioni su Cloud Storage. Puoi riprovare dopo aver modificato la posizione di archiviazione dei log delle transazioni oppure puoi provare a designare una replica DR per un'istanza principale diversa. Per ulteriori informazioni sullo spostamento della posizione di archiviazione log delle transazioni utilizzati per il PITR, consulta Utilizzare recupero point-in-time (PITR).
Hai ricevuto il seguente messaggio di errore: `"The specified failover dr replica name REPLICA_NAME must be one of the replicas of the primary instance INSTANCE_NAME`".	Per ulteriori informazioni su come designare una replica DR e sulla sintassi corretta del comando, consulta Designare la replica DR per l'istanza principale.

Passaggi successivi

Scopri di più sull'osservabilità del database
Monitora le istanze Cloud SQL