Utilizzo di gruppi di parametri DB in un'istanza DB

Le istanze database utilizzano gruppi di parametri database. Le sezioni seguenti descrivono la configurazione e la gestione dei gruppi di parametri dell’istanza database.

Creazione di un gruppo di parametri del database

È possibile creare un nuovo gruppo di parametri DB utilizzando AWS Management Console AWS CLI, the o l'API RDS.

Le seguenti limitazioni si applicano al nome del gruppo di parametri database:

• Il nome deve contenere da 1 a 255 lettere, numeri o trattini.

  I nomi del gruppo di parametri predefiniti possono includere un punto, ad esempio default.mysql8.0. Tuttavia, i nomi del gruppo di parametri personalizzati non possono includere un punto.

• Il primo carattere deve essere una lettera.

• Il nome non può terminare con un trattino o contenere due trattini consecutivi.

Console

Per creare un gruppo di parametri del database

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel pannello di navigazione, scegliParameter groups (Gruppi di parametri).

3. Scegli Create parameter group (Crea gruppo di parametri).

4. Per il nome del gruppo di parametri, inserisci il nome del nuovo gruppo di parametri DB.

5. In Descrizione, inserisci una descrizione per il tuo nuovo gruppo di parametri DB.

6. Per Tipo di motore, scegli il tuo motore DB.

7. Per Famiglia di gruppi di parametri, scegli una famiglia di gruppi di parametri DB.

8. Per Tipo, se applicabile, scegliete DB Parameter Group.

9. Scegli Create (Crea).

AWS CLI

Per creare un gruppo di parametri DB, utilizzate il AWS CLI create-db-parameter-groupcomando. L'esempio seguente crea un gruppo di parametri database denominato mydbparametergroup per MySQL versione 8.0 con la descrizione "My new parameter group (Il mio nuovo gruppo di parametri)".

Includi i parametri obbligatori seguenti:

• --db-parameter-group-name

• --db-parameter-group-family

• --description

Per elencare tutte le famiglie del gruppo di parametri disponibili, usa il comando seguente:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"

Nota

L'output contiene duplicati.

Esempio

Per LinuxmacOS, oUnix:

aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new parameter group"

Per Windows:

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new parameter group"

Questo comando genera un output simile al seguente:

DBPARAMETERGROUP  mydbparametergroup  aurora-mysql5.7  My new parameter group					

API RDS

Per creare un gruppo di parametri database, utilizzare l'operazione API RDS CreateDBParameterGroup.

Includi i parametri obbligatori seguenti:

• DBParameterGroupName

• DBParameterGroupFamily

• Description

Associazione di un gruppo di parametri database a un'istanza database

Puoi creare i tuoi gruppi di parametri database con impostazioni personalizzate. È possibile associare un gruppo di parametri DB a un'istanza DB utilizzando l' AWS Management Console API AWS CLI, the o RDS. Ciò è possibile quando crei o modifichi un'istanza database.

Per ulteriori informazioni sulla creazione di un gruppo di parametri del database, consulta Creazione di un gruppo di parametri del database. Per ulteriori informazioni sulla modifica di un'istanza database, consulta Modifica di un'istanza database in un cluster database.

Nota

Quando si associa un nuovo gruppo parametri del database a un'istanza database, i parametri statici e dinamici modificati vengono applicati solo dopo il riavvio dell'istanza database. Tuttavia, se modifichi i parametri dinamici nel gruppo di parametri database associato all'istanza database, tali modifiche vengono applicate immediatamente senza eseguire il riavvio.

Console

Per associare un gruppo di parametri del database a un'istanza database

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione, scegliere Databases (Database) e selezionare l'istanza database da modificare.

3. Scegliere Modify (Modifica). Viene visualizzata la pagina Modify DB Instance (Modifica istanza database).

4. Modifica l'impostazione del gruppo di parametri database .

5. Scegliere Continue (Continua) e controllare il riepilogo delle modifiche.

6. (Facoltativo) Scegliere Applica immediatamente per applicare immediatamente le modifiche. In alcuni casi, la chiusura di questa opzione può causare un'interruzione.

7. Nella pagina di conferma esaminare le modifiche. Se sono corrette, seleziona Modifica istanza database per salvare le modifiche.

   Oppure scegliere Back (Indietro) per cambiare le modifiche o Cancel (Annulla) per annullare le modifiche.

AWS CLI

Per associare un gruppo di parametri DB a un'istanza DB, usa il AWS CLI modify-db-instancecomando con le seguenti opzioni:

• --db-instance-identifier

• --db-parameter-group-name

Nell'esempio seguente il gruppo di parametri database mydbpg viene associato all'istanza database database-1. Le modifiche vengono applicate immediatamente tramite --apply-immediately. Utilizza --no-apply-immediately per applicare le modifiche durante la successiva finestra di manutenzione.

Esempio

Per LinuxmacOS, oUnix:

aws rds modify-db-instance \
    --db-instance-identifier database-1 \
    --db-parameter-group-name mydbpg \
    --apply-immediately

Per Windows:

aws rds modify-db-instance ^
    --db-instance-identifier database-1 ^
    --db-parameter-group-name mydbpg ^
    --apply-immediately

API RDS

Per associare un gruppo parametri del database a un'istanza database, utilizza l'operazione ModifyDBInstance dell'API RDS con i seguenti parametri:

• DBInstanceName

• DBParameterGroupName

Modifica di parametri in un gruppo di parametri del database

Puoi modificare i valori dei parametri in un gruppo di parametri database creato dal cliente, ma non puoi modificare i valori dei parametri in un gruppo di parametri database predefinito. Le modifiche ai parametri in un gruppo di parametri database creato dal cliente vengono applicate a tutte le istanze database associate al gruppo di parametri database.

Le modifiche apportate ad alcuni parametri vengono applicate all'istanza database immediatamente senza un riavvio. Le modifiche apportate ad altri parametri vengono applicate solo dopo che l'istanza database viene riavviata. La console RDS mostra lo stato del gruppo di parametri database associato a un'istanza database nella scheda Configuration (Configurazione). Supponi, ad esempio che l'istanza database non utilizzi le modifiche più recenti apportate al gruppo di parametri database associato. In questo caso, la console RDS mostra il gruppo di parametri database con lo stato pending-reboot. Per applicare le ultime modifiche del parametro su quella istanza database, riavvia manualmente l’istanza database.

Console

Per modificare i parametri in un gruppo di parametri DB

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

3. Nell'elenco, scegli il nome del gruppo di parametri che desideri modificare.

4. Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Edit (Modifica).

5. Modificare i valori dei parametri desiderati. È possibile scorrere i parametri usando i tasti freccia in alto a destra nella finestra di dialogo.

   Non è possibile modificare valori nel gruppo di parametri predefinito.

6. Scegli Save changes (Salva modifiche).

AWS CLI

Per modificare un gruppo di parametri DB, utilizzate il AWS CLI modify-db-parameter-groupcomando con le seguenti opzioni richieste:

• --db-parameter-group-name

• --parameters

L'esempio seguente modifica i valori max_connections e max_allowed_packet nel gruppo di parametri database denominato mydbparametergroup.

Esempio

Per LinuxmacOS, oUnix:

aws rds modify-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

Per Windows:

aws rds modify-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

Il comando genera un output simile al seguente:

DBPARAMETERGROUP  mydbparametergroup

API RDS

Per modificare un gruppo parametri del database, utilizza l'operazione ModifyDBParameterGroup dell'API RDS con i seguenti parametri obbligatori:

• DBParameterGroupName

• Parameters

Reimpostazione dei parametri in un gruppo di parametri database sui valori predefiniti

Puoi reimpostare i valori dei parametri in un gruppo di parametri database creato dal cliente sui valori predefiniti. Le modifiche ai parametri in un gruppo di parametri database creato dal cliente vengono applicate a tutte le istanze database associate al gruppo di parametri database.

Quando utilizzi la console, puoi reimpostare specifici parametri sui valori predefiniti. Tuttavia, non è possibile reimpostare altrettanto facilmente tutti i parametri nel gruppo di parametri database contemporaneamente. Quando utilizzi l'API AWS CLI o RDS, puoi ripristinare i valori predefiniti di parametri specifici. Puoi anche reimpostare tutti i parametri del gruppo di parametri database contemporaneamente.

Le modifiche apportate ad alcuni parametri vengono applicate all'istanza database immediatamente senza un riavvio. Le modifiche apportate ad altri parametri vengono applicate solo dopo che l'istanza database viene riavviata. La console RDS mostra lo stato del gruppo di parametri database associato a un'istanza database nella scheda Configuration (Configurazione). Supponi, ad esempio che l'istanza database non utilizzi le modifiche più recenti apportate al gruppo di parametri database associato. In questo caso, la console RDS mostra il gruppo di parametri database con lo stato pending-reboot. Per applicare le ultime modifiche del parametro su quella istanza database, riavvia manualmente l’istanza database.

Nota

In un gruppo di parametri database predefinito, i parametri vengono sempre impostati sui valori di default.

Console

Per ripristinare i valori predefiniti dei parametri di un gruppo di parametri database

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

3. Nell'elenco, scegliere il gruppo di parametri.

4. Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Edit (Modifica).

5. Scegliere i parametri per i quali si desidera ripristinare i valori predefiniti. È possibile scorrere i parametri usando i tasti freccia in alto a destra nella finestra di dialogo.

   Non è possibile reimpostare valori in un gruppo di parametri predefinito.

6. Scegli Reimposta , quindi conferma selezionando Ripristina parametri.

AWS CLI

Per reimpostare alcuni o tutti i parametri in un gruppo di parametri DB, usa il AWS CLI reset-db-parameter-groupcomando con la seguente opzione obbligatoria:--db-parameter-group-name.

Per reimpostare tutti i parametri nel gruppo di parametri database, specifica l'opzione --reset-all-parameters. Per reimpostare parametri specifici, specifica l'opzione --parameters.

Nell'esempio seguente tutti i parametri del gruppo di parametri del database denominato mydbparametergroup vengono reimpostati sui valori predefiniti.

Esempio

Per LinuxmacOS, oUnix:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Per Windows:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --reset-all-parameters

Nel seguente esempio le opzioni max_connections e max_allowed_packet vengono reimpostate sui loro valori predefiniti nel gruppo di parametri database denominato mydbparametergroup.

Esempio

Per LinuxmacOS, oUnix:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Per Windows:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Il comando genera un output simile al seguente:

DBParameterGroupName  mydbparametergroup

API RDS

Per ripristinare i valori predefiniti dei parametri di un gruppo di parametri database, utilizza il comando ResetDBParameterGroup dell’API RDS con il seguente parametro obbligatorio: DBParameterGroupName.

Per reimpostare tutti i parametri nel gruppo di parametri database, imposta il parametro ResetAllParameters su true. Per reimpostare parametri specifici, specifica il parametro Parameters.

Copia di un gruppo di parametri database

Puoi copiare i gruppi di parametri database personalizzati che hai creato. La copia di un gruppo di parametri può essere una soluzione utile. Ad esempio quando crei un gruppo di parametri database e vuoi includere la maggior parte dei parametri e dei valori personalizzati in un nuovo gruppo di parametri del database. È possibile copiare un gruppo di parametri DB utilizzando AWS Management Console. È inoltre possibile utilizzare il AWS CLI copy-db-parameter-groupcomando o l'operazione RDS API CopyDB ParameterGroup.

Dopo aver copiato un gruppo di parametri database, attendi almeno 5 minuti prima di creare la prima istanza database che usa il gruppo di parametri database come predefinito. In questo modo, Amazon RDS può completare l'operazione di copia prima che venga usato il gruppo di parametri. Questo è particolarmente importante per parametri critici durante la creazione del database predefinito per un'istanza database. Un esempio è il set di caratteri per il database predefinito definito dal parametro character_set_database. Utilizza l'opzione Parameter Groups della console Amazon RDS o il describe-db-parameterscomando per verificare che il gruppo di parametri DB sia stato creato.

Nota

Non puoi copiare un gruppo di parametri predefinito. Tuttavia, puoi creare un nuovo gruppo di parametri basato su un gruppo di parametri predefinito.

Non puoi copiare un gruppo di parametri DB in un altro Account AWS o Regione AWS.

Console

Per copiare un gruppo di parametri del database

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

3. Nell'elenco, scegliere il gruppo di parametri personalizzato da copiare.

4. Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Copy (Copia).

5. In New DB parameter group identifier (Identificatore nuovo gruppo di parametri database) immettere un nome per il nuovo gruppo di parametri.

6. Nella casella Description (Descrizione), immettere una descrizione per il nuovo gruppo di parametri.

7. Scegliere Copy (Copia).

AWS CLI

Per copiare un gruppo di parametri DB, usa il AWS CLI copy-db-parameter-groupcomando con le seguenti opzioni richieste:

• --source-db-parameter-group-identifier

• --target-db-parameter-group-identifier

• --target-db-parameter-group-description

L'esempio seguente crea un nuovo gruppo di parametri database denominato mygroup2, che è una copia del gruppo di parametri database mygroup1.

Esempio

Per LinuxmacOS, oUnix:

aws rds copy-db-parameter-group \
    --source-db-parameter-group-identifier mygroup1 \
    --target-db-parameter-group-identifier mygroup2 \
    --target-db-parameter-group-description "DB parameter group 2"

Per Windows:

aws rds copy-db-parameter-group ^
    --source-db-parameter-group-identifier mygroup1 ^
    --target-db-parameter-group-identifier mygroup2 ^
    --target-db-parameter-group-description "DB parameter group 2"

API RDS

Per copiare un gruppo di parametri del database, utilizza l'operazione API RDS CopyDBParameterGroup:

• SourceDBParameterGroupIdentifier

• TargetDBParameterGroupIdentifier

• TargetDBParameterGroupDescription

Generazione di un elenco di gruppi di parametri del database

Puoi elencare i gruppi di parametri DB che hai creato per il tuo AWS account.

Nota

I gruppi di parametri predefiniti vengono creati automaticamente da un modello di parametro predefinito quando crei un'istanza database per un motore e una versione di database specifici. Questi gruppi di parametri predefiniti contengono le impostazioni dei parametri preferite e non possono essere modificati. Quando crei un gruppo di parametri personalizzato, puoi modificare le impostazioni dei parametri.

Console

Per elencare tutti i gruppi di parametri DB per un AWS account

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

   I gruppi di parametri database vengono visualizzati in un elenco.

AWS CLI

Per elencare tutti i gruppi di parametri DB per un AWS account, usa il AWS CLI describe-db-parameter-groupscomando.

Esempio

L'esempio seguente elenca tutti i gruppi di parametri database disponibili per un account AWS .

aws rds describe-db-parameter-groups

Questo comando restituisce una risposta simile alla seguente:

DBPARAMETERGROUP  default.mysql8.0     mysql8.0  Default parameter group for MySQL8.0
DBPARAMETERGROUP  mydbparametergroup   mysql8.0  My new parameter group

L'esempio seguente descrive il gruppo di parametri mydbparamgroup1.

Per LinuxmacOS, oUnix:

aws rds describe-db-parameter-groups \
    --db-parameter-group-name mydbparamgroup1

Per Windows:

aws rds describe-db-parameter-groups ^
    --db-parameter-group-name mydbparamgroup1

Questo comando restituisce una risposta simile alla seguente:

DBPARAMETERGROUP  mydbparametergroup1  mysql8.0  My new parameter group

API RDS

Per elencare tutti i gruppi di parametri DB per un AWS account, utilizza l'DescribeDBParameterGroupsoperazione API RDS.

Visualizzazione dei valori dei parametri per un gruppo di parametri del database

Puoi ottenere un elenco di tutti i parametri in un gruppo di parametri del database e dei rispettivi valori.

Console

Per visualizzare i valori dei parametri per un gruppo di parametri del database

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

   I gruppi di parametri database vengono visualizzati in un elenco.

3. Scegliere il nome del gruppo di parametri per visualizzarne l'elenco di parametri.

AWS CLI

Per visualizzare i valori dei parametri per un gruppo di parametri DB, usa il AWS CLI describe-db-parameterscomando con il seguente parametro obbligatorio.

• --db-parameter-group-name

Esempio

L'esempio seguente elenca i parametri e i valori dei parametri per un gruppo di parametri database denominato mydbparametergroup.

aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup

Questo comando restituisce una risposta simile alla seguente:

DBPARAMETER  Parameter Name            Parameter Value  Source           Data Type  Apply Type  Is Modifiable
DBPARAMETER  allow-suspicious-udfs                      engine-default   boolean    static      false
DBPARAMETER  auto_increment_increment                   engine-default   integer    dynamic     true
DBPARAMETER  auto_increment_offset                      engine-default   integer    dynamic     true
DBPARAMETER  binlog_cache_size         32768            system           integer    dynamic     true
DBPARAMETER  socket                    /tmp/mysql.sock  system           string     static      false

API RDS

Per visualizzare i valori dei parametri per un gruppo di parametri del database, utilizza il comando RDS API DescribeDBParameters con il seguente parametro obbligatorio.

• DBParameterGroupName

Eliminazione di un gruppo di parametri DB

È possibile eliminare un gruppo di parametri DB utilizzando AWS Management Console AWS CLI, o l'API RDS. Un gruppo di parametri è idoneo per l'eliminazione solo se non è associato a un'istanza DB.

Console

Per eliminare un gruppo di parametri DB

1. Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.

2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

   I gruppi di parametri database vengono visualizzati in un elenco.

3. Scegli il nome dei gruppi di parametri da eliminare.

4. Scegli Azioni e poi Elimina.

5. Controllate i nomi dei gruppi di parametri, quindi scegliete Elimina.

AWS CLI

Per eliminare un gruppo di parametri DB, utilizzate il AWS CLI delete-db-parameter-groupcomando con il seguente parametro richiesto.

• --db-parameter-group-name

Esempio

L'esempio seguente elimina un gruppo di parametri DB denominato mydbparametergroup.

aws rds delete-db-parameter-group --db-parameter-group-name mydbparametergroup

API RDS

Per eliminare un gruppo di parametri DB, utilizzate il DeleteDBParameterGroupcomando API RDS con il seguente parametro obbligatorio.

• DBParameterGroupName