Questa pagina descrive come configurare una nuova istanza Cloud SQL utilizzando Cloud Tools for PowerShell. Per saperne di più sui cmdlet, consulta il riferimento su Cloud Tools for PowerShell.
Per la maggior parte dei cmdlet puoi specificare un ID progetto, ma, se lo ometti, PowerShell utilizza per impostazione predefinita qualsiasi valore specificato nella configurazione dell'interfaccia a riga di comando di 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 dove i dati verranno replicati o quando è accettabile eseguire la manutenzione del database.
Per creare e avviare un database Cloud SQL, devi prima specificarne la configurazione e le impostazioni. Per eseguire questa operazione con Cloud Tools for PowerShell, utilizza i cmdlet New-GcSqlSettingConfig e New-GcSqlInstanceConfig.
Le impostazioni SQL, come il logging, i periodi 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 sul cmdlet New-GcSqlInstanceConfig.
Se non specifichi nessun parametro, viene creata l'istanza Cloud SQL di base, utilizzando il livello "db-n1-standard-1":
$setting = New-GcSqlSettingConfig
$instance = New-GcSqlInstanceConfig `
"mynewinstance" -SettingConfig $setting
Per informazioni su livelli e prezzi, consulta l'argomento Prezzi di Cloud SQL.
Per informazioni sulle opzioni di configurazione, utilizza Get-Help New-GcSqlSettingConfig o consulta la documentazione degli oggetti DatabaseInstance.
Creazione di una nuova istanza
Dopo aver eseguito la configurazione descritta nella sezione precedente, puoi creare il database Cloud SQL utilizzando il
cmdlet Add-GcSqlInstance:
Add-GcSqlInstance $instance
La creazione di una nuova istanza può richiedere circa un minuto. Al termine del processo, il cmdlet restituisce un oggetto DatabaseInstance che descrive l'istanza appena creata. 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 funzionalità di replica per 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 semisincrona. Eseguendo il backup dei dati in più regioni tramite istanze di replica di lettura, i dati possono comunque essere letti in caso di interruzione.
Il seguente snippet di codice crea una replica di lettura mynewreplica per l'istanza master già esistente gootoso. Lo snippet utilizza il Cmdlet
New-GcSqlInstanceReplicaConfig. Questa opzione configura le impostazioni specifiche per le istanze di replica di lettura, ad esempio la velocità con cui replicano i dati o se vengono replicati 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 $instance
Per ulteriori informazioni sui requisiti della replica di lettura, consulta Requisiti e suggerimenti per configurare la replica.
Per una dimostrazione di come promuovere una replica di lettura come istanza di failover o autonoma, consulta Gestione delle repliche delle istanze.
Creazione di un'istanza di replica di failover
Cloud SQL offre una configurazione ad alta disponibilità per le istanze tramite l'uso di repliche di failover. Le repliche di failover utilizzano la replica semisincrona per replicare tutte le modifiche ai dati nell'istanza master. Se si verifica un'interruzione della zona in un'istanza master, la replica di failover viene attivata e assume il controllo. Per questo motivo, la replica deve trovarsi in una zona diversa da quella del master.
Il seguente snippet di codice crea una nuova replica di failover myfailover per l'istanza master gootoso. L'istanza di replica viene creata come descritto sopra, utilizzando i cmdlet di configurazione. Tieni presente, però, 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 $instance
Tieni presente che le istanze di replica influiscono sulla fatturazione allo stesso modo delle istanze normali.