Gruppi di parametri di Amazon Neptune

Puoi gestire la configurazione del database in Amazon Neptune utilizzando i parametri in un gruppo di parametri. I gruppi di parametri fungono da container per i valori di configurazione di un motore applicati a una o più istanze database.

Sono disponibili due tipi di gruppi di parametri: gruppi di parametri del cluster database e gruppi di parametri database.

• I gruppi di parametri database si applicano a livello di istanza e in genere sono associati alle impostazioni per il motore a grafo di Neptune, ad esempio il parametro neptune_query_timeout.

• I gruppi di parametri del cluster database vengono applicati a tutte le istanze del cluster e generalmente hanno una gamma di impostazioni più ampia. Ogni cluster Neptune è associato a un gruppo di parametri del cluster database. Ogni istanza database all'interno del cluster eredita i valori di configurazione del motore contenuti nel gruppo di parametri del cluster database.

Eventuali valori di configurazione modificati nel gruppo di parametri del cluster database sostituiscono i valori predefiniti nel gruppo di parametri database. Se modifichi i valori corrispondenti nel gruppo di parametri database, tali valori sostituiranno le impostazioni nel gruppo di parametri del cluster database.

Un gruppo di parametri database predefinito viene utilizzato se crei un'istanza database senza specificare un gruppo di parametri database personalizzato. Non puoi modificare le impostazioni dei parametri del gruppo di parametri database predefinito. Per modificare le impostazioni dei parametri predefiniti devi creare un nuovo gruppo di parametri database. Non tutti i parametri del motore di database possono essere modificati nel gruppo di parametri database che hai creato.

I gruppi di parametri vengono creati in famiglie compatibili con diverse versioni del motore Neptune. La famiglia del gruppo di parametri predefinito è neptune1, che è compatibile con tutte le versioni del motore precedenti alla 1.2.0.0. A partire dalla Rilascio: 1.2.0.0 (21/07/2022), è necessario utilizzare invece la famiglia del gruppo di parametri neptune1.2. Ciò significa che quando si esegue l'aggiornamento alla versione 1.2.0.0 o superiore, è necessario innanzitutto ricreare tutti i gruppi di parametri personalizzati nella famiglia neptune1.2 in modo da poterli collegare durante l'aggiornamento.

Alcuni parametri di Neptune sono statici e altri dinamici. Le differenze sono le seguenti:

Parametri statici

• Un parametro statico ha effetto solo dopo il riavvio di un'istanza database. In altre parole, quando modifichi un parametro statico e salvi il gruppo di parametri database dell'istanza, devi riavviare manualmente l'istanza database affinché la modifica del parametro venga applicata. Attualmente, tutti i parametri a livello di istanza di Neptune (in un gruppo di parametri database anziché in un gruppo di parametri del cluster database) sono statici.

• Quando modifichi un parametro statico a livello di cluster e salvi il gruppo di parametri del cluster database, la modifica del parametro viene applicata dopo aver riavviato manualmente ogni istanza database sul cluster.

Parametri dinamici

• Un parametro dinamico viene applicato quasi immediatamente dopo essere stato aggiornato nel rispettivo gruppo di parametri. In altre parole, non è necessario riavviare un'istanza database dopo aver aggiornato un parametro dinamico per applicarne la modifica.

• È previsto un lieve ritardo per l'applicazione in tutte le istanze database della modifica di un parametro dinamico del cluster.

• Un valore di parametro dinamico aggiornato non viene applicato alle richieste attualmente in esecuzione, ma solo a quelle inviate dopo la modifica.

• Quando si modifica un parametro dinamico a livello di cluster, per impostazione predefinita la modifica del parametro viene applicata immediatamente al cluster database, senza che sia necessario il riavvio. Per rinviare la modifica del parametro a dopo il riavvio delle istanze database nel cluster, utilizza AWS CLI per impostare ApplyMethod su pending-reboot per la modifica del parametro.

Attualmente tutti i parametri sono statici ad eccezione dei seguenti nuovi parametri del cluster:

• neptune_enable_slow_query_log   (a livello di cluster)

• neptune_slow_query_log_threshold   (a livello di cluster)

Di seguito sono elencati alcuni punti importanti sull'utilizzo dei parametri in un gruppo di parametri database:

• Un'impostazione errata dei parametri in un gruppo di parametri database può avere conseguenze negative impreviste, tra cui il peggioramento delle prestazioni e l'instabilità del sistema. Fai sempre attenzione quando modifichi i parametri database ed effettui il backup dei dati prima di modificare un gruppo di parametri database. Prova le modifiche delle impostazioni del gruppo di parametri su un'istanza database di test prima di applicare le modifiche apportate a un'istanza database di produzione.

• Quando modifichi il gruppo di parametri database associato a un'istanza database, devi riavviare manualmente l'istanza prima che il nuovo gruppo di parametri database venga usato dall'istanza database.

  Nota

  Prima della Rilascio: 1.2.0.0 (21/07/2022), tutte le istanze di replica di lettura in un cluster database venivano riavviate automaticamente ogni volta che l'istanza primaria (writer) veniva riavviata.

  A partire dalla Rilascio: 1.2.0.0 (21/07/2022), il riavvio dell'istanza primaria non causa il riavvio di nessuna delle istanze di replica. Ciò significa che, se modifichi un parametro a livello di cluster, devi riavviare ogni istanza separatamente per riprendere la modifica del parametro.

Modifica di un gruppo di parametri del cluster di database o di un gruppo di parametri di database

1. Accedi alla Console di gestione AWS e apri la console Amazon Neptune all'indirizzo https://console.aws.amazon.com/neptune/home.

2. Scegliere Parameter groups (Gruppi di parametro) nel riquadro di navigazione.

3. Scegliere il collegamento Name (Nome) per il gruppo di parametri database che desideri modificare.

   (Facoltativo) Scegliere Create parameter group (Crea gruppo di parametri) per creare un nuovo gruppo di parametri del cluster e crea il nuovo gruppo. Scegli il Name (Nome) del nuovo gruppo di parametri.

   Importante

   Questo passaggio è richiesto se disponi solo del gruppo di parametri del cluster di database predefinito perché il gruppo di parametri del cluster di database predefinito non può essere modificato.

4. Cercate il parametro e fate clic sul campo Valore accanto alla colonna Nome.

5. Inserisci il valore consentito e scegli il segno di spunta accanto al campo del valore.

6. Seleziona Salvataggio delle modifiche.

7. Riavvia ogni istanza database nel cluster Neptune se stai modificando un parametro del cluster database oppure riavvia una o più istanze specifiche se stai modificando un parametro di istanza database.

Creazione di un gruppo di parametri database o di un gruppo di parametri del cluster database

Puoi utilizzare la console Neptune per creare facilmente un nuovo gruppo di parametri:

1. Accedi alla Console di gestione AWS e apri la console Amazon Neptune all'indirizzo https://console.aws.amazon.com/neptune/home.

2. Scegliere Parameter groups (Gruppi di parametro) nel riquadro sinistro di navigazione.

3. Scegliere Create DB parameter group (Crea un gruppo di parametri database).

   Compare la pagina Create DB parameter group (Crea gruppo di parametri di database).

4. Nell'elenco Famiglia del gruppo di parametri, scegli neptune1 oppure, se hai come target il motore versione 1.2.0.0 o successiva, scegli neptune1.2.

5. Nell'elenco Type (Tipo), scegliere DB Parameter Group (Gruppo di parametri database) o DB Cluster Parameter Group (Gruppo di parametri del cluster di database).

6. Nella casella Group name (Nome gruppo), digita il nome del nuovo gruppo di parametri database.

7. Nella casella Description (Descrizione), digita una descrizione per il nuovo gruppo di parametri database.

8. Scegli Crea.

Puoi creare un nuovo gruppo di parametri anche utilizzando AWS CLI:

aws neptune create-db-parameter-group \
  --db-parameter-group-name (a name for the new DB parameter group) \
  --db-parameter-group-family (either neptune1 or neptune1.2, depending on the engine version) \
  --description (a description for the new DB parameter group)