Arbeiten mit DB-Parametergruppen in einer DB-Instance - Amazon Relational Database Service

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, der AWS CLIoder 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 an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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).

    Das Fenster Parametergruppe erstellen wird angezeigt.

  4. Wählen Sie in der Liste Parameter group family (Parametergruppenfamilie) eine DB-Parametergruppenfamilie aus.

  5. Wählen Sie in der Liste Typ, falls zutreffend, DB-Parametergruppe aus.

  6. Geben Sie im Feld Group name (Gruppenname) den Namen der neuen DB-Parametergruppe ein.

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

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

Verwenden Sie den Befehl , um eine DB-Parametergruppe zu AWS CLI create-db-parameter-group 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 Linux, macOSoder Unix:

aws rds create-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --db-parameter-group-family MySQL8.0 \ --description "My new parameter group"

Windows:

aws rds create-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --db-parameter-group-family MySQL8.0 ^ --description "My new parameter group"

Die Ausgabe dieses Befehls sieht etwa so aus:

DBPARAMETERGROUP mydbparametergroup mysql8.0 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 eine DB-Parametergruppe mit einer DB-Instance über die AWS Management Console, die AWS CLIoder die RDS-API verknüpfen. 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. Weitere Informationen zum Erstellen einer DB-Instance finden Sie unter Erstellen einer Amazon RDS-DB-Instance. Informationen zum Ändern einer DB-Instance finden Sie unter Ändern einer Amazon RDS-DB-Instance.

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 an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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. Weitere Informationen finden Sie unter Verwenden der Einstellung „Sofort anwenden“.

  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 einer DB-Instance zuzuordnen, verwenden Sie den AWS CLI modify-db-instance Befehl 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. Weitere Informationen finden Sie unter Verwenden der Einstellung „Sofort anwenden“.

Beispiel

Für Linux, macOSoder Unix:

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”
So ändern Sie eine DB-Parametergruppe
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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 ändernde Parametergruppe.

  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-group Befehl 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 Linux, macOSoder Unix:

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 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 an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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-group Befehl 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 Linux, macOSoder Unix:

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 Linux, macOSoder Unix:

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 mithilfe der kopieren AWS Management Console. Sie können auch den AWS CLI copy-db-parameter-group -Befehl oder die RDS-API-Operation CopyDBParameterGroup 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 Parametergruppen der Amazon-RDS-Konsole oder den describe-db-parameters Befehl , 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 ein anderes AWS-Konto oder eine andere kopieren AWS-Region.

So kopieren Sie eine DB-Parametergruppe
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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-group Befehl 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 Linux, macOSoder Unix:

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.

So listen Sie alle DB-Parametergruppen für ein AWS Konto auf
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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.

Um alle DB-Parametergruppen für ein AWS Konto aufzulisten, verwenden Sie den AWS CLI describe-db-parameter-groups Befehl .

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 Linux, macOSoder Unix:

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

Um alle DB-Parametergruppen für ein AWS Konto aufzulisten, verwenden Sie die RDS-API-DescribeDBParameterGroupsOperation .

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 an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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-parameters Befehl 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, der oder der RDS-API löschen. Eine Parametergruppe kann nur gelöscht werden, wenn sie keiner DB-Instance zugeordnet ist.

So löschen Sie eine DB-Parametergruppe
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole 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 zu löschenden Parametergruppen aus.

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

  5. Überprüfen Sie die Parametergruppennamen und wählen Sie dann Löschen aus.

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

  • --db-parameter-group-name

Beispiel

Im folgenden Beispiel wird eine DB-Parametergruppe namens mydbparametergroup gelöscht.

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

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

  • DBParameterGroupName