Attivare e disattivare l'alta disponibilità

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive come configurare un'istanza per l'alta disponibilità.

Puoi configurare un'istanza per l'alta disponibilità al momento della creazione o attivare l'alta disponibilità su un'istanza esistente.

Per saperne di più sull'alta disponibilità, consulta Panoramica della configurazione dell'alta disponibilità.

Crea una nuova istanza configurata per l'alta disponibilità

Quando crei un'istanza e la configuri per l'alta disponibilità, Cloud SQL la crea come istanza a livello di regione

Per creare un'istanza configurata per l'alta disponibilità:

Console

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

   Vai a Istanze Cloud SQL

2. Seleziona Crea istanza.
3. Seleziona il motore del database.
4. Nella sezione Scegli regione e disponibilità a livello di zona, seleziona Più zone (disponibilità elevata).
5. Espandi Specifica zone.
6. Seleziona le zone principali e secondarie. Le seguenti condizioni si applica quando la zona secondaria viene utilizzata durante la creazione o la modifica dell'istanza:
   • Per impostazione predefinita, le zone sono Any per la zona principale e Any (different from primary) per la zona secondaria.

   Se sono specificate entrambe le zone, devono essere diverse.

7. Fai clic su Salva.

   Tornerai alla pagina dell'istanza principale mentre l'istanza viene aggiornata.

gcloud

1. Crea l'istanza regionale:

   gcloud sql instances create REGIONAL_INSTANCE_NAME \
   --availability-type=REGIONAL \
   --database-version=SQLSERVER_2017_STANDARD \
   --cpu=NUMBER_CPUS \
   --memory=MEMORY_SIZE

2. Configura l'utente root:

   gcloud sql users set-password root no-host \
   --instance=REGIONAL_INSTANCE_NAME \
   --password=PASSWORD

Per un elenco completo dei parametri disponibili, vedi pagina di riferimento gcloud sql instances create.

Terraform

Per creare un'istanza ad alta disponibilità, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-ha"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled    = true
      start_time = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito dove vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi farlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti in Terraform di configurazione del deployment.

Prepara la directory

Ogni file di configurazione Terraform deve avere una directory dedicata (inoltre chiamato modulo principale).

1. In Cloud Shell, crea una directory e un nuovo all'interno di quella directory. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice di esempio in ogni sezione o passaggio.

   Copia il codice campione nel nuovo oggetto main.tf.

   Se vuoi, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.

   terraform init

   Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta:

   terraform apply

   Attendi che Terraform mostri il messaggio "Applicazione completata".

3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.

Nota: in genere i sample di Terraform presuppongono che le API richieste siano attivate nel progetto Google Cloud.

Elimina le modifiche

Per eliminare le modifiche:

1. Per disabilitare la protezione dall'eliminazione, imposta il file di configurazione Terraform Argomento deletion_protection per false.

   deletion_protection =  "false"

2. Applica la configurazione Terraform aggiornata eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

3. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

   terraform destroy

REST v1

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.

Crea l'istanza regionale.

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

   • project-id: l'ID progetto
   • instance-name: il nome dell'istanza
   • database-version: la stringa enum della versione del database
   • region La regione Google Cloud
   • machine-type Il tipo di macchina

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

   Corpo JSON della richiesta:

   {
     "name": "instance-name",
     "region": "region",
     "databaseVersion": "database-version",
      "settings": {
        "tier": "machine-type",
        "backupConfiguration": {
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Per inviare la richiesta, espandi una di queste 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-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

2. Al termine dell'inizializzazione dell'istanza, aggiorna la password di root sull'istanza:

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

   • project-id: l'ID progetto
   • instance-id: l'ID istanza
   • password: la nuova password dell'utente root

   Metodo HTTP e URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=sqlserver'

   Corpo JSON della richiesta:

   {
      "name": "sqlserver",
      "host": "nohost",
      "password": "password"}
   

   Per inviare la richiesta, espandi una di queste 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, 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/v1/projects/project-id/instances/instance-id/users?host=%25&name=sqlserver'"

   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. ed esegui questo comando:

   $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/instance-id/users?host=%25&name=sqlserver'" | Select-Object -Expand Content

   Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.

Crea l'istanza regionale.

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

   • project-id: l'ID progetto
   • instance-name: il nome dell'istanza
   • database-version: la stringa enum della versione del database
   • region La regione Google Cloud
   • machine-type Il tipo di macchina

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

   Corpo JSON della richiesta:

   {
     "name": "instance-name",
     "region": "region",
     "databaseVersion": "database-version",
      "settings": {
        "tier": "machine-type",
        "backupConfiguration": {
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Per inviare la richiesta, espandi una di queste 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/sql/v1beta4/projects/project-id/instances"

   PowerShell (Windows)

   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 di Google. 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/sql/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/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

2. Al termine dell'inizializzazione dell'istanza, aggiorna la password di root sull'istanza:

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

   • project-id: l'ID progetto
   • instance-id: l'ID istanza
   • password: la nuova password dell'utente root

   Metodo HTTP e URL:

   PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=sqlserver'

   Corpo JSON della richiesta:

   {
      "name": "sqlserver",
      "host": "nohost",
      "password": "password"}
   

   Per inviare la richiesta, espandi una di queste 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 PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=sqlserver'"

   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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=sqlserver'" | Select-Object -Expand Content

   Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Per maggiori dettagli sulla creazione di un'istanza, consulta Creazione di istanze.

Configurare un'istanza esistente per l'alta disponibilità

Puoi configurare un'istanza Cloud SQL per l'alta disponibilità utilizzando la console Google Cloud, gcloud CLI o l'API.

Nota:dopo aver avviato la configurazione dell'alta disponibilità per un non puoi fermarlo. La riconfigurazione dell'istanza determina il riavvio. In genere, Cloud SQL richiede solo pochi minuti per riconfigurare l'istanza e riavviarla. Tuttavia, se l'istanza ha un disco o un carico di grandi dimensioni, l'operazione potrebbe richiedere fino a un'ora.

Console

Importante: non puoi utilizzare la console Google Cloud per configurare istanze per le quali è abilitato Private Service Connect per l'alta disponibilità. Per configurare queste istanze, utilizza l'interfaccia a riga di comando gcloud o l'API.

Per configurare un'istanza per l'alta disponibilità:

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Modifica.
4. Nell'opzione di configurazione Backup automatici e alta disponibilità seleziona Alta disponibilità (a livello di regione). È inoltre consigliato di attivare i backup automatici.
5. Fai clic su Salva.

gcloud

Per configurare un'istanza in modo che sia regionale e ad alta disponibilità, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL

Sostituisci INSTANCE_NAME con il nome dell'istanza Cloud SQL che stai configurando per l'alta disponibilità.

REST v1

Per configurare un'istanza come istanza regionale ad alta disponibilità:

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
• INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "settings": {"availabilityType": "REGIONAL" }
}

Per inviare la richiesta, espandi una di queste 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 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/INSTANCE_NAME"

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. ed esegui questo comando:

$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/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per configurare un'istanza come istanza regionale ad alta disponibilità:

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
• INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "settings": {"availabilityType": "REGIONAL" }
}

Per inviare la richiesta, espandi una di queste 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 PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Avvia il failover

Il test del failover è facoltativo, ma è consigliato per consentirti di vedere come dell'applicazione risponde in caso di failover.

Questa funzionalità ti aiuta a testare la risposta della tua applicazione a un failover automatico. Assicurati che l'istanza abbia completato eventuali failover precedenti (in modo che risponda alle richieste di connessione) prima di attivarne un altro. Inoltre, prima di avviare il failover per l'istanza, per configurare l'alta disponibilità dell'istanza.

Per scoprire di più sui failover, consulta la panoramica del failover.

Console

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Failover.
4. Nella finestra di dialogo Attiva manualmente un failover, inserisci l'ID l'istanza nel campo di testo e fai clic su Failover attivatore.

gcloud

Avvia il failover:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

1. Descrivi l'istanza principale per ottenere il valore del campo settingsVersion.

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

   • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
   • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

   Metodo HTTP e URL:

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

   Per inviare la richiesta, espandi una di queste 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

   Esegui questo comando:

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

   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

   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/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   {
     "kind": "sql#instance",
     "state": "RUNNABLE",
     "databaseVersion": "SQLSERVER_2019_STANDARD"
   }
   

2. Avvia il failover:

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

   • project-id: l'ID progetto
   • instance-name: il nome dell'istanza
   • settings-version: la versione delle impostazioni da instanceInfo

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

   Corpo JSON della richiesta:

   {
     "failoverContext":
        {
           "settingsVersion":"settings-version"
        }
   }
   

   Per inviare la richiesta, espandi una di queste 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/instance-name/failover"

   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/instance-name/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/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

REST v1beta4

1. Descrivi l'istanza principale per ottenere il valore dell'oggetto campo settingsVersion.

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

   • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
   • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

   Metodo HTTP e URL:

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

   Per inviare la richiesta, espandi una di queste 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.

   Esegui questo comando:

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

   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

   Esegui questo comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   {
     "kind": "sql#instance",
     "state": "RUNNABLE",
     "databaseVersion": "SQLSERVER_2019_STANDARD"
   }
   

2. Avvia il failover:

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

   • project-id: l'ID progetto
   • instance-name: il nome dell'istanza
   • settings-version: la versione delle impostazioni da instanceInfo

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

   Corpo JSON della richiesta:

   {
     "failoverContext":
        {
           "settingsVersion":"settings-version"
        }
   }
   

   Per inviare la richiesta, espandi una di queste 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/sql/v1beta4/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   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 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:

   $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/sql/v1beta4/projects/project-id/instances/instance-name/failover" | 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-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

Viene eseguito il failover dell'istanza e non è disponibile per il servizio dati per alcuni minuti.

Verificare la configurazione dell'alta disponibilità di un'istanza

Per verificare che un'istanza abbia l'alta disponibilità e per visualizzare le zone in cui è in esecuzione:

Console

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Verifica che le seguenti impostazioni di alta disponibilità siano visualizzate nella sezione Configurazione:
• Disponibilità elevata (a livello di regione)
• Località mostra la zona principale corrente dell'istanza.

gcloud

gcloud sql instances describe INSTANCE_NAME

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone principali e secondarie attuali dell'istanza.

REST v1

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

• project-id: l'ID progetto
• instance-id: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Per inviare la richiesta, espandi una di queste 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

Esegui questo comando:

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

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

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/instance-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2019_STANDARD"
}

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone primarie e secondarie attuali dell'istanza.

REST v1beta4

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

• project-id: l'ID progetto
• instance-id: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Per inviare la richiesta, espandi una di queste 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

Esegui questo comando:

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

PowerShell (Windows)

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 di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2017_STANDARD",
}

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone primarie e secondarie attuali dell'istanza.

Modifica le zone di un'istanza ad alta disponibilità

La modifica di una o entrambe le zone di un'istanza ad alta disponibilità esistente provoca un di qualche minuto di inattività mentre l'istanza viene riconfigurata. Per visualizzare le zone principali e secondarie attuali in cui è in esecuzione l'istanza ad alta disponibilità, consulta Verificare la configurazione dell'alta disponibilità di un'istanza.

Nota: dopo aver avviato l'operazione di modifica della zona su un non puoi fermarlo. Questa operazione riavvia l'istanza. In genere sono necessari solo pochi minuti per completare la configurazione e il riavvio. Ma se l'istanza ha un disco o un carico di grandi dimensioni, l'operazione potrebbe richiedere fino all'ora.

Per modificare le zone di un'istanza ad alta disponibilità:

Console

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Modifica.
4. Nella sezione Scegli la disponibilità per regione e zona, espandi Specifica le zone e selezionane di nuove. Per impostazione predefinita, le zone sono Any per la zona principale e Any (different from primary) per la zona secondaria. Si applicano le seguenti limitazioni:
   • Puoi specificare solo la zona principale oppure sia quella primaria che quella secondaria zone.
   • Se sono specificate entrambe le zone, devono essere zone diverse.
5. Fai clic su Salva.

   Tornerai alla pagina dell'istanza principale mentre l'istanza viene aggiornata.

gcloud

Modifica la zona in cui è in esecuzione l'istanza:

gcloud sql instances patch INSTANCE_NAME \
  --zone=PRIMARY_ZONE --secondary-zone=SECONDARY_ZONE

Il parametro --secondary-zone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa dalla zona principale.

Si applicano le seguenti limitazioni:

• Le zone devono essere zone valide appartenenti alla stessa regione di Cloud SQL.
• Se viene specificata la zona secondaria, deve essere diversa da quella principale zona di destinazione.

REST v1

1. Modifica le zone dell'istanza regionale:

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

   • PROJECT_ID: l'ID progetto
   • INSTANCE_NAME: il nome dell'istanza
   • PRIMARY_ZONE: la zona principale
   • SECONDARY_ZONE: la zona secondaria

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
   "settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
   }
   

   Per inviare la richiesta, espandi una di queste 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 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/INSTANCE_NAME"

   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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

   Il parametro secondaryZone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa dalla zona principale.

   Si applicano le seguenti limitazioni:

   • Le zone devono essere zone valide.
   • Qualsiasi zona che scegli deve appartenere alla stessa regione di Cloud SQL.

REST v1beta4

1. Modifica le zone dell'istanza regionale:

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

   • PROJECT_ID: l'ID progetto
   • INSTANCE_NAME: il nome dell'istanza
   • PRIMARY_ZONE: la zona principale
   • SECONDARY_ZONE: la zona secondaria

   Metodo HTTP e URL:

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

   Corpo JSON della richiesta:

   {
   "settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
   }
   

   Per inviare la richiesta, espandi una di queste 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 PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   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 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:

   $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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

   Il parametro secondaryZone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa dalla zona principale.

   Si applicano le seguenti limitazioni:

   • Le zone devono essere zone valide.
   • Le zone che scegli devono appartenere alla stessa regione dell'istanza Cloud SQL.

Disattiva l'alta disponibilità per un'istanza

Puoi disattivare l'alta disponibilità per un'istanza Cloud SQL utilizzando la console Google Cloud, gcloud CLI o l'API.

Nota: prima di eseguire questa procedura, assicurati che non sia in esecuzione alcuna operazione sull'istanza.

Console

Importante: non puoi utilizzare la console Google Cloud per disattivare l'alta disponibilità per le istanze in cui è abilitato Private Service Connect. Per disattivare queste istanze, utilizza gcloud CLI o l'API.

Per disattivare l'alta disponibilità per un'istanza:

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Modifica.
4. Apri Backup automatici.
5. Nella sezione Disponibilità, fai clic su Zona singola.
6. Fai clic su Salva. Questa modifica richiede il riavvio dell'istanza.
7. Quando viene visualizzata la finestra di dialogo, fai clic su Salva e riavvia.

gcloud

Per disattivare l'alta disponibilità per un'istanza, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

Sostituisci INSTANCE_NAME con il nome dell'istanza Cloud SQL per cui stai disattivando l'alta disponibilità.

REST v1

Per modificare il tipo di disponibilità dell'istanza in ZONAL, utilizza il metodo instances:patch. Questo metodo disattiva l'alta disponibilità per l'istanza.

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
• INSTANCE_NAME: il nome dell'istanza per cui stai disattivando l'alta disponibilità

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "settings": {"availabilityType": "ZONAL" }
}

Per inviare la richiesta, espandi una di queste 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 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/INSTANCE_NAME"

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. ed esegui questo comando:

$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/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per modificare il tipo di disponibilità dell'istanza in ZONAL, utilizza il metodo instances:patch. Questo metodo disattiva l'alta disponibilità per l'istanza.

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

• PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
• INSTANCE_NAME: il nome dell'istanza per cui stai disattivando l'alta disponibilità

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "settings": {"availabilityType": "ZONAL" }
}

Per inviare la richiesta, espandi una di queste 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 PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Risoluzione dei problemi

Problema	Risoluzione dei problemi
Non riesci a trovare le metriche per un failover manuale.	Nelle metriche vengono presi in considerazione solo i failover automatici.
Le risorse delle istanze Cloud SQL (CPU e RAM) utilizzano quasi il 100% di utilizzo, causando l'arresto dell'istanza ad alta disponibilità.	La dimensione dell'istanza della macchina è troppo piccola per il carico. Modifica l'istanza per eseguire l'upgrade a una dimensione della macchina più grande per ottenere più CPU e memoria.

Passaggi successivi

• Scopri di più su come funziona la configurazione dell'alta disponibilità.
• Testa la risposta dell'applicazione alle connessioni perse riavviando l'istanza.
• Scopri di più sulla gestione delle connessioni ai database.
• Scopri di più su Google Cloud Observability.