Arbeiten mit DB-Parametergruppen in einer DB-Instance - Amazon Aurora

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit DB-Parametergruppen in einer DB-Instance

DB-Instances verwenden DB-Parametergruppen. Die folgenden Abschnitte beschreiben das Konfigurieren und Verwalten von DB-Instance-Parametergruppen.

Erstellen einer DB-Parametergruppe

Sie können eine neue DB-Parametergruppe mithilfe der AWS Management Console AWS CLI, der oder der RDS-API erstellen.

Die folgenden Einschränkungen gelten für den Namen der DB-Parametergruppe:

  • Der Name muss zwischen 1 und 255 Buchstaben, Zahlen oder Bindestriche enthalten.

    Standardnamen für Parametergruppen können einen Punkt enthalten, z. B. default.mysql8.0. Namen von benutzerdefinierten Parametergruppen dürfen jedoch keinen Punkt enthalten.

  • Das erste Zeichen muss ein Buchstabe sein.

  • Der Name darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

So erstellen Sie eine DB-Parametergruppe:
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

  3. Wählen Sie Create parameter group (Parametergruppe erstellen).

  4. Geben Sie unter Parametergruppenname den Namen Ihrer neuen DB-Parametergruppe ein.

  5. Geben Sie unter Beschreibung eine Beschreibung für Ihre neue DB-Parametergruppe ein.

  6. Wählen Sie als Engine-Typ Ihre DB-Engine aus.

  7. Wählen Sie für Parametergruppenfamilie eine DB-Parametergruppenfamilie aus.

  8. Wählen Sie für Typ, falls zutreffend, DB-Parametergruppe aus.

  9. Wählen Sie Create (Erstellen) aus.

Verwenden Sie den AWS CLI create-db-parameter-groupBefehl, um eine DB-Parametergruppe zu erstellen. Im folgenden Beispiel wird eine DB-Parametergruppe mit dem Namen mydbparametergroup für MySQL Version 8.0 und der Beschreibung „My new parameter group“ erstellt.

Nutzen Sie die folgenden erforderlichen Parameter:

  • --db-parameter-group-name

  • --db-parameter-group-family

  • --description

Um alle verfügbaren Parametergruppenfamilien aufzulisten, führen Sie den folgenden Befehl aus:

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

Die Ausgabe enthält Duplikate.

Beispiel

Für LinuxmacOS, oderUnix:

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

Windows:

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

Die Ausgabe dieses Befehls sieht etwa so aus:

DBPARAMETERGROUP mydbparametergroup aurora-mysql5.7 My new parameter group

Um eine DB-Parametergruppe zu erstellen, verwenden Sie die RDS-API-Operation CreateDBParameterGroup.

Nutzen Sie die folgenden erforderlichen Parameter:

  • DBParameterGroupName

  • DBParameterGroupFamily

  • Description

Verknüpfen einer DB-Parametergruppe mit einer DB-Instance

Sie können Ihre eigenen DB-Parametergruppen mit benutzerdefinierten Einstellungen erstellen. Sie können einer DB-Instance mithilfe der AWS Management Console, der oder der RDS-API eine DB-Parametergruppe zuordnen. AWS CLI Das können Sie tun, wenn Sie eine DB-Instance erstellen oder ändern.

Informationen über das Erstellen einer Parametergruppe finden Sie unter Erstellen einer DB-Parametergruppe. Informationen zum Ändern einer DB-Instance finden Sie unter Ändern einer DB-Instance in einem DB-Cluster.

Anmerkung

Wenn Sie eine neue DB-Parametergruppe einer DB-Instance zuordnen, werden die geänderten statischen und dynamischen Parameter erst nach Neustart der DB-Instance angewendet. Wenn Sie jedoch dynamische Parameter in der DB-Parametergruppe ändern, nachdem Sie sie der DB-Instance zugeordnet haben, werden diese Änderungen sofort ohne Neustart angewendet.

So verknüpfen Sie eine DB-Parametergruppe mit einer DB-Instance
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

  2. Wählen Sie im Navigationsbereich Databases (Datenbanken) und dann die DB-Instance, die Sie ändern möchten.

  3. Wählen Sie Modify aus. Die Seite Modify DB instance (DB-Instance ändern) wird angezeigt.

  4. Ändern Sie die Einstellung für DB-Parametergruppen .

  5. Klicken Sie auf Weiter und überprüfen Sie die Zusammenfassung aller Änderungen.

  6. (Optional) Klicken Sie auf Apply immediately (Sofort anwenden), um die Änderungen direkt zu übernehmen. Die Auswahl dieser Option kann in einigen Fällen einen Ausfall verursachen.

  7. Überprüfen Sie auf der Bestätigungsseite Ihre Änderungen. Wenn sie korrekt sind, wählen Sie Modify DB Instance (DB-Instance ändern) aus, um Ihre Änderungen zu speichern.

    Oder klicken Sie auf Zurück, um Ihre Änderungen zu bearbeiten, oder auf Abbrechen, um Ihre Änderungen zu verwerfen.

Um eine DB-Parametergruppe mit einer DB-Instance zu verknüpfen, verwenden Sie den AWS CLI modify-db-instanceBefehl mit den folgenden Optionen:

  • --db-instance-identifier

  • --db-parameter-group-name

Im folgenden Beispiel wird die mydbpg-DB-Parametergruppe mit der database-1-DB-Instance verknüpft. Die Änderungen werden mit sofort übernomme --apply-immediately. Verwenden Sie --no-apply-immediately, um Änderungen im nächsten Wartungszeitraum anzuwenden.

Beispiel

Für LinuxmacOS, oderUnix:

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

Windows:

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

Um eine DB-Parametergruppe zu einer DB-Instance zuzuordnen, verwenden Sie die RDS-API-Operation ModifyDBInstance mit den folgenden Parametern:

  • DBInstanceName

  • DBParameterGroupName

Ändern von Parametern in einer DB-Parametergruppe

Sie können die Parameterwerte in einer benutzerdefinierten DB-Parametergruppe ändern. Die Parameterwerte in einer Standard-DB-Parametergruppe können nicht geändert werden. Änderungen bei Parametern in einer benutzerdefinierten DB-Parametergruppe werden auf alle DB-Instances angewandt, die dieser DB-Parametergruppe zugeteilt sind.

Änderungen an einigen Parametern werden sofort ohne Neustart auf die DB-Instance angewendet. Änderungen an anderen Parametern werden erst angewendet, nachdem die DB-Instance neu gestartet wurde. In der RDS-Konsole wird der Status einer DB-Parametergruppe, die einer DB-Instance zugeordnet ist, auf der Registerkarte Konfiguration angezeigt. Nehmen wir beispielsweise an, dass auf der DB-Instance die neuesten Änderungen an der zugeordneten DB-Parametergruppe noch nicht übernommen wurden. In diesem Fall gibt die RDS-Konsole für die DB-Parametergruppe den Status pending-reboot an. Damit die neuesten Parameteränderungen für diese DB-Instance übernommen werden, starten Sie die DB-Instance manuell neu.

Ändern von Parametern im Szenario „pending reboot”
Um die Parameter in einer DB-Parametergruppe zu ändern
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

  3. Wählen Sie in der Liste den Namen der Parametergruppe aus, die Sie ändern möchten.

  4. Wählen Sie für Parameter group actions (Parametergruppenaktionen) die Option Bearbeiten.

  5. Ändern Sie wie gewünscht die Werte der Parameter. Sie können durch die Parameter scrollen, in dem Sie die Pfeiltasten oben rechts im Dialogfeld verwenden.

    Die Werte in einer Standardparametergruppe können Sie nicht ändern.

  6. Wählen Sie Save Changes.

Um eine DB-Parametergruppe zu ändern, verwenden Sie den AWS CLI modify-db-parameter-groupBefehl mit den folgenden erforderlichen Optionen:

  • --db-parameter-group-name

  • --parameters

Im folgenden Beispiel werden die Werte max_connections und max_allowed_packet in der DB-Parametergruppe mydbparametergroup geändert.

Beispiel

Für LinuxmacOS, oderUnix:

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"

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"

Die Ausgabe des Befehls ähnelt der Folgenden:

DBPARAMETERGROUP mydbparametergroup

Zum Ändern einer DB-Parametergruppe verwenden Sie die RDS-API-Operation ModifyDBParameterGroup mit den folgenden erforderlichen Parametern:

  • DBParameterGroupName

  • Parameters

Zurücksetzen von Parametern in einer DB-Parametergruppe auf ihre Standardwerte

Sie können Parameterwerte in einer vom Kunden erstellten DB-Parametergruppe auf ihre Standardwerte zurücksetzen. Änderungen bei Parametern in einer benutzerdefinierten DB-Parametergruppe werden auf alle DB-Instances angewandt, die dieser DB-Parametergruppe zugeteilt sind.

Wenn Sie die Konsole verwenden, können Sie bestimmte Parameter auf ihre Standardwerte zurücksetzen. Sie können jedoch nicht einfach alle Parameter in der DB-Parametergruppe auf einmal zurücksetzen. Wenn Sie die AWS CLI oder die RDS-API verwenden, können Sie bestimmte Parameter auf ihre Standardwerte zurücksetzen. Sie können auch alle Parameter in der DB-Parametergruppe auf einmal zurücksetzen.

Änderungen an einigen Parametern werden sofort ohne Neustart auf die DB-Instance angewendet. Änderungen an anderen Parametern werden erst angewendet, nachdem die DB-Instance neu gestartet wurde. In der RDS-Konsole wird der Status einer DB-Parametergruppe, die einer DB-Instance zugeordnet ist, auf der Registerkarte Konfiguration angezeigt. Nehmen wir beispielsweise an, dass auf der DB-Instance die neuesten Änderungen an der zugeordneten DB-Parametergruppe noch nicht übernommen wurden. In diesem Fall gibt die RDS-Konsole für die DB-Parametergruppe den Status pending-reboot an. Damit die neuesten Parameteränderungen für diese DB-Instance übernommen werden, starten Sie die DB-Instance manuell neu.

Ändern von Parametern im Szenario „pending reboot”
Anmerkung

In einer Standard-DB-Parametergruppe werden Parameter immer auf ihre Standardwerte festgelegt.

So setzen Sie Parameter in einer DB-Parametergruppe auf ihre Standardwerte zurück
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

  3. Wählen Sie in der Liste die Parametergruppe aus.

  4. Wählen Sie für Parameter group actions (Parametergruppenaktionen) die Option Bearbeiten.

  5. Wählen Sie die Parameter aus, die Sie auf ihre Standardwerte zurücksetzen möchten. Sie können durch die Parameter scrollen, in dem Sie die Pfeiltasten oben rechts im Dialogfeld verwenden.

    Sie können die Werte in einer Standardparametergruppe nicht zurücksetzen.

  6. Wählen Sie Reset (Zurücksetzen) und bestätigen Sie dann mit Reset parameters (Parameter zurücksetzen).

Um einige oder alle Parameter in einer DB-Parametergruppe zurückzusetzen, verwenden Sie den AWS CLI reset-db-parameter-groupBefehl mit der folgenden erforderlichen Option:--db-parameter-group-name.

Um alle Parameter in der DB-Parametergruppe zurückzusetzen, geben Sie die Option --reset-all-parameters an. Um bestimmte Parameter zurückzusetzen, geben Sie die Option --parameters an.

Im folgenden Beispiel werden alle Parameter in der DB-Parametergruppe namens mydbparametergroup auf ihre Standardwerte zurückgesetzt.

Beispiel

Für LinuxmacOS, oderUnix:

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

Windows:

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

Im folgenden Beispiel werden die Optionen max_connections und max_allowed_packet in der DB-Parametergruppe namens mydbparametergroup auf ihre Standardwerte zurückgesetzt.

Beispiel

Für LinuxmacOS, oderUnix:

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

Windows:

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

Die Ausgabe des Befehls ähnelt der Folgenden:

DBParameterGroupName mydbparametergroup

Um Parameter in einer DB-Parametergruppe auf ihre Standardwerte zurückzusetzen, verwenden Sie den RDS-API-Befehl ResetDBParameterGroup mit dem folgenden erforderlichen Parameter: DBParameterGroupName.

Um alle Parameter in der DB-Parametergruppe zurückzusetzen, setzen Sie den Parameter ResetAllParameters auf true. Um bestimmte Parameter zurückzusetzen, geben Sie den Parameter Parameters an.

Kopieren einer DB-Parametergruppe

Sie können benutzerdefinierte DB-Parametergruppen, die Sie erstellt haben, kopieren. Das Kopieren einer Parametergruppe kann eine bequeme Lösung sein. Ein Beispiel ist, wenn Sie eine DB-Parametergruppe erstellt haben und die am häufigsten verwendeten Parameter und Werte in einer neuen DB-Parametergruppe aufnehmen möchten. Sie können eine DB-Parametergruppe kopieren, indem Sie den verwenden AWS Management Console. Sie können auch den AWS CLI copy-db-parameter-groupBefehl oder den ParameterGroupCopyDB-Vorgang der RDS-API verwenden.

Nachdem Sie eine DB-Parametergruppe kopiert haben, warten Sie mindestens fünf Minuten, bevor Sie die erste DB-Instance erstellen, die diese DB-Parametergruppe als Standardparametergruppe verwendet. So kann die Kopieraktion in Amazon RDS abgeschlossen werden, bevor die Parametergruppe verwendet wird. Dies ist insbesondere für Parameter wichtig, die beim Erstellen der Standarddatenbank für eine DB-Instance wichtig sind. Ein Beispiel ist der Zeichensatz für die mit dem Parameter character_set_database definierte Standarddatenbank. Verwenden Sie die Option Parameter Groups der Amazon RDS-Konsole oder den describe-db-parametersBefehl, um zu überprüfen, ob Ihre DB-Parametergruppe erstellt wurde.

Anmerkung

Standardparametergruppen können nicht kopiert werden. Sie können jedoch eine neue Parametergruppe erstellen, die auf einer Standardparametergruppe basiert.

Sie können eine DB-Parametergruppe nicht in eine andere AWS-Konto oder kopieren AWS-Region.

So kopieren Sie eine DB-Parametergruppe
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

  3. Wählen Sie in der Liste die zu kopierende benutzerdefinierte Parametergruppe.

  4. Wählen Sie für Parameter group actions (Parametergruppenaktionen) die Option Kopieren.

  5. Geben Sie unter New DB parameter group identifier (Neue DB-Parametergruppenkennung) einen Namen für die neue Parametergruppe ein.

  6. Geben Sie unter Beschreibung eine Beschreibung für die neue Parametergruppe ein.

  7. Wählen Sie die Option Copy aus.

Um eine DB-Parametergruppe zu kopieren, verwenden Sie den AWS CLI copy-db-parameter-groupBefehl mit den folgenden erforderlichen Optionen:

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

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

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

Im folgenden Beispiel wird eine neue DB-Parametergruppe mit dem Namen mygroup2 that is a copy of the DB parameter group mygroup1 erstellt.

Beispiel

Für LinuxmacOS, oderUnix:

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"

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"

Zum Kopieren einer DB-Parametergruppe verwenden Sie die RDS-API-Aktion CopyDBParameterGroup mit den folgenden erforderlichen Parametern:

  • SourceDBParameterGroupIdentifier

  • TargetDBParameterGroupIdentifier

  • TargetDBParameterGroupDescription

Auflisten von DB-Parametergruppen

Sie können die DB-Parametergruppen auflisten, die Sie für Ihr AWS Konto erstellt haben.

Anmerkung

Standard-Parametergruppen werden automatisch aus einer Vorlage für Standard-Parameter erstellt, wenn Sie eine DB-Instance für eine bestimmte DB-Engine und -Version erstellen. Diese Standardparametergruppen enthalten bevorzugte Parametereinstellungen und können nicht geändert werden. Wenn Sie eine benutzerdefinierte Parametergruppe erstellen, können Sie Parametereinstellungen ändern.

Um alle DB-Parametergruppen für ein AWS Konto aufzulisten
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

    Die verfügbaren DB-Parametergruppen erscheinen in einer Liste.

Verwenden Sie den AWS CLI describe-db-parameter-groupsBefehl, um alle DB-Parametergruppen für ein AWS Konto aufzulisten.

Beispiel

Im folgenden Beispiel werden alle verfügbaren DB-Parametergruppen für ein AWS -Konto aufgelistet.

aws rds describe-db-parameter-groups

Die Ausgabe des Befehls ähnelt der Folgenden:

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

Im folgenden Beispiel wird die Parametergruppe mydbparamgroup1 beschrieben.

Für LinuxmacOS, oderUnix:

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

Windows:

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

Die Ausgabe des Befehls ähnelt der Folgenden:

DBPARAMETERGROUP mydbparametergroup1 mysql8.0 My new parameter group

Verwenden Sie den DescribeDBParameterGroupsRDS-API-Vorgang, um alle DB-Parametergruppen für ein AWS Konto aufzulisten.

Anzeigen von Parameterwerten für eine DB-Parametergruppe

Sie können eine Liste aller Parameter in einer DB-Parametergruppe und ihren Werten erhalten.

So können Sie die Parameterwerte für eine DB-Parametergruppe ansehen
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

    Die verfügbaren DB-Parametergruppen erscheinen in einer Liste.

  3. Wählen Sie den Namen der Parametergruppe, um deren Parameterliste anzuzeigen.

Um die Parameterwerte für eine DB-Parametergruppe anzuzeigen, verwenden Sie den AWS CLI describe-db-parametersBefehl mit dem folgenden erforderlichen Parameter.

  • --db-parameter-group-name

Beispiel

Im folgenden Beispiel werden die Parameter und Parameterwerte für eine DB-Parametergruppe mit dem Namen mydbparametergroup. aufgelistet.

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

Die Ausgabe des Befehls ähnelt der Folgenden:

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

Um die Parameterwerte für eine DB-Parametergruppe anzuzeigen, verwenden Sie den RDS-API-Befehl DescribeDBParameters mit dem folgenden erforderlichen Parameter.

  • DBParameterGroupName

Löschen einer DB-Parametergruppe

Sie können eine DB-Parametergruppe mithilfe der AWS Management Console AWS CLI, oder RDS-API löschen. Eine Parametergruppe kann nur gelöscht werden, wenn sie keiner DB-Instance zugeordnet ist.

Um eine DB-Parametergruppe zu löschen
  1. Melden Sie sich bei der Amazon RDS-Konsole an AWS Management Console und öffnen Sie sie unter https://console.aws.amazon.com/rds/.

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

    Die verfügbaren DB-Parametergruppen erscheinen in einer Liste.

  3. Wählen Sie den Namen der Parametergruppen, die gelöscht werden sollen.

  4. Wählen Sie Aktionen und dann Löschen.

  5. Überprüfen Sie die Namen der Parametergruppen und wählen Sie dann Löschen.

Um eine DB-Parametergruppe zu löschen, verwenden Sie den AWS CLI delete-db-parameter-groupBefehl mit dem folgenden erforderlichen Parameter.

  • --db-parameter-group-name

Beispiel

Im folgenden Beispiel wird eine DB-Parametergruppe mit dem Namen mydbparametergroup gelöscht.

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

Um eine DB-Parametergruppe zu löschen, verwenden Sie den DeleteDBParameterGroupRDS-API-Befehl mit dem folgenden erforderlichen Parameter.

  • DBParameterGroupName