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 all'istanza principale quasi in tempo reale, in circostanze normali. Puoi utilizzare una replica di lettura per ridurre il carico delle richieste di lettura o del traffico di analisi dall'istanza principale.
Inoltre, per il ripristino di emergenza, puoi eseguire una migrazione a livello di regione. 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 considereranno l'istanza principale).
Per ulteriori informazioni su come funziona la replica, consulta Replica in Cloud SQL.
Prima di iniziare
Se stai creando la prima replica per questa istanza, assicurati che quest'ultima soddisfi i requisiti per le istanze principali. Ulteriori informazioni
Crea una replica di lettura
Di seguito sono riportati i passaggi per creare una replica di lettura.
Console
-
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
- Trova l'istanza per cui vuoi creare una replica, quindi apri il menu
more actions
all'estrema destra dell'elenco. - Seleziona Crea replica di lettura.
Se non vedi questa opzione, significa che l'istanza è una replica; non puoi creare una replica di una replica.
- Se per l'istanza sono abilitati i backup e il logging binario, vai al passaggio successivo. In caso contrario, seleziona Backup
automatici e Abilita il logging binario, fai clic su Continua e
quindi fai clic 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. Inizia facendo clic su Mostra opzioni di configurazione per visualizzare i gruppi di impostazioni. Quindi, espandi i gruppi che ti interessano da esaminare e personalizza le impostazioni. A destra viene visualizzato un riepilogo di tutte le opzioni selezionate. La personalizzazione di queste impostazioni è facoltativa. I valori predefiniti vengono assegnati ogni volta che non vengono effettuate personalizzazioni.
Per saperne di più su ciascuna impostazione, consulta la pagina Informazioni sulle impostazioni dell'istanza.
Ad esempio, per consentire ad altri servizi Google Cloud come BigQuery di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione interna, espandi il gruppo Connessioni e poi deseleziona la casella di controllo IP pubblico.
- Fai clic su Crea replica.
Cloud SQL crea un backup, se necessario, e la replica. Tornerai alla pagina dell'istanza per l'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à
enabled
inbackupConfiguration
èfalse
, abilita ora i backup per l'istanza principale:gcloud sql instances patch PRIMARY_INSTANCE_NAME \ --backup-start-time=>HH:MM
Il parametrobackup-start-time
è specificato nel formato 24 ore, nel fuso orario UTC±00, e specifica l'inizio di una finestra di backup di 4 ore. I backup possono essere avviati in qualsiasi momento durante la finestra di backup. - Se la proprietà
binaryLogEnabled
èfalse
, abilita i log binari nell'istanza principale:gcloud sql instances patch PRIMARY_INSTANCE_NAME \ --enable-bin-log
L'abilitazione dei log binari comporta il riavvio dell'istanza. - 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
.Puoi specificare una regione diversa utilizzando il parametro
--region
.Puoi aggiungere altri parametri per altre impostazioni dell'istanza. Per ulteriori informazioni, consulta gcloud sql instances create.
Se l'istanza principale ha solo un indirizzo IP interno e vuoi consentire ad altri servizi Google Cloud, 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-path
al comando.Devi creare la replica nella stessa rete VPC dell'istanza principale. Puoi anche specificare un
allocated-ip-range-name
nella rete VPC. Se non viene specificato alcun intervallo, la replica viene creata in un intervallo casuale.
-
Il logging binario è supportato sulle istanze di replica di lettura (solo MySQL 5.7 e 8.0). Non supportata sulle repliche di failover ad alta disponibilità 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
La durabilità del logging binario nell'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 su 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 binlog nelle istanze di replica viene impostato automaticamente su un giorno, a differenza di sette giorni nelle istanze principali.
Terraform
Per creare una replica di lettura, utilizza risorsa Terraform.
Applica le modifiche
Per applicare la tua configurazione Terraform a un progetto Google Cloud, completa i passaggi nelle sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Google Cloud predefinito a 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 del 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 nuovo oggetto
main.tf
.Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata se 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 la versione più recente 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à soddisfino le tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione Terraform eseguendo questo comando e inserendo
yes
al prompt:terraform apply
Attendi finché in Terraform non viene visualizzato il messaggio "Applicazione completata!".
- Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti che Terraform le abbia create o aggiornate.
Elimina le modifiche
Per eliminare le modifiche:
- Per disabilitare la protezione dall'eliminazione, imposta l'argomento
deletion_protection
nel file di configurazione di Terraform sufalse
.deletion_protection = "false"
- Applica la configurazione Terraform aggiornata eseguendo questo comando e
inserendo
yes
al prompt:terraform apply
-
Per rimuovere le risorse applicate in precedenza con la tua configurazione Terraform, esegui questo comando e inserisci
yes
al prompt:terraform destroy
REST v1
- Recuperare la configurazione attuale del backup
Utilizza il metodo
get
della risorsa istanze per restituire la versione del database e l'attuale configurazione del backup per l'istanza principale.Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- 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 delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Verifica che i campi di replica siano impostati
Se
enabled
opointInTimeEnabled
sonofalse
, utilizza il metodopatch
della risorsa istanze per abilitarle entrambe. Nella richiesta, specifica le proprietà della configurazione di backup che vuoi modificare.Per abilitare i backup, imposta
enabled
sutrue
estartTime
su un'ora del giorno in formatoHH:MM
. Il parametrostartTime
è specificato nel formato di 24 ore, nel fuso orario UTC±00, e specifica l'inizio di una finestra di backup di 4 ore. I backup possono essere avviati in qualsiasi momento durante la finestra di backup.Per abilitare il recupero point-in-time, imposta
pointInTimeEnabled
sutrue
.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 principale o di replica di lettura che stai configurando per l'alta disponibilità
- 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 delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Crea la replica di lettura
Utilizza il metodo
insert
della risorsa instances per creare la replica di lettura. La proprietàdatabaseVersion
deve essere uguale alla proprietà principale. Se l'istanza principale utilizza un indirizzo IP interno, puoi specificare unallocatedIpRange
nello 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, effettua le seguenti sostituzioni:
- 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.
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 } } }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
REST v1beta4
- Recuperare la configurazione attuale del backup
Utilizza il metodo
get
della risorsa istanze per restituire la versione del database e l'attuale configurazione del backup per il master.Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- 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 delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Verifica che i campi di replica siano impostati
Se
enabled
obinaryLogEnabled
sonofalse
sull'istanza principale, utilizza il metodopatch
della risorsa delle istanze per abilitarle entrambe. Nella richiesta, specifica le proprietà della configurazione del backup che vuoi modificare.Per abilitare i backup, imposta
enabled
sutrue
estartTime
su un'ora del giorno in formatoHH:MM
. Il parametrostartTime
è specificato nel formato di 24 ore, nel fuso orario UTC±00, e specifica l'inizio di una finestra di backup di 4 ore. I backup possono essere avviati in qualsiasi momento durante la finestra di backup.Per abilitare il recupero point-in-time, imposta
binaryLogEnabled
sutrue
nell'istanza principale.Il logging binario è supportato sulle istanze di replica di lettura (solo MySQL 5.7 e 8.0). Abilita il logging binario su una replica con la stessa API utilizzando l'ID istanza della replica anziché l'ID istanza principale.
La durabilità del logging binario nell'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 su 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, 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 principale o di replica di lettura che stai configurando per l'alta disponibilità
- 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 delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Crea la replica di lettura
Utilizza il metodo
insert
della risorsa instances per creare la replica di lettura. La proprietàdatabaseVersion
deve essere uguale alla proprietà principale. Se l'istanza principale utilizza un indirizzo IP interno, puoi specificare unallocatedIpRange
nello 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, effettua le seguenti sostituzioni:
- 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.
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 } } }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Crea una replica di lettura di un'istanza in cui è abilitato Private Service Connect
Per creare una replica di lettura di un'istanza con Private Service Connect abilitato, utilizza gcloud CLI o l'API. Puoi creare questa replica nella stessa regione o in una regione diversa rispetto all'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ò replicare solo da un'altra istanza Private Service Connect. Inoltre, non può essere replicato da un'istanza che supporta le connessioni IP esterni o da un'istanza configurata con 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
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 Google Cloud che contiene l'istanza.
- REGION_NAME: il nome della regione per l'istanza di replica.
ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è contenuto in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect per l'istanza.
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 del linguaggio Cloud SQL, crea una zona DNS e un record DNS per le repliche.
- AVAILABILITY_TYPE: abilita l'alta disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL
: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. Il failover dell'istanza viene eseguito su un'altra zona all'interno della regione selezionata.ZONAL
: non fornisce funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta disponibilità per le istanze, vedi Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.
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 di progetto del progetto Google Cloud 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 disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL
: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. Il failover dell'istanza viene eseguito su un'altra zona all'interno della regione selezionata.ZONAL
: non fornisce funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta disponibilità per le istanze, vedi Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.
ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è contenuto in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect per l'istanza.
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 delle seguenti 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, effettua le seguenti sostituzioni:
- PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud 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 disponibilità per l'istanza. Per questo parametro, specifica uno dei seguenti valori:
REGIONAL
: abilita l'alta disponibilità ed è consigliato per le istanze di produzione. Il failover dell'istanza viene eseguito su un'altra zona all'interno della regione selezionata.ZONAL
: non fornisce funzionalità di failover. Questo è il valore predefinito.
Per saperne di più sull'impostazione e sulla rimozione dell'alta disponibilità per le istanze, vedi Configurare un'istanza esistente per l'alta disponibilità e Disattivare l'alta disponibilità per un'istanza.
ALLOWED_PROJECTS: un elenco di ID o numeri di progetto consentiti, separati da virgole. Se un progetto non è contenuto in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect per l'istanza.
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 delle seguenti 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 IAM dei database
Per le repliche di lettura non è abilitato automaticamente il flagcloudsql_iam_authentication
quando è abilitato sull'istanza principale.
Per configurare una replica di lettura per l'autenticazione del database IAM:
-
Nella console Google Cloud, 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 è nell'elenco, non è necessario abilitarlo nella replica di lettura. Se il flag è presente nell'elenco, devi abilitare il flag sulla replica di lettura. Se devi abilitare il flag sulla replica di lettura, continua con il passaggio successivo. - Seleziona Repliche dal menu di navigazione SQL.
- Fai clic sul nome della replica che vuoi modificare.
- Fai clic su Modifica.
- Nella sezione Opzioni di configurazione, espandi Flag.
- Seleziona + Aggiungi elemento.
- Inserisci
cloudsql_iam_authentication
come nome della segnalazione. Assicurati che per questo flag sia selezionata l'opzione On. - Fai clic su Salva.
Crea repliche a cascata
Questa sezione descrive come creare e gestire le repliche a cascata. Per informazioni sul funzionamento delle repliche a cascata, consulta la sezione Replica a cascata.
Prima di iniziare
L'istanza principale deve avere una replica di lettura. Per saperne di più sulla creazione di istanze principali, consulta Creare una replica di lettura.
Passaggi per creare una replica a cascata
Console
-
Nella console Google Cloud, 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 agirà da padre per la replica che vuoi creare.
- Fai clic su Crea replica.
- Nella pagina Crea replica di lettura, aggiorna l'ID istanza ed eventuali altre opzioni di configurazione, inclusi il nome, la regione e la zona.
- Fai clic su Crea.
Cloud SQL crea una replica. Tornerai alla pagina dell'istanza per la replica padre.
- Segui i passaggi 4-6 per ogni nuova replica a cascata che vuoi creare.
gcloud
- Se utilizzi MySQL 5.7 o versioni successive, abilita i binlog per l'istanza principale della nuova replica:
gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME
Sostituisci PARENT_REPLICA_NAME con il nome della replica padre. - Crea la nuova replica specificando la replica principale come istanza principale mediante il flag
--master-instance-name
:gcloud sql instances create REPLICA_NAME \ --master-instance-name=PARENT_REPLICA_NAME \
Sostituisci quanto segue:
- REPLICA_NAME: l'ID univoco della replica che stai creando
- PARENT_REPLICA_NAME: il nome della replica principale
- Dopo aver creato la replica, puoi vedere che le modifiche apportate all'istanza principale vengono replicate in tutte le repliche nella catena di repliche a cascata.
curl
- Se utilizzi MySQL 5.7 o versioni 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 nella replica padre, 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"
Risolvere i problemi
Problema | Risoluzione dei problemi |
---|---|
La replica di lettura non è stata avviata al momento della creazione. | Probabilmente contiene un errore più specifico nei file di log. Esamina 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 da te fornito esplicitamente o impostato su un valore predefinito.
Innanzitutto, verifica che il valore del flag Se il flag |
Impossibile creare la replica di lettura: errore sconosciuto. | Probabilmente contiene un errore più specifico nei file di log.
Esamina i log in Cloud Logging per trovare l'errore effettivo.
Se l'errore è: |
Il disco è pieno. | La dimensione del disco dell'istanza principale può diventare piena durante la creazione della replica. Modifica l'istanza principale per eseguirne l'upgrade a una dimensione del disco maggiore. |
L'istanza di replica utilizza troppa memoria. | La replica utilizza la memoria temporanea per memorizzare nella cache le operazioni di lettura richieste
più spesso, il che può comportare l'utilizzo di più memoria 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 della replica è costantemente elevato. | Il carico di scrittura è troppo elevato per essere gestito dalla replica. Il ritardo della replica si verifica quando il thread SQL su una replica non è in grado di stare al passo con il thread di IO. Alcuni tipi di query o carichi di lavoro possono causare un ritardo di replica temporaneo o permanente elevato per uno schema specifico. Alcune delle cause tipiche del ritardo della 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 (istruzione singola o più istruzioni) sull'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 il timestamp attuale per calcolare il ritardo della replica. Di conseguenza, una transazione a lunga esecuzione
sull'origine comporterebbe un ritardo di replica immediato di un elevato livello sulla
replica. Se il numero di modifiche delle righe nella transazione è elevato, anche la replica impiegherà molto tempo per eseguirla. Durante questo periodo, il ritardo della replica è in aumento. Una volta che la replica termina questa transazione, il periodo di recupero dipende dal carico di lavoro di scrittura sull'origine e dalla velocità di elaborazione della replica.
Per evitare una transazione lunga, alcune possibili soluzioni sono:
|
La modifica dei flag di replica parallela genera un errore. | Per uno o più di questi flag è stato impostato un valore errato.
Nell'istanza principale in cui viene visualizzato il messaggio di errore, imposta i flag di replica parallela:
|
La creazione della replica non riesce con il timeout. | Le transazioni non impegnate a lunga esecuzione sull'istanza principale possono causare un errore nella 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.