Questa pagina descrive come creare una replica di lettura per un'istanza Cloud SQL.
Una replica di lettura è una copia dell'istanza principale che riflette le modifiche apportate all'istanza principale quasi in tempo reale, in circostanze normali. Puoi utilizzare una replica di lettura per trasferire le richieste di lettura o il traffico di analisi dall'istanza principale.
Inoltre, per il ripristino di emergenza, puoi eseguire una migrazione regionale. Se una replica è una replica tra regioni, puoi eseguire un failover in un'altra regione; in particolare, puoi promuovere una replica a un'istanza autonoma (in questo caso, le repliche esistenti non considererebbero l'istanza come principale).
Per saperne di più su come funziona la replica, consulta Replica in Cloud SQL.
Prima di iniziare
Se stai creando la prima replica per questa istanza, assicurati che l'istanza soddisfi i requisiti per le istanze principali. Scopri di più.
Crea una replica di lettura
Di seguito sono riportati i passaggi per creare una replica di lettura.
Console
-
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
- Trova l'istanza per cui vuoi creare una replica, quindi apri il menu
more actionsaccanto alla scheda. - Seleziona Crea replica di lettura.
Se non vedi questa opzione, l'istanza è una replica. Non puoi creare una replica di una replica.
- Se per l'istanza erano abilitati i backup e il logging binario, vai al passaggio successivo. In caso contrario, seleziona Backup automatici e Abilita logging binario, fai clic su Continua, quindi su Salva e riavvia per riavviare l'istanza.
L'abilitazione del logging binario comporta il riavvio dell'istanza.
Nella sezione Personalizza l'istanza della pagina, aggiorna le impostazioni per la replica. Per iniziare, fai clic su Mostra opzioni di configurazione per visualizzare i gruppi di impostazioni. Quindi, espandi i gruppi che ti interessano per rivedere e personalizzare le impostazioni. A destra viene visualizzato un Riepilogo di tutte le opzioni selezionate. La personalizzazione di queste impostazioni è facoltativa. I valori predefiniti vengono assegnati in tutti i casi in cui non vengono apportate personalizzazioni.
Per ulteriori dettagli su ciascuna impostazione, consulta la pagina Informazioni sulle impostazioni delle istanze.
Ad esempio, per consentire ad altri servizi Cloud de Confiance by S3NS , come BigQuery, di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, espandi il gruppo Connessioni e deseleziona la casella di controllo IP pubblico.
- Fai clic su Crea replica.
Cloud SQL crea un backup, se necessario, e crea la replica. Verrà visualizzata nuovamente la pagina dell'istanza principale.
gcloud
- Controlla lo stato dell'istanza principale:
gcloud sql instances describe PRIMARY_INSTANCE_NAME
Se la proprietà
databaseReplicationEnabledètrue, l'istanza è una replica; non puoi creare una replica di una replica. - Se la proprietà
enabledinbackupConfigurationèfalse, attiva subito i backup per l'istanza principale: Il parametrogcloud sql instances patch PRIMARY_INSTANCE_NAME \ --backup-start-time=>HH:MM
backup-start-timeè specificato nel formato 24 ore, nel fuso orario UTC±00, e indica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup. - Se la proprietà
binaryLogEnabledèfalse, abilita i log binari nell'istanza principale: L'abilitazione dei log binari comporta il riavvio dell'istanza.gcloud sql instances patch PRIMARY_INSTANCE_NAME \ --enable-bin-log
- Crea la replica:
gcloud sql instances create REPLICA_NAME \ --master-instance-name=PRIMARY_INSTANCE_NAME
Se necessario, puoi specificare una dimensione del livello diversa utilizzando il parametro
--tier. Se stai creando una replica da un'istanza principale per MySQL 8.4 e versioni successive e la versione Cloud SQL per l'istanza è Enterprise o Enterprise Plus, non devi specificare un valore per questo parametro. La replica eredita il tipo di macchina dall'istanza principale.Puoi specificare una regione diversa utilizzando il parametro
--region.Puoi aggiungere altri parametri per altre impostazioni dell'istanza. Per saperne di più, consulta gcloud sql instances create.
Se l'istanza principale ha solo un indirizzo IP interno e vuoi consentire ad altri servizi Cloud de Confiance by S3NS , come BigQuery, di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, aggiungi il parametro
--enable-google-private-pathal comando.Devi creare la replica nella stessa rete VPC dell'istanza principale. Puoi anche specificare un
allocated-ip-range-namein quella rete VPC. Se non viene specificato alcun intervallo, la replica viene creata in un intervallo casuale.
-
Il logging binario è supportato nelle istanze di replica di lettura (solo MySQL 5.7 e versioni successive). Non supportato sulle repliche di failover ad alta affidabilità legacy. Abilita il logging binario su una replica con lo stesso comando
gcloud CLI, utilizzando il nome dell'istanza della replica anziché il nome dell'istanza principale.gcloud sql instances patch REPLICA_INSTANCE_NAME \ --enable-bin-log \ --enforce-new-sql-network-architecture
La durabilità del logging binario sull'istanza di replica (ma non su quella principale) può essere impostata con il flag
sync_binlog, che controlla la frequenza con cui il server MySQL sincronizza il log binario sul disco.I backup non possono essere abilitati sulle istanze di replica, ma il logging binario può essere abilitato su una replica anche quando i backup sono disabilitati, a differenza dell'istanza principale.
Il periodo di conservazione dei binlog nelle istanze di replica viene impostato automaticamente su un giorno, a differenza dei sette giorni nelle istanze principali.
- Utilizza il flag
enforce-new-network-architectureper applicare l'utilizzo della nuova architettura di rete per l'istanza al momento della creazione, anche se non è stato eseguito l'upgrade completo del progetto. Per ulteriori dettagli sulla nuova architettura di rete e sulle sue implicazioni, consulta Esegui l'upgrade di un'istanza alla nuova architettura di rete e Alloca un intervallo di indirizzi IP.
Terraform
Per creare una replica di lettura, utilizza la risorsa Terraform.
Applica le modifiche
Per applicare la configurazione di Terraform in un progetto Cloud de Confiance , completa i passaggi descritti nelle sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Cloud de Confiance predefinito in cui vuoi applicare le configurazioni Terraform.
Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.
Prepara la directory
Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo principale).
-
In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione
.tf, ad esempiomain.tf. In questo tutorial, il file è denominatomain.tf.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.
Copia il codice campione nel file
main.tfappena creato.Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
- Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
- Salva le modifiche.
-
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
terraform init
Facoltativamente, per utilizzare l'ultima versione del provider Google, includi l'opzione
-upgrade:terraform init -upgrade
Applica le modifiche
-
Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione di Terraform eseguendo questo comando e inserendo
yesal prompt:terraform apply
Attendi finché Terraform non visualizza il messaggio "Apply complete!".
- Apri il tuo progetto Cloud de Confiance per visualizzare i risultati. Nella console Cloud de Confiance , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.
Elimina le modifiche
Per eliminare le modifiche:
- Per disattivare la protezione da eliminazione, nel file di configurazione Terraform imposta l'argomento
deletion_protectionsufalse.deletion_protection = "false"
- Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo
yesal prompt:terraform apply
-
Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il comando seguente e inserendo
yesal prompt:terraform destroy
REST v1
- Ottieni la configurazione di backup attuale
Utilizza il metodo
getdella risorsa delle istanze per restituire la versione del database e la configurazione di backup corrente per l'istanza principale.Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- 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:
Dovresti ricevere una risposta JSON simile alla seguente:
- Verifica che i campi di replica siano impostati
Se
enabledopointInTimeEnabledsonofalse, utilizza il metodopatchdella risorsa delle istanze per attivarli entrambi. Nella richiesta, specifica le proprietà della configurazione di backup che vuoi modificare.Per abilitare i backup, imposta
enabledsutrueestartTimesu un'ora del giorno nel formatoHH:MM. Il parametrostartTimeè specificato nel formato 24 ore, nel fuso orario UTC±00, e indica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.Per abilitare il recupero point-in-time, imposta
pointInTimeEnabledsutrue.Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza
- INSTANCE_NAME: il nome dell'istanza di replica principale o di lettura che stai configurando per l'alta affidabilità
- START_TIME: l'ora (in ore e minuti)
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON della richiesta:
{ "settings": { "backupConfiguration": { "startTime": "START_TIME", "enabled": true, "binaryLogEnabled": true } } }Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Crea la replica di lettura
Utilizza il metodo
insertdella risorsa instances per creare la replica di lettura. La proprietàdatabaseVersiondeve essere la stessa della proprietà principale. Se l'istanza principale utilizza un indirizzo IP interno, puoi specificare unallocatedIpRangenello stesso modo in cui crei un'istanza principale. Se non viene specificato alcun intervallo, la replica viene creata in un intervallo casuale. Per una replica di lettura tra regioni, specifica una regione diversa da quella dell'istanza principale.Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- database-version: stringa della versione enum (ad esempio MYSQL_8_0)
- primary-instance-name: il nome dell'istanza principale
- primary-instance-region: la regione dell'istanza principale
- replica-region: la regione dell'istanza di replica
- replica-name: il nome dell'istanza di replica
- machine-type: stringa enum del tipo di macchina. Ad esempio: "db-custom-1-3840"
- private-network: la rete autorizzata che stai aggiungendo o selezionando per creare una connessione privata.
Puoi utilizzare il campo
sqlNetworkArchitectureper applicare l'utilizzo della nuova architettura di rete per l'istanza al momento della creazione, anche se non è stato eseguito l'upgrade completo del progetto. Per ulteriori dettagli sulla nuova architettura di rete e sulle sue implicazioni, consulta Esegui l'upgrade di un'istanza alla nuova architettura di rete e Alloca un intervallo di indirizzi IP.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", "settingsVersion": 0, "ipConfiguration": { object (IpConfiguration) }, { "ipv4Enabled": false, "privateNetwork": private-network, "requireSsl": boolean, "authorizedNetworks": [ { object (AclEntry) } ], "allocatedIpRange": string } }, "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE" }Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
REST v1beta4
- Ottieni la configurazione di backup attuale
Utilizza il metodo
getdella risorsa instances per restituire la versione del database e la configurazione di backup corrente per l'istanza principale.Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- primary-instance-name: il nome dell'istanza principale
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Verifica che i campi di replica siano impostati
Se
enabledobinaryLogEnabledsonofalsenell'istanza principale, utilizza il metodopatchdella risorsa delle istanze per attivarli entrambi. Nella richiesta, specifica le proprietà della configurazione di backup che vuoi modificare.Per abilitare i backup, imposta
enabledsutrueestartTimesu un'ora del giorno nel formatoHH:MM. Il parametrostartTimeè specificato nel formato 24 ore, nel fuso orario UTC±00, e indica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.Per abilitare il recupero point-in-time, imposta
binaryLogEnabledsutruenell'istanza principale.Il logging binario è supportato nelle istanze di replica di lettura (solo MySQL 5.7 e versioni successive). Abilita il logging binario su una replica con la stessa API, utilizzando l'ID istanza della replica anziché l'ID istanza della replica principale.
La durabilità del logging binario sull'istanza di replica (ma non su quella principale) può essere impostata con il flag
sync_binlog, che controlla la frequenza con cui il server MySQL sincronizza il log binario sul disco.I backup non possono essere abilitati sulle istanze di replica, ma il logging binario può essere abilitato su una replica anche quando i backup sono disabilitati, a differenza dell'istanza principale.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza
- INSTANCE_NAME: il nome dell'istanza di replica principale o di lettura che stai configurando per l'alta affidabilità
- START_TIME: l'ora (in ore e minuti)
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON della richiesta:
{ "settings": { "backupConfiguration": { "startTime": "START_TIME", "enabled": true, "binaryLogEnabled": true } } }Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Crea la replica di lettura
Utilizza il metodo
insertdella risorsa instances per creare la replica di lettura. La proprietàdatabaseVersiondeve essere la stessa della proprietà principale. Se l'istanza principale utilizza un indirizzo IP interno, puoi specificare unallocatedIpRangenello stesso modo in cui crei un'istanza principale. Per una replica di lettura tra regioni, specifica una regione diversa da quella dell'istanza principale.Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- database-version: stringa della versione enum (ad esempio MYSQL_8_0)
- primary-instance-name: il nome dell'istanza principale
- primary-instance-region: la regione dell'istanza principale
- replica-region: la regione dell'istanza di replica
- replica-name: il nome dell'istanza di replica
- machine-type: stringa enum del tipo di macchina. Ad esempio: "db-custom-1-3840"
- private-network: la rete autorizzata che stai aggiungendo o selezionando per creare una connessione privata.
Puoi utilizzare il campo
sqlNetworkArchitectureper applicare l'utilizzo della nuova architettura di rete per l'istanza al momento della creazione, anche se non è stato eseguito l'upgrade completo del progetto. Per ulteriori dettagli sulla nuova architettura di rete e sulle sue implicazioni, consulta Esegui l'upgrade di un'istanza alla nuova architettura di rete e Alloca un intervallo di indirizzi IP.Metodo HTTP e URL:
POST https://sqladmin.googleapis.com/sql/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", "settingsVersion": 0, "ipConfiguration": { object (IpConfiguration) }, { "ipv4Enabled": false, "privateNetwork": private-network, "requireSsl": boolean, "authorizedNetworks": [ { object (AclEntry) } ], "allocatedIpRange": string } }, "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE" }Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Crea una replica di lettura di un'istanza con Private Service Connect abilitato
Per creare una replica di lettura di un'istanza con Private Service Connect abilitato, utilizza l'interfaccia a riga di comando gcloud o l'API. Puoi creare questa replica nella stessa regione o in una regione diversa dall'istanza principale (replica di lettura tra regioni).
La replica di lettura non può essere replicata da un'istanza con un tipo di connettività diverso. Ad esempio, un'istanza con Private Service Connect abilitato può eseguire la replica solo da un'altra istanza Private Service Connect. Inoltre, non può eseguire la replica da un'istanza che supporta connessioni IP esterne o da un'istanza configurata con l'accesso privato ai servizi.
gcloud
Per creare una replica di lettura di un'istanza, utilizza il comando gcloud sql instances create:
gcloud sql instances create REPLICA_INSTANCE_NAME \ --master-instance-name=PRIMARY_INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION_NAME \ --enable-private-service-connect \ --allowed-psc-projects=ALLOWED_PROJECTS \ --availability-type=AVAILABILITY_TYPE \ --no-assign-ip \ --tier=TIER \ --edition=EDITION
Effettua le seguenti sostituzioni:
- REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
- PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza.
- REGION_NAME: il nome della regione per l'istanza di replica.
ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.
Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il Cloud SQL Auth Proxy o i connettori dei linguaggi di Cloud SQL, crea una zona DNS e un record DNS per le repliche.
- AVAILABILITY_TYPE: abilita l'alta affidabilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL: abilita l'alta affidabilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover in un'altra zona all'interno della regione selezionata.ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta affidabilità per le istanze, consulta Configura un'istanza esistente per l'alta affidabilità e Disattiva l'alta affidabilità per un'istanza.
- TIER: il tipo di macchina per l'istanza di replica, ad esempio
db-perf-optimized-N-4odb-custom-2-7680. Questo parametro è obbligatorio se l'istanza principale è un'istanza Cloud SQL Enterprise Plus che utilizza PostgreSQL 15 e versioni precedenti, MySQL 8.0 e versioni precedenti o SQL Server. Per altre istanze, questo parametro è facoltativo e la replica eredita il livello della macchina dall'istanza principale. - EDITION: la versione di Cloud SQL per l'istanza di replica (
ENTERPRISEoENTERPRISE_PLUS). Questo parametro è obbligatorio se l'istanza principale è un'istanza Cloud SQL Enterprise Plus che utilizza PostgreSQL 15 e versioni precedenti, MySQL 8.0 e versioni precedenti o SQL Server. Per le altre istanze, questo parametro è facoltativo e la replica eredita la versione dall'istanza principale.
REST v1
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza.
- REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
- REGION_NAME: il nome della regione per l'istanza di replica.
- MACHINE_TYPE: il tipo di macchina per l'istanza
- AVAILABILITY_TYPE: abilita l'alta affidabilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL: abilita l'alta affidabilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover in un'altra zona all'interno della regione selezionata.ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta affidabilità per le istanze, consulta Configura un'istanza esistente per l'alta affidabilità e Disattiva l'alta affidabilità per un'istanza.
ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.
Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il proxy di autenticazione Cloud SQL o i connettori dei linguaggi di Cloud SQL, devi creare una zona DNS e un record DNS per le repliche.
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": "MYSQL_8_0",
"name": "REPLICA_INSTANCE_NAME",
"region": "REGION_NAME",
"kind": "sql#instance",
"settings":
{
"tier": "MACHINE_TYPE",
"availabilityType": "AVAILABILITY_TYPE",
"settingsVersion": 0,
"ipConfiguration": {
"ipv4Enabled": false,
"pscConfig": {
"allowedConsumerProjects": [ALLOWED_PROJECTS],
"pscEnabled": true
}
},
"kind": "sql#settings",
"pricingPlan": "PER_USE",
"replicationType": "ASYNCHRONOUS",
"tier": "MACHINE_TYPE"
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "CREATE_REPLICA",
"name": "OPERATION_ID",
"targetId": "REPLICA_INSTANCE_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, apporta le sostituzioni seguenti:
- PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza.
- REPLICA_INSTANCE_NAME: il nome dell'istanza di replica.
- REGION_NAME: il nome della regione per l'istanza di replica.
- MACHINE_TYPE: il tipo di macchina per l'istanza
- AVAILABILITY_TYPE: abilita l'alta affidabilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL: abilita l'alta affidabilità ed è consigliato per le istanze di produzione. L'istanza esegue il failover in un'altra zona all'interno della regione selezionata.ZONAL: non forniscono funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta affidabilità per le istanze, consulta Configura un'istanza esistente per l'alta affidabilità e Disattiva l'alta affidabilità per un'istanza.
ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.
Cloud SQL non copia i progetti consentiti per l'istanza principale nella replica. Per ogni replica, devi creare un endpoint Private Service Connect. Se utilizzi il proxy di autenticazione Cloud SQL o i connettori dei linguaggi di Cloud SQL, devi creare una zona DNS e un record DNS per le repliche.
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances
Corpo JSON della richiesta:
{
"masterInstanceName": "PRIMARY_INSTANCE_NAME",
"project": "PROJECT_ID",
"databaseVersion": "MYSQL_8_0",
"name": "REPLICA_INSTANCE_NAME",
"region": "REGION_NAME",
"kind": "sql#instance",
"settings":
{
"tier": "MACHINE_TYPE",
"availabilityType": "AVAILABILITY_TYPE",
"settingsVersion": 0,
"ipConfiguration": {
"ipv4Enabled": false,
"pscConfig": {
"allowedConsumerProjects": [ALLOWED_PROJECTS],
"pscEnabled": true
}
},
"kind": "sql#settings",
"pricingPlan": "PER_USE",
"replicationType": "ASYNCHRONOUS",
"tier": "MACHINE_TYPE"
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "CREATE_REPLICA",
"name": "OPERATION_ID",
"targetId": "REPLICA_INSTANCE_NAME",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Configura le repliche di lettura per l'autenticazione database IAM
Il flagcloudsql_iam_authentication non viene attivato automaticamente sulle repliche di lettura quando viene attivato sull'istanza principale.
Per configurare una replica di lettura per l'autenticazione database IAM:
-
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Nel riquadro Configurazione, cerca il flag
cloudsql_iam_authentication. Se il flag non è presente nell'elenco, non è necessario attivarlo nella replica di lettura. Se il flag è presente nell'elenco, devi abilitarlo sulla replica di lettura. Se devi attivare il flag sulla replica di lettura, vai al passaggio successivo. - Seleziona Repliche dal menu di navigazione SQL.
- Fai clic sul nome della replica da modificare.
- Fai clic su Modifica.
- Nella sezione Opzioni di configurazione, espandi Flag.
- Seleziona + Aggiungi elemento.
- Inserisci
cloudsql_iam_authenticationcome nome del flag. Assicurati che l'opzione On sia selezionata per questo flag. - Fai clic su Salva.
Crea repliche a cascata
Questa sezione descrive come creare e gestire le repliche a cascata.
Per informazioni su come funzionano le repliche a cascata, consulta Repliche a cascata.
Procedura per creare una replica a cascata
Console
-
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
- Per MySQL 5.7 o versioni successive, abilita la replica.
- Fai clic sulla scheda Repliche per la replica che fungerà da elemento principale per la replica che vuoi creare.
- Fai clic su Crea replica.
- Nella pagina Crea replica di lettura, aggiorna l'ID istanza e tutte le altre opzioni di configurazione, inclusi il nome, la regione e la zona.
- Fai clic su Crea.
Cloud SQL crea una replica. Viene visualizzata la pagina dell'istanza per la replica principale.
- Segui i passaggi 4-6 per ogni nuova replica a cascata che vuoi creare.
gcloud
- Se utilizzi MySQL versione 5.7 o successive, attiva i binlog per l'istanza principale della nuova replica:
Sostituisci PARENT_REPLICA_NAME con il nome della replica principale.gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME
- Crea la nuova replica specificando la replica principale come istanza principale utilizzando il flag
--master-instance-name: - REPLICA_NAME: l'ID univoco della replica che stai creando
- PARENT_REPLICA_NAME: il nome della replica principale
- Dopo aver creato la replica a cascata, puoi vedere che le modifiche apportate all'istanza principale vengono replicate in tutte le repliche della catena di repliche a cascata.
gcloud sql instances create REPLICA_NAME \ --master-instance-name=PARENT_REPLICA_NAME \
curl
- Se utilizzi MySQL versione 5.7 o successive, abilita il logging binario:
Per abilitare il logging binario, salva il seguente JSON in un file denominato request.JSON, quindi richiama il comando curl per abilitare il logging binario.
{ "settings": { "backupConfiguration": { "enabled": false, "binaryLogEnabled": true } } }
- Per creare una replica sotto la replica principale, modifica il seguente esempio di codice JSON e salvalo in un file denominato
request.json:{ "masterInstanceName": "PARENT_REPLICA_NAME", "project": "PROJECT_ID", "name": "REPLICA_NAME", "region": "REPLICA_REGION", "settings": { "tier": "MACHINE_TYPE", } }
- 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"
Risoluzione dei problemi
| Problema | Risoluzione dei problemi |
|---|---|
| La replica di lettura non ha avviato la replica al momento della creazione. | Probabilmente nei file di log è presente un errore più specifico. Ispeziona i log in Cloud Logging per trovare l'errore effettivo. |
| Impossibile creare la replica di lettura - Errore invalidFlagValue. | Uno dei flag nella richiesta non è valido. Potrebbe essere un flag che hai fornito esplicitamente o uno impostato su un valore predefinito.
Innanzitutto, verifica che il valore del flag Se il flag |
| Impossibile creare la replica di lettura. Errore sconosciuto. | Probabilmente nei file di log è presente un errore più specifico.
Ispeziona i log in Cloud Logging per trovare l'errore effettivo.
Se l'errore è |
| Lo spazio sul disco è esaurito. | Le dimensioni del disco dell'istanza principale possono riempirsi durante la creazione della replica. Modifica l'istanza principale per eseguire l'upgrade a un disco di dimensioni maggiori. |
| L'istanza di replica utilizza troppa memoria. | La replica utilizza la memoria temporanea per memorizzare nella cache le operazioni di lettura richieste di frequente, il che può comportare un utilizzo di memoria maggiore rispetto all'istanza principale.
Riavvia l'istanza di replica per recuperare lo spazio di memoria temporaneo. |
| Replica interrotta. | È stato raggiunto il limite massimo di spazio di archiviazione e l'aumento automatico dello spazio di archiviazione non è abilitato.
Modifica l'istanza per abilitare |
| Il ritardo di replica è costantemente elevato. | Il carico di scrittura è troppo elevato per essere gestito dalla replica. Il ritardo di replica si verifica quando il thread SQL su una replica non riesce a tenere il passo con il thread IO. Alcuni tipi di query o workload possono causare un ritardo di replica elevato temporaneo o permanente per un determinato schema. Alcune delle cause tipiche del ritardo di replica sono:
Ecco alcune possibili soluzioni:
|
| Il ritardo della replica aumenta improvvisamente. | Ciò è causato da transazioni a lunga esecuzione. Quando viene eseguito il commit di una transazione (singola istruzione o più istruzioni) nell'istanza di origine, l'ora di inizio della transazione viene registrata nel log binario. Quando la replica riceve questo evento binlog, confronta il timestamp con quello corrente per calcolare il ritardo di replica. Pertanto, una transazione a lunga esecuzione nell'origine comporterebbe un ritardo di replica immediato nella replica. Se il numero di modifiche alle righe nella transazione è elevato, anche la replica impiegherà molto tempo per eseguirla. Durante questo periodo, il ritardo della replica aumenta. Una volta che la replica ha completato questa transazione, il periodo di recupero dipende dal workload di scrittura sull'origine e dalla velocità di elaborazione della replica.
Per evitare una transazione lunga, alcune possibili soluzioni includono:
|
| La modifica dei flag di replica parallela genera un errore. | È stato impostato un valore errato per uno o più di questi flag.
Nell'istanza principale che visualizza il messaggio di errore, imposta i flag di replica parallela:
|
| La creazione della replica non riesce con un timeout. | Le transazioni non sottoposte a commit di lunga durata nell'istanza principale possono causare
la mancata creazione della replica di lettura.
Ricrea la replica dopo aver interrotto tutte le query in esecuzione. |
Passaggi successivi
- Scopri come gestire le repliche.
- Scopri di più sulle repliche tra regioni.
- Scopri di più sui pool di lettura.
- Scopri di più sul disaster ripristino di emergenza (RE) avanzato