Creazione di un gruppo di parametri del cluster database Modifica di parametri in un gruppo di parametri del cluster database Reimpostazione di parametri in un gruppo di parametri cluster database Copia di un gruppo di parametri cluster database Generazione di un elenco di gruppi di parametri del cluster database Visualizzazione dei valori dei parametri per un gruppo di parametri del cluster database Eliminazione di un gruppo di parametri del cluster DB

Utilizzo di gruppi di parametri cluster di database per cluster database Multi-AZ

I cluster database Multi-AZ utilizzano gruppi di parametri di cluster di database. Le sezioni seguenti descrivono la configurazione e la gestione dei gruppi di parametri del cluster di database.

Argomenti

Creazione di un gruppo di parametri del cluster database
Modifica di parametri in un gruppo di parametri del cluster database
Reimpostazione di parametri in un gruppo di parametri cluster database
Copia di un gruppo di parametri cluster database
Generazione di un elenco di gruppi di parametri del cluster database
Visualizzazione dei valori dei parametri per un gruppo di parametri del cluster database
Eliminazione di un gruppo di parametri del cluster DB

Creazione di un gruppo di parametri del cluster database

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

Dopo aver creato un gruppo di parametri del cluster database, devi attendere almeno 5 minuti prima di creare un cluster database che utilizza tale gruppo. In questo modo, Amazon RDS può completare l'operazione di creazione del gruppo di parametri prima che tale gruppo venga usato dal nuovo cluster database. Puoi utilizzare la pagina Gruppi di parametri nella console Amazon RDS o il describe-db-cluster-parameterscomando per verificare che il gruppo di parametri del cluster DB sia stato creato.

Le seguenti limitazioni si applicano al nome del gruppo di parametri del·cluster 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.aurora-mysql5.7. 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.

Per creare un gruppo di parametri del cluster database

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel pannello di navigazione, scegliParameter groups (Gruppi di parametri).
Scegli Create parameter group (Crea gruppo di parametri).

Viene visualizzata la pagina Create parameter group (Crea gruppo di parametri).
Nell'elenco Parameter group family (Famiglia gruppo di parametri) selezionare una famiglia del gruppo di parametri database.
Nell'elenco Tipo, seleziona il gruppo di parametri del cluster DB.
Nella casella Group name (Nome gruppo) immettere il nome del nuovo gruppo di parametri cluster database.
Nella casella Description (Descrizione) inserire una descrizione per il nuovo gruppo di parametri cluster database.
Scegli Create (Crea).

Per creare un gruppo di parametri del cluster DB, utilizzare il AWS CLI create-db-cluster-parameter-groupcomando.

L'esempio seguente crea un gruppo di parametri cluster di database denominato mydbclusterparametergroup per RDS for MySQL versione 8.0 con la descrizione "My new cluster parameter group (Il mio nuovo gruppo di parametri cluster)".

Includi i parametri obbligatori seguenti:

--db-cluster-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-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family mysql8.0 \
    --description "My new cluster parameter group"

Per Windows:


aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family mysql8.0 ^
    --description "My new cluster parameter group"

Questo comando genera un output simile al seguente:


{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "mysql8.0",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
    }
}

Per creare un gruppo di parametri del cluster di database, utilizza l'operazione CreateDBClusterParameterGroup dell'API RDS.

Includi i parametri obbligatori seguenti:

DBClusterParameterGroupName
DBParameterGroupFamily
Description

Modifica di parametri in un gruppo di parametri del cluster database

Non puoi modificare i valori di parametri in un gruppo di parametri cluster database creato dal cliente. Non puoi modificare i valori dei parametri in un gruppo di parametri cluster database predefinito. Le modifiche ai parametri in un gruppo di parametri cluster database creato dal cliente vengono applicate a tutti i cluster database associati al gruppo di parametri del cluster database.

Per modificare un gruppo di parametri del cluster database

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).
Nell'elenco, selezionare il gruppo di parametri da modificare.
Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Edit (Modifica).
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.
Scegli Save changes (Salva modifiche).
Riavvia l'istanza DB principale (writer) nel cluster per applicarvi le modifiche.
Quindi riavvia le istanze DB del lettore per applicare le modifiche.

Per modificare un gruppo di parametri del cluster DB, utilizzate il AWS CLI modify-db-cluster-parameter-groupcomando con i seguenti parametri obbligatori:

--db-cluster-parameter-group-name
--parameters

L'esempio seguente modifica i valori server_audit_logging e server_audit_logs_upload nel gruppo di parametri cluster database denominato mydbclusterparametergroup.

Esempio

Per LinuxmacOS, oUnix:


aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Per Windows:


aws rds modify-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Il comando genera un output simile al seguente:


DBCLUSTERPARAMETERGROUP  mydbclusterparametergroup

Per modificare un gruppo di parametri cluster database, utilizza l'operazione ModifyDBClusterParameterGroup dell'API RDS con i parametri obbligatori seguenti:

DBClusterParameterGroupName
Parameters

Reimpostazione di parametri in un gruppo di parametri cluster database

È possibile reimpostare i parametri ai valori predefiniti in un gruppo di parametri del cluster di database creato dal cliente. Le modifiche ai parametri in un gruppo di parametri cluster database creato dal cliente vengono applicate a tutti i cluster database associati al gruppo di parametri cluster database.

Nota

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

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

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).
Nell'elenco, scegliere il gruppo di parametri.
Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Edit (Modifica).
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.
Scegli Reimposta , quindi conferma selezionando Ripristina parametri.
Riavviare l'istanza database primaria nel cluster di database per applicare le modifiche a tutte le istanze database del cluster di database.

Per ripristinare i parametri di un gruppo di parametri del cluster DB ai valori predefiniti, usa il AWS CLI reset-db-cluster-parameter-groupcomando con la seguente opzione obbligatoria:--db-cluster-parameter-group-name.

Per reimpostare tutti i parametri nel gruppo di parametri del cluster di database, specificare 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-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Per Windows:


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

L'esempio seguente reimposta i valori server_audit_logging e server_audit_logs_upload nel gruppo di parametri cluster database denominato mydbclusterparametergroup.

Esempio

Per LinuxmacOS, oUnix:


aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Per Windows:


aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Il comando genera un output simile al seguente:


DBClusterParameterGroupName  mydbclusterparametergroup

Per ripristinare i valori predefiniti dei parametri di un gruppo di parametri del cluster di database, utilizzare il comando RDS API ResetDBClusterParameterGroup con il seguente parametro obbligatorio: DBClusterParameterGroupName.

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

Copia di un gruppo di parametri cluster database

Puoi copiare i gruppi di parametri cluster database personalizzati che hai creato. La copia di un gruppo di parametri è una soluzione pratica quando hai già creato un gruppo di parametri cluster database e vuoi includere la maggior parte dei parametri e valori personalizzati dal gruppo in un nuovo gruppo di parametri cluster database. È possibile copiare un gruppo di parametri del cluster DB utilizzando il comando AWS CLI copy-db-cluster-parameter-group o l'operazione ClusterParameterGroupCopyDB dell'API RDS.

Dopo aver copiato un gruppo di parametri del cluster database, devi attendere almeno 5 minuti prima di creare un cluster database che utilizza tale gruppo. In questo modo, Amazon RDS può completare l'operazione di copia del gruppo di parametri prima che tale gruppo venga usato dal nuovo cluster database. Puoi utilizzare la pagina Gruppi di parametri nella console Amazon RDS o il describe-db-cluster-parameterscomando per verificare che il gruppo di parametri del cluster 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 del cluster DB in un altro Account AWS o Regione AWS.

Per copiare un gruppo di parametri cluster database

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).
Nell'elenco, scegliere il gruppo di parametri personalizzato da copiare.
Per Parameter group actions (Operazioni del gruppo di parametri), scegliere Copy (Copia).
In New DB parameter group identifier (Identificatore nuovo gruppo di parametri database) immettere un nome per il nuovo gruppo di parametri.
Nella casella Description (Descrizione), immettere una descrizione per il nuovo gruppo di parametri.
Scegliere Copy (Copia).

Per copiare un gruppo di parametri del cluster DB, usa il AWS CLI copy-db-cluster-parameter-groupcomando con i seguenti parametri obbligatori:

--source-db-cluster-parameter-group-identifier
--target-db-cluster-parameter-group-identifier
--target-db-cluster-parameter-group-description

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

Esempio

Per LinuxmacOS, oUnix:


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

Per Windows:


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

Per copiare un gruppo di parametri cluster database, utilizza l'operazione API RDS CopyDBClusterParameterGroup con i parametri obbligatori seguenti:

SourceDBClusterParameterGroupIdentifier
TargetDBClusterParameterGroupIdentifier
TargetDBClusterParameterGroupDescription

Generazione di un elenco di gruppi di parametri del cluster database

Puoi elencare i gruppi di parametri del cluster 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 cluster 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.

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

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

Il gruppo di parametri cluster database viene visualizzato nell'elenco con Type (Tipo) impostato su DB cluster parameter group (Gruppo di parametri cluster database).

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

Esempio

Nell’esempio seguente sono elencati tutti i gruppi di parametri del cluster database disponibili per un account AWS .


aws rds describe-db-cluster-parameter-groups

L'esempio seguente descrive il gruppo di parametri mydbclusterparametergroup.

Per LinuxmacOS, oUnix:


aws rds describe-db-cluster-parameter-groups \
    --db-cluster-parameter-group-name mydbclusterparametergroup

Per Windows:


aws rds describe-db-cluster-parameter-groups ^
    --db-cluster-parameter-group-name mydbclusterparametergroup

Questo comando restituisce una risposta simile alla seguente:


{
    "DBClusterParameterGroups": [
        {
            "DBClusterParameterGroupName": "mydbclusterparametergroup2",
            "DBParameterGroupFamily": "mysql8.0",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}

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

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

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

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

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

Il gruppo di parametri cluster database viene visualizzato nell'elenco con Type (Tipo) impostato su DB cluster parameter group (Gruppo di parametri cluster database).
Scegliere il nome del gruppo di parametri cluster di database per visualizzare il relativo elenco di parametri.

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

--db-cluster-parameter-group-name

Esempio

L'esempio seguente elenca i parametri e i valori dei parametri per un gruppo di parametri cluster di database denominato mydbclusterparametergroup, in formato JSON.

Questo comando restituisce una risposta simile alla seguente:


aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup


{
    "Parameters": [
        {
            "ParameterName": "activate_all_roles_on_login",
            "ParameterValue": "0",
            "Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
...

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

DBClusterParameterGroupName

In alcuni casi, i valori consentiti per un parametro non vengono visualizzati. Questi sono sempre parametri in cui l'origine è l'impostazione predefinita del motore di database.

Per visualizzare i valori di questi parametri, puoi eseguire le seguenti istruzioni SQL:

MySQL:


-- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';

-- Show the values of all parameters
mysql$ SHOW VARIABLES;

PostgreSQL:


-- Show the value of a particular parameter
postgresql=> SHOW parameter_name;

-- Show the values of all parameters
postgresql=> SHOW ALL;

Eliminazione di un gruppo di parametri del cluster DB

È possibile eliminare un gruppo di parametri del cluster DB utilizzando AWS Management Console AWS CLI, o l'API RDS. Un gruppo di parametri del gruppo di parametri del cluster DB può essere eliminato solo se non è associato a un cluster DB.

Per eliminare i gruppi di parametri

Accedi AWS Management Console e apri la console Amazon RDS all'indirizzo https://console.aws.amazon.com/rds/.
Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

I gruppi di parametri vengono visualizzati in un elenco.
Scegli il nome dei gruppi di parametri del cluster DB da eliminare.
Scegli Azioni e poi Elimina.
Controllate i nomi dei gruppi di parametri, quindi scegliete Elimina.

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

--db-parameter-group-name

Esempio

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


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

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

DBParameterGroupName

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Utilizzo di gruppi di parametri di database

Confronto di gruppi di parametri database