Questa pagina descrive come configurare una nuova istanza Cloud SQL utilizzando Cloud Tools per PowerShell. Leggi la documentazione di riferimento dei cmdlet di Cloud Tools for PowerShell per scoprire di più sui cmdlet.
Per la maggior parte dei cmdlet puoi specificare un ID progetto, ma se lo ometti, PowerShell assume come valore predefinito quello specificato nella configurazione dell'interfaccia a riga di comando gcloud attiva.
Configurazione di una nuova istanza
Un'istanza Cloud SQL è un database MySQL in esecuzione nel cloud. Puoi utilizzare le istanze Cloud SQL per archiviare, replicare e proteggere i tuoi database MySQL. Puoi configurare il comportamento dell'istanza, ad esempio quando e in cui i dati verranno replicati o quando è accettabile eseguire manutenzione.
Per creare e avviare un database Cloud SQL, devi prima specificarne
configurazione e impostazioni. Per farlo con Cloud Tools for PowerShell, utilizza la
cmdlet New-GcSqlSettingConfig e New-GcSqlInstanceConfig.
Le impostazioni SQL, come il logging, le finestre di manutenzione e così via, sono parametri del cmdlet New-GcSqlSettingConfig. Le impostazioni a livello di istanza, ad esempio le caratteristiche hardware della macchina del database, vengono impostate tramite l'oggetto SqlInstanceConfig o i flag del cmdlet New-GcSqlInstanceConfig.
Se non specifichi parametri, viene creata l'istanza Cloud SQL più semplice, utilizzando il livello "db-n1-standard-1":
$setting = New-GcSqlSettingConfig
$instance = New-GcSqlInstanceConfig `
"mynewinstance" -SettingConfig $setting
Per informazioni sui livelli e sui prezzi, consulta l'argomento Prezzi di Cloud SQL.
Per informazioni sulle opzioni di configurazione, utilizza Get-Help New-GcSqlSettingConfig
o consulta la documentazione dell'oggetto
DatabaseInstance.
Creazione di una nuova istanza
Dopo aver eseguito la configurazione descritta nella sezione precedente, ora puoi creare il database Cloud SQL utilizzando il cmdlet Add-GcSqlInstance:
Add-GcSqlInstance $instance
La creazione di una nuova istanza potrebbe richiedere circa un minuto. Al termine del processo,
cmdlet restituisce un oggetto DatabaseInstance che descrive l'istanza
è stato creato. Puoi andare alla console Google Cloud per visualizzare l'istanza.
Da questo momento in poi, puoi gestire il database come descritto nella documentazione di Cloud SQL.
Creazione di un'istanza di replica di lettura
Le istanze di replica di lettura forniscono di replicare i dati in un'istanza master. Dopo la creazione, possono essere convertiti in un failover o in una propria istanza autonoma. I dati possono essere letti dalle istanze di replica di lettura, ma potrebbero essere semi-obsoleti, in conformità con la replica semi sincrona. Se esegui il backup dei dati in più regioni tramite istanze di replica di lettura, i dati possono essere ancora letti in caso di interruzione.
Il seguente snippet di codice crea una replica di lettura mynewreplica per l'istanza principale gootoso già esistente. Lo snippet utilizza il comando
New-GcSqlInstanceReplicaConfig. Questo comando configura le impostazioni specifiche per la lettura
di istanze di replica, ad esempio la velocità con cui replicano i dati o
da un'istanza esterna:
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig
$instance = New-GcSqlInstanceConfig "mynewreplica" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instancePer ulteriori informazioni sui requisiti delle repliche di lettura, consulta Requisiti e suggerimenti per configurare la replica.
Per una dimostrazione di come promuovere una replica di lettura in un'istanza autonoma o di failover, consulta Gestire le repliche delle istanze.
Creazione di un'istanza di replica di failover
Cloud SQL fornisce la configurazione ad alta disponibilità per le istanze tramite l'utilizzo di repliche di failover. Le repliche di failover usano semisincroni replica per replicare tutte le modifiche apportate ai dati nell'istanza master. Se la zona un'istanza master subisce un'interruzione, la replica di failover viene attivata prende il controllo. Per questo motivo, la replica deve trovarsi in una zona diversa da quella principale.
Il seguente snippet di codice crea una nuova replica di failover myfailover per
dell'istanza master gootoso. L'istanza replica viene creata come sopra, utilizzando i cmdlet di configurazione. Tuttavia, tieni presente l'aggiunta del flag -FailoverTarget:
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig -FailoverTarget
$instance = New-GcSqlInstanceConfig "myfailover" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instanceTieni presente che le istanze di replica influiscono sulla fatturazione come le istanze normali.