Questa pagina descrive come configurare una nuova istanza Cloud SQL utilizzando Cloud Tools for 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 dove verranno replicati i dati 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 farlo utilizzando Cloud Tools for PowerShell, utilizza i 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 gli indicatori del cmdlet New-GcSqlInstanceConfig.
Se non specifichi alcun parametro, 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, 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 replica di lettura
Le istanze replica di lettura forniscono la funzionalità di replica per i dati in un'istanza principale. 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 cmdlet
New-GcSqlInstanceReplicaConfig. In questo modo vengono configurate le impostazioni specifiche per le istanze di replica di lettura, ad esempio la velocità di replica dei dati o se la replica avviene 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 utilizzano la replica semi sincrona per replicare tutte le modifiche ai dati nell'istanza principale. Se la zona di un'istanza master subisce un'interruzione, 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 principale 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.