Questa pagina descrive come configurare i flag di database per Cloud SQL ed elenca i flag che puoi impostare per la tua istanza. Puoi usare i flag di database per molte operazioni, tra cui la regolazione dei parametri di 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 rimane per l'istanza finché non lo rimuovi. Se l'istanza è l'origine di una replica e l'istanza viene riavviata, viene riavviata anche la replica 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 la quale 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 nella sezione Flag della pagina Panoramica.
Questo comando sovrascriverà tutti i flag di database
impostati in precedenza. Per conservarli e aggiungerne di nuovi, includi i valori per tutti i flag che vuoi impostare nell'istanza. Qualsiasi flag non incluso nello specifico è impostato sul valore predefinito. Per i flag che non prendono un valore, specifica il nome
della segnalazione seguito da un 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 tua configurazione Terraform a 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
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 esempio main.tf. In questo tutorial, il file è denominato 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 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 su false.
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
Per impostare un flag per un database esistente:
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
Se esistono flag esistenti 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 esistono flag esistenti configurati per il database, modifica il comando precedente per includerli. Il comando PATCH sovrascrive i flag esistenti
con quelli specificati nella richiesta.
Cancella i valori predefiniti di tutti i flag
Console
Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per la quale 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 in un'istanza:
Determina quali flag di database sono stati impostati per un'istanza
Per vedere quali flag sono stati impostati per un'istanza di Cloud SQL:
Console
Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per la quale vuoi visualizzare i flag di database impostati.
Seleziona l'istanza per aprire la pagina Panoramica istanza.
I flag di database 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 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 delle seguenti 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 la pagina
AT TIME ZONE (Transact-SQL).
