Questa pagina descrive come configurare i flag di database per Cloud SQL ed elenca i flag che puoi impostare per la tua istanza. I flag di database vengono utilizzati 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 viene quindi mantenuto per l'istanza finché non lo rimuovi. Se l'istanza è l'origine di una replica e viene riavviata, anche la replica viene riavviata per allinearsi alla configurazione corrente dell'istanza.
Configura flag di database
Le sezioni seguenti illustrano le attività comuni di gestione dei flag.
Imposta un flag di database
Console
- Nella consoleGoogle 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.
- Vai 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 impostane il valore.
- Fai clic su Salva per salvare le modifiche.
- Conferma le modifiche in Flag nella pagina Panoramica.
gcloud
Modifica l'istanza:
gcloud sql instances patch INSTANCE_NAME --database-flags=FLAG1=VALUE1,FLAG2=VALUE2
Questo comando sovrascriverà tutti i flag di database impostati in precedenza. Per mantenerli e aggiungerne di nuovi, includi i valori di tutti i flag che vuoi impostare nell'istanza. Qualsiasi flag non incluso specificamente viene impostato sul valore predefinito. Per i flag che non accettano un valore, specifica il nome del flag 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:
gcloud sql instances patch INSTANCE_NAME \ --database-flags="1204"=on,"remote access"=on,"remote query timeout (s)"=300
Terraform
Per aggiungere flag di database, utilizza una risorsa Terraform.
Applica le modifiche
Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi descritti nelle sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Google Cloud predefinito in 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 file deve avere l'estensione
.tf, ad esempiomain.tf. In questo tutorial, il file è denominatomain.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.tfappena creato.Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata quando 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 l'ultima versione 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à corrispondano alle tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione di Terraform eseguendo questo comando e inserendo
yesal prompt:terraform apply
Attendi finché Terraform non visualizza il messaggio "Apply complete!".
- Apri il tuo 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 disattivare la protezione da eliminazione, nel file di configurazione Terraform imposta l'argomento
deletion_protectionsufalse.deletion_protection = "false"
- Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo
yesal prompt:terraform apply
-
Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il comando seguente e inserendo
yesal prompt:terraform destroy
REST v1
Per impostare un flag per un database esistente:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Corpo JSON della richiesta:
{
"settings":
{
"databaseFlags":
[
{
"name": "flag_name",
"value": "flag_value"
}
]
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Se sono già configurati flag 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, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Corpo JSON della richiesta:
{
"settings":
{
"databaseFlags":
[
{
"name": "flag_name",
"value": "flag_value"
}
]
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Se sono già configurati flag 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 e ripristina i valori predefiniti
Console
- Nella consoleGoogle 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 tutti i flag visualizzati.
- Fai clic su Salva per salvare le modifiche.
gcloud
Cancella tutti i flag e ripristina i valori predefiniti in un'istanza:
gcloud sql instances patch INSTANCE_NAME \ --clear-database-flags
Ti verrà chiesto di confermare il riavvio dell'istanza.
REST v1
Per cancellare tutti i flag di un'istanza esistente:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Corpo JSON della richiesta:
{
"settings":
{
"databaseFlags": []
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
REST v1beta4
Per cancellare tutti i flag di un'istanza esistente:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Corpo JSON della richiesta:
{
"settings":
{
"databaseFlags": []
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
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 consoleGoogle Cloud , seleziona il progetto che contiene l'istanza Cloud SQL per cui 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
Recupera lo stato dell'istanza:
gcloud sql instances describe INSTANCE_NAME
Nell'output, i flag di database sono elencati sotto settings come raccolta databaseFlags. Per saperne di più 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, apporta le sostituzioni seguenti:
- 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:
Dovresti ricevere una risposta JSON simile alla seguente:
Nell'output, cerca il campo databaseFlags.
REST v1beta4
Per elencare i flag configurati per un'istanza:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Nell'output, cerca il campo databaseFlags.
Flag supportati
Cloud SQL supporta solo i flag elencati in questa sezione.
| Flag Cloud SQL | Tipo Valori accettati e note |
Riavvio necessario? |
|---|---|---|
| 1204 (flag di traccia) | booleanon | off |
No |
| 1222 (flag di traccia) | booleanon | off |
No |
| 1224 (flag di traccia) | booleanon | off |
No |
| 2528 (flag di traccia) | booleanon | off |
No |
| 3205 (flag di traccia) | booleanon | off |
No |
| 3226 (flag di traccia) | booleanon | off |
No |
| 3625 (flag di traccia) | booleanon | off |
Sì |
| 4199 (flag di traccia) | booleanon | off |
No |
| 4616 (flag di traccia) | booleanon | off |
No |
| 7806 (flag di traccia) | booleanon | off |
Sì |
| 13702 (flag di traccia) | booleanon | off |
Sì |
| access check cache bucket count | integer0 … 65536 |
No |
| quota della cache di controllo dell'accesso | integer0 … 2147483647 |
No |
| affinity mask | integer2147483648 … 2147483647 |
Sì |
| affinity I/O mask | integer2147483648 … 2147483647 |
Sì |
| agent xps | booleanon | off |
No |
| automatic soft-numa disabled | booleanon | off |
Sì |
| cloud sql xe bucket name | stringIl nome del bucket deve iniziare con il prefisso gs://. |
No |
| cloud sql xe output total disk size (mb) | integer10 … 512 |
No |
| cloud sql xe file retention (mins) | integer0 … 10080 |
No |
| cloud sql xe upload interval (mins) | integer1 … 60 |
No |
| cloudsql enable linked servers | booleanon | off |
No |
| cost threshold for parallelism | integer0 … 32767 |
No |
| autenticazione database indipendente | booleanon | off
|
No |
| cross db ownership chaining | booleanon | off
|
No |
| soglia del cursore | integer-1 … 2147483647 |
No |
| default full-text language | integer0 … 2147483647 |
No |
| lingua predefinita | integer0 … 32 |
No |
| default trace enabled | booleanon | off |
No |
| non consentire i risultati degli attivatori | booleanon | off |
No |
| external scripts enabled | booleanon | off |
Sì |
| ft crawl bandwidth (max) | integer0 … 32767 |
No |
| ft crawl bandwidth (min) | integer0 … 32767 |
No |
| ft notify bandwidth (max) | integer0 … 32767 |
No |
| ft notify bandwidth (min) | integer0 … 32767 |
No |
| fattore di riempimento (%) | integer0 … 100 |
Sì |
| index create memory (kb) | integer704 … 2147483647 |
No |
| locks | integer5000 … 2147483647 |
Sì |
| max degree of parallelism (MAXDOP) | integer0 … 32767 |
No |
| max server memory (mb) | integer1000 … 2147483647
Cloud SQL può impostare un valore per questo flag sulle istanze, in base ai valori consigliati da Microsoft. Per saperne di più, consulta Flag speciali. |
No |
| max text repl size (b) | integer-1 … 2147483647 |
No |
| max worker threads | integer128 … 65535 |
No |
| trigger nidificati | booleanon | off |
No |
| ottimizza per i workload ad hoc | booleanon | off |
No |
| ph timeout (s) | integer1 … 3600 |
No |
| cloud sql enable polybase | booleanon | off |
Sì |
| cloud sql enable sp_help_revlogin | booleanon | off |
No |
| query governor cost limit | integer0 … 2147483647 |
No |
| query wait (s) | integer-1 … 2147483647 |
No |
| recovery interval (min) | integer0 … 32767 |
No |
| accesso remoto | booleanon | off |
Sì |
| remote login timeout (s) | integer0 … 2147483647 |
No |
| remote query timeout (s) | integer0 … 2147483647 |
No |
| transform noise words | booleanon | off |
No |
| two digit year cutoff | integer1753 … 9999 |
No |
| connessioni degli utenti | integer0, 10 … 32767 |
Sì |
| opzioni utente | integer0 … 32767 |
No |
Flag speciali
Questa sezione contiene informazioni aggiuntive sui flag di Cloud SQL per SQL Server.
max degree of parallelism (MAXDOP)
Max degree of parallelism (MAXDOP) è un flag di database Microsoft disponibile per l'utilizzo in Cloud SQL per SQL Server. Questo flag consente di limitare il numero massimo di thread utilizzati durante l'esecuzione di una singola query in un piano parallelo.
Se viene lasciato il valore predefinito 0, l'istanza del database utilizza tutti i processori disponibili. Tuttavia, questo potrebbe non essere sempre efficiente o addirittura pratico se gestisci istanze con centinaia di database.
Ti consigliamo di seguire i suggerimenti della documentazione di Microsoft quando imposti il valore del flag, che può variare in base al numero di nodi NUMA e al numero di processori logici disponibili.
Puoi controllare la configurazione del nodo NUMA utilizzando la vista di gestione dinamica (DMV) da sys.dm_os_sys_info. Per controllare la configurazione del nodo NUMA, utilizza uno snippet di codice simile al seguente:
SELECT socket_count,cores_per_socket,numa_node_count
FROM sys.dm_os_sys_info
Sebbene tu possa utilizzare MAXDOP per limitare il numero massimo di processori che vuoi consentire per l'esecuzione di piani paralleli, puoi anche utilizzare la funzionalità Soglia di costo per parallelismo per indicare il costo minimo che vuoi impostare per un singolo processore prima di espandere le operazioni parallele a un altro processore. Queste funzionalità ti consentono di controllare meglio l'efficienza e il costo dell'esecuzione dei piani paralleli.
I valori consigliati per queste funzionalità variano caso per caso e dipendono dalle esigenze del workload del server e dell'applicazione.
Per determinare i valori ottimali di MAXDOP e della soglia di costo per il parallelismo per i tuoi server, consulta le seguenti risorse:
- Configurazione del server: grado massimo di parallelismo
- Best practice: impostazioni del database da modificare
La modifica del valore predefinito consente di risolvere i seguenti potenziali problemi:
- Se il flag
max degree of parallelism (MAXDOP)è impostato su0, le istanze o le applicazioni client che richiedono i download di SharePoint non funzionano. Il download di SharePoint esegue un controllo preliminare che richiede un valore numerico per il flag e non accetta un valore inferiore a 1. - Se lasci il flag MAXDOP impostato sul valore predefinito
0, indichi che non esiste alcun limite e che tutti i processori disponibili possono essere utilizzati per le operazioni parallele. Sebbene questo valore possa essere appropriato per i server che eseguono regolarmente query di piccole dimensioni, potrebbe rappresentare un problema di costo se devi anche eseguire periodicamente query di grandi dimensioni.
Utilizzando il flag max degree of parallelism (MAXDOP), puoi controllare il numero di thread a tre livelli:
- A livello di istanza, utilizzando i flag di database
- Ambito del database, utilizzando TSQL
- A livello di query, utilizzando i suggerimenti per le query
Tieni presente che se l'istanza viene ridimensionata, il valore del flag rimane invariato.
max server memory (mb)
Il flag max server memory (mb) limita la quantità di memoria che Cloud SQL può allocare per i suoi pool interni.
Ti consigliamo di non configurare un valore per questo flag e di lasciare che sia Cloud SQL a gestirlo. Se devi gestire manualmente questo valore, come consiglio generale, imposta il valore max server memory (mb) su circa l'80% della memoria disponibile per evitare che SQL Server consumi tutta la memoria.
Al contrario, per le istanze con grandi quantità di memoria, l'80% della memoria disponibile potrebbe essere un valore troppo basso e potrebbe comportare uno spreco di memoria utilizzata.
Se non imposti un valore per questo flag, Cloud SQL lo gestisce automaticamente in base alle dimensioni della RAM dell'istanza. Inoltre, se ridimensioni l'istanza, Cloud SQL modifica automaticamente il valore del flag per soddisfare i nostri suggerimenti per le nuove dimensioni dell'istanza. Questa operazione di ridimensionamento rimuove anche qualsiasi valore impostato manualmente per questo flag. In questo modo, il database utilizza le risorse in modo più efficace, contribuendo a prevenire l'allocazione eccessiva, riducendo la probabilità di un arresto anomalo dovuto a problemi di memoria insufficiente e contribuendo a evitare il peggioramento delle prestazioni dell'istanza.
Per ulteriori informazioni, consulta Memoria massima del server e Ottimizza la memoria utilizzata elevata.
cloud sql enable sp_help_revlogin
Il flag cloud sql enable sp_help_revlogin ti consente di attivare o disattivare la stored procedure sp_help_revlogin nel database msdb.
Quando questo flag è impostato su on, Cloud SQL installa la stored procedure nel database msdb e concede le autorizzazioni di esecuzione all'utente amministrativo sqlserver. In questo modo puoi esportare gli accessi, gli hash delle password e i SID di SQL Server per facilitare la migrazione e la sincronizzazione degli accessi tra le istanze.
Quando questo flag è impostato su off, Cloud SQL rimuove la stored procedure dal database msdb.
Per saperne di più, consulta Esporta gli accessi SQL Server.
Risoluzione dei problemi
| Problema | Risoluzione dei problemi |
|---|---|
| Vuoi modificare il fuso orario di un'istanza Cloud SQL. |
Per scoprire come aggiornare il fuso orario di un'istanza, consulta Impostazioni dell'istanza. In Cloud SQL per SQL Server, puoi utilizzare la funzione |
Passaggi successivi
- Scopri di più sulle opzioni di configurazione di SQL Server.