Amazon-Neptune-Parametergruppen

Sie können Ihre Datenbankkonfiguration in Amazon Neptune mittels Parametern in einer Parametergruppe verwalten. Parametergruppen dienen als Container für Engine-Konfigurationswerte, die auf eine oder mehrere DB-Instances angewendet werden.

Es gibt zwei Arten von Parametergruppen: DB-Cluster-Parametergruppen und DB-Parametergruppen.

• DB-Parametergruppen werden auf Instance-Ebene angewendet und sind im Allgemeinen mit Einstellungen für die Neptune-Diagramm-Engine verknüpft, z. B. dem Parameter neptune_query_timeout.

• DB-Cluster-Parametergruppen gelten für alle Instances im Cluster und weisen weitergefasste Einstellungen auf. Jeder Neptune-Cluster ist einer DB-Cluster-Parametergruppe zugeordnet. Jede DB-Instance in diesem Cluster übernimmt die Engine-Konfigurationswerte aus der DB-Cluster-Parametergruppe.

Alle Konfigurationswerte, die Sie in der DB-Cluster-Parametergruppe ändern, überschreiben die Standardwerte in der DB-Parametergruppe. Wenn Sie die entsprechenden Werte in der DB-Parametergruppe bearbeiten, überschreiben diese Werte die Einstellungen in der DB-Cluster-Parametergruppe.

Wenn Sie eine DB-Instance ohne Angabe einer benutzerdefinierten DB-Parametergruppe erstellen, wird eine Standard-DB-Parametergruppe verwendet. Sie können die Parametereinstellungen der Standard-DB-Parametergruppe nicht ändern. Um die Standard-Parametereinstellungen zu ändern, müssen Sie stattdessen eine neue DB-Parametergruppe erstellen. In einer von Ihnen erstellten DB-Parametergruppe können nicht alle DB-Engine-Parameter geändert werden.

Parametergruppen werden in Familien erstellt, die mit verschiedenen Neptune-Engine-Versionen kompatibel sind. Die Standard-Parametergruppenfamilie ist neptune1, die mit allen Engine-Versionen vor 1.2.0.0 kompatibel ist. Ab Release: 1.2.0.0 (21.07.2022) muss stattdessen die Parametergruppenfamilie neptune1.2 verwendet werden. Daher müssen Sie bei einem Upgrade auf 1.2.0.0 oder höher zunächst alle benutzerdefinierten Parametergruppen in der Familie neptune1.2 neu erstellen, damit Sie diese beim Upgrade anfügen können.

Einige Neptune-Parameter sind statisch, andere sind dynamisch. Die Unterschiede sind wie folgt:

Statische Parameter

• Ein statischer Parameter ist ein Parameter, der erst wirksam wird, wenn eine DB-Instance neu gestartet wird. Wenn Sie einen statischen Parameter ändern und die Instance-DB-Parametergruppe speichern, müssen Sie daher die DB-Instance manuell neu starten, damit die Parameteränderung wirksam wird. Zurzeit sind alle Neptune-Parameter auf Instance-Ebene statisch (in DB-Parametergruppen, nicht in DB-Cluster-Parametergruppen).

• Wenn Sie einen statischen Parameter auf Cluster-Ebene ändern und die DB-Cluster-Parametergruppe speichern, wird die Änderung des Parameters nach dem manuellen Neustart aller DB-Instances im Cluster wirksam.

Dynamische Parameter

• Ein dynamischer Parameter ist ein Parameter, der beinahe direkt nach der Aktualisierung des Parameters in der Parametergruppe wirksam wird. Sie müssen daher eine DB-Instance nach der Aktualisierung eines dynamischen Parameters nicht neu starten, damit die Parameteränderung wirksam wird.

• Die Änderung eines dynamischen Cluster-Parameters wird mit einer geringfügigen Verzögerung auf alle DB-Instances angewendet.

• Ein aktualisierter dynamischer Parameterwert wird nicht auf die aktuell ausgeführten Anforderungen angewendet, sondern nur auf Anforderungen, die nach der Änderung eingereicht wurden.

• Wenn Sie einen dynamischen Parameter auf Cluster-Ebene ändern, wird die Parameteränderung standardmäßig sofort auf den DB-Cluster angewendet, ohne dass ein Neustart erforderlich ist. Wenn Sie die Parameteränderung bis zum Neustart der DB-Instances im Cluster aufschieben möchten, können Sie über die AWS CLI den Wert für ApplyMethod für die Parameteränderung auf pending-reboot festlegen.

Zurzeit sind alle Parameter statisch, abgesehen von den folgenden neuen Cluster-Parametern:

• neptune_enable_slow_query_log   (Cluster-Ebene)

• neptune_slow_query_log_threshold   (Cluster-Ebene)

Hier sind einige wichtige Punkte, die Sie über die Arbeit mit Parametern in einer DB-Parametergruppe kennen sollten:

• Werden die Parameter in einer DB-Parametergruppe unpassend eingestellt, kann dies unbeabsichtigte unerwünschte Auswirkungen haben, einschließlich verminderter Leistung und Systeminstabilität. Gehen Sie immer mit Bedacht vor, wenn Sie Datenbankparameter ändern, und sichern Sie Ihre Daten, bevor Sie eine DB-Parametergruppe ändern. Testen Sie Änderungen an Ihren Parametergruppeneinstellungen zunächst auf einer Test-DB-Instance, ehe Sie die Änderungen für eine Produktions-DB-Instance übernehmen.

• Wenn Sie die DB-Parametergruppe ändern, die einer DB-Instance zugeteilt sind, müssen Sie eine Instance manuell neustarten, bevor Sie die neue DB-Parametergruppe von der DB-Instance verwendet werden kann.

  Anmerkung

  Vor Release: 1.2.0.0 (21.07.2022) wurden bei einem Neustart der primären Instance (Writer-Instance) alle Read-Replicas in einem DB-Cluster automatisch neu gestartet.

  Ab Release: 1.2.0.0 (21.07.2022) führt ein Neustart der primären Instance nicht mehr zum Neustart der Read–Replica-Instances. Wenn Sie einen Parameter auf Cluster-Ebene ändern, müssen Sie daher jede Instance getrennt neu starten, um die Parameteränderung zu übernehmen.

Bearbeiten einer DB-Cluster-Parametergruppe oder DB-Parametergruppe

1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-Neptune-Konsole unter https://console.aws.amazon.com/neptune/home.

2. Wählen Sie im Navigationsbereich Parameter groups (Parametergruppen) aus.

3. Wählen Sie den Name-Link für die DB-Parametergruppe aus, die Sie bearbeiten möchten.

   (Optional) Wählen Sie Create Parameter Group (Parametergruppe erstellen) aus, um eine neue Cluster-Parametergruppe zu erstellen und legen Sie die neue Gruppe an. Wählen Sie dann den Name für die Parametergruppe aus.

   Wichtig

   Dieser Schritt ist erforderlich, wenn Sie nur die Standard-DB-Cluster-Parametergruppe haben, da diese nicht geändert werden kann.

4. Suchen Sie nach dem Parameter und klicken Sie auf das Feld Wert neben der Spalte Name.

5. Geben Sie den zulässigen Wert ein und wählen Sie die Prüfung neben dem Wertfeld aus.

6. Wählen Sie Änderungen speichern aus.

7. Starten Sie jede DB-Instance im Neptune-Cluster neu, wenn Sie einen DB-Cluster-Parameter ändern, oder eine oder mehrere spezifische Instances, wenn Sie einen DB-Instance-Parameter ändern.

Erstellen einer DB-Parametergruppe oder DB-Cluster-Parametergruppe

Sie können die Neptune-Konsole verwenden, um auf einfache Weise eine neue Parametergruppe zu erstellen:

1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-Neptune-Konsole unter https://console.aws.amazon.com/neptune/home.

2. Klicken Sie im linken Navigationsbereich auf Parameter groups (Parametergruppen).

3. Wählen Sie Create DB parameter Group (DB-Parametergruppe erstellen) aus.

   Die Seite Create DB parameter group (DB-Parametergruppe erstellen) wird angezeigt.

4. Wählen Sie in der Liste Parametergruppenfamilie neptune1 und für die Engine-Version 1.2.0.0 oder höher neptune1.2 aus.

5. Wählen Sie in der Liste Typ entweder DB-Parametergruppe oder DB-Cluster-Parametergruppe) aus.

6. Geben Sie im Feld Gruppenname den Namen der neuen DB-Parametergruppe ein.

7. Geben Sie im Feld Beschreibung eine Beschreibung für die neue DB-Parametergruppe ein.

8. Wählen Sie Erstellen.

Sie können eine neue Parametergruppe auch über die AWS CLI erstellen:

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)