Questa pagina descrive come configurare i flag di database per Cloud SQL ed elenca quelli che puoi impostare per la tua istanza. Puoi utilizzare i flag di database per molte operazioni, tra cui la regolazione dei parametri SQL Server, la regolazione delle opzioni e la configurazione e l'ottimizzazione di un'istanza.
Quando imposti, rimuovi o modifichi un flag per un'istanza di database, il database potrebbe essere riavviato. Il valore del flag viene mantenuto per l'istanza fino a quando non lo rimuovi. Se l'istanza è l'origine di una replica e l'istanza viene riavviata, anche la replica viene riavviata per allinearsi alla configurazione attuale dell'istanza.
Configurazione dei flag di database
Imposta un flag di database
Console
Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi impostare un flag di database.
Apri l'istanza e fai clic su Modifica.
Scorri verso il basso fino alla sezione Flag.
Per impostare un flag che non è stato impostato in precedenza sull'istanza, fai clic su Aggiungi elemento, scegli il flag dal menu a discesa e imposta il relativo valore.
Fai clic su Salva per salvare le modifiche.
Conferma le modifiche in Flag nella pagina Panoramica.
Questo comando sovrascriverà tutti i flag di database
impostati in precedenza. Per conservarli e aggiungerne di nuovi, includi i valori di tutti i flag che vuoi impostare sull'istanza. Ogni flag non incluso specificamente viene impostato sul valore predefinito. Per i flag che non accettano un valore, specifica il nome del flag seguito dal segno di uguale ("=").
Ad esempio, per impostare i flag 1204, remote access e remote query timeout (s), puoi utilizzare il seguente comando:
resource "google_sql_database_instance" "instance" {
name = "sqlserver-instance-flags"
region = "us-central1"
database_version = "SQLSERVER_2019_STANDARD"
root_password = "INSERT-PASSWORD-HERE"
settings {
database_flags {
name = "1204"
value = "on"
}
database_flags {
name = "remote access"
value = "on"
}
database_flags {
name = "remote query timeout (s)"
value = "300"
}
tier = "db-custom-2-7680"
}
# set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
# use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
deletion_protection = false
}
Applica le modifiche
Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle sezioni seguenti.
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
Se imposti valori espliciti nel file di configurazione Terraform, le variabili di ambiente vengono sostituite.
Prepara la directory
Ogni file di configurazione Terraform deve avere una propria directory (detta 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 esempio main.tf. In questo tutorial, il file è indicato come main.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.tf appena creato.
Se vuoi, 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
Rivedi 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 Terraform eseguendo il comando seguente e inserendo yes
al prompt:
terraform apply
Attendi finché Terraform non visualizza il messaggio "Applicazione completata".
Apri il progetto Google Cloud per visualizzare
i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.
Elimina le modifiche
Per eliminare le modifiche:
Per disabilitare la protezione dall'eliminazione, nel file di configurazione Terraform imposta
l'argomento deletion_protection su false.
deletion_protection = "false"
Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt:
terraform apply
Rimuovi le risorse applicate in precedenza con la tua configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt:
terraform destroy
REST v1
Per impostare un flag per un database esistente:
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
Se sono presenti flag configurati per il database, modifica il comando precedente per includerli. Il comando PATCH sovrascrive i flag esistenti con quelli specificati nella richiesta.
REST v1beta4
Per impostare un flag per un database esistente:
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
Se sono presenti flag configurati per il database, modifica il comando precedente per includerli. Il comando PATCH sovrascrive i flag esistenti con quelli specificati nella richiesta.
Cancella tutti i flag sui valori predefiniti
Console
Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi cancellare tutti i flag.
Apri l'istanza e fai clic su Modifica.
Apri la sezione Flag di database.
Fai clic sulla X accanto a tutte le segnalazioni mostrate.
Fai clic su Salva per salvare le modifiche.
gcloud
Cancella tutti i flag sui valori predefiniti su un'istanza:
Determina quali flag di database sono stati impostati per un'istanza
Per vedere quali flag sono stati impostati per un'istanza Cloud SQL:
Console
Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi visualizzare i flag del database che sono stati impostati.
Seleziona l'istanza per aprire la relativa pagina Panoramica dell'istanza.
I flag di database che sono stati impostati sono elencati nella sezione Flag di database.
gcloud
Ottieni lo stato dell'istanza:
gcloud sql instances describe INSTANCE_NAME
Nell'output, i flag di database sono elencati sotto settings come raccolta databaseFlags. Per maggiori informazioni sulla rappresentazione dei flag nell'output, consulta la pagina relativa alla rappresentazione delle risorse delle istanze.
REST v1
Per elencare i flag configurati per un'istanza:
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
project-id: l'ID progetto
instance-id: l'ID istanza
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Per inviare la richiesta, espandi una di queste opzioni:
Cloud SQL per SQL Server non supporta la modifica del fuso orario di un'istanza esistente.
In Cloud SQL, SQL Server supporta l'impostazione del fuso orario di una nuova istanza, ma non di un'istanza esistente.
In Cloud SQL per SQL Server, puoi utilizzare la funzione AT TIME ZONE
per le conversioni temporali e altro ancora. Per informazioni su questa funzione, consulta
AT TIME ZONE (Transact-SQL).
