Arbeiten mit DB-Parametergruppen - Amazon Relational Database Service

Arbeiten mit DB-Parametergruppen

Database parameters (Datenbankparameter) – geben Sie an, wie die Datenbank konfiguriert wird. Datenbankparameter können z. B. die Menge der Ressourcen angeben, die einer Datenbank zugewiesen werden sollen, wie etwa den Speicher.

Sie verwalten Ihre Datenbankkonfiguration, indem Sie Ihre DB-Instances Parametergruppen zuordnen. Amazon RDS definiert Parametergruppen mit Standardeinstellungen.

Wichtig

Sie können auch eigene Parametergruppen mit angepassten Einstellungen definieren. Sie können Ihre DB-Instances dann ändern, sodass Ihre eigenen Parametergruppen genutzt werden.

Informationen zum Ändern einer DB-Instance finden Sie unter Ändern einer Amazon RDS-DB-Instance.

Anmerkung

Einige DB-Engines bieten zusätzliche Funktionen, um die Sie Ihre Datenbank optional in einer Optionsgruppe ergänzen können. Informationen über Optionsgruppen finden Sie unter Arbeiten mit Optionsgruppen.

Eine DB-Parametergruppe dient als Container für Engine-Konfigurationswerte, die auf eine oder mehr DB-Instance angewendet werden.

Wenn Sie eine DB-Instance ohne Angabe einer DB-Parametergruppe erstellen, verwendet die DB-Instance eine Standard-DB-Parametergruppe. Jede Standard-DB-Parametergruppe enthält Standardeinstellungen für die Datenbank-Engine und das Amazon RDS-System, die auf der Engine, der Datenverarbeitungsklasse und dem zugeordneten Speicher der Instance basieren. Sie können die Parametereinstellungen für eine Standard-Parametergruppe nicht ändern. Erstellen Sie stattdessen Ihre eigene Parametergruppe, in der Sie eigene Parametereinstellungen auswählen können. In einer von Ihnen erstellten Parametergruppe können nicht alle DB-Engine-Parameter geändert werden.

Wenn eine eigene Parametergruppe verwendet werden soll, erstellen Sie eine neue Parametergruppe und passen Sie die gewünschten Parameter an. Ändern Sie dann Ihre DB-Instance , sodass die neue Parametergruppe genutzt wird. Wenn Sie Parameter innerhalb einer DB-Parametergruppe aktualisieren, gelten die Änderungen für alle DB-Instances, die dieser Parametergruppe zugeordnet sind.

Sie können auch eine bestehende DB-Parametergruppe mit dem AWS CLI-Befehl copy-db-parameter-group kopieren. Das Kopieren einer Parametergruppe kann eine praktische Lösung sein, wenn Sie die meisten benutzerdefinierten Parameter und Werte einer vorhandenen DB-Parametergruppe in einer neuen DB-Parametergruppe einschließen möchten.

Es folgen einige wichtige Punkte bei der Verwendung von Parametern in einer DB-Parametergruppe:

  • Die Datenbankparameter sind entweder statisch oder dynamisch. Wenn Sie einen statischen Parameter ändern, muss die Datenbank neu gestartet werden, damit die Änderung übernommen wird. Wenn Sie einen dynamischen Parameter ändern und die DB-Parametergruppe speichern, wird diese Änderung sofort übernommen, ungeachtet der Einstellung von Apply Immediately (Sofort anwenden). Wenn Sie einen statischen Parameter ändern und eine DB-Parametergruppe speichern, wird die Änderung des Parameters nach einem manuellen Neustart der DB-Instance angewendet. Sie können eine DB-Instance mithilfe der RDS-Konsole neu starten, indem Sie den CLI-Befehl reboot-db-instance oder den API-Vorgang RebootDbInstance aufrufen. Weil die zugeordnete DB-Instance nach der Änderung eines statischen Parameters neu gestartet werden muss, wird das Risiko einer fehlerhaften Konfiguration gesenkt, die API-Aufrufe beeinträchtigen könnte (z. B. der Aufruf von ModifyDBInstance zum Ändern einer DB-Instance oder zur Speicherskalierung).

    Wenn auf der DB-Instance noch nicht die neuesten Änderungen der zugeordneten DB-Parametergruppe übernommen wurden, gibt die AWS Management Console für diese DB-Parametergruppe den Status pending-reboot (Neustart ausstehend) an. Die Parametergruppe pending-reboot führt während des nächsten Wartungsfensters nicht zu einem automatischen Neustart. Damit die neuesten Parameteränderungen für diese DB-Instance übernommen werden, starten Sie die DB-Instance manuell neu.

  • Wenn Sie die DB-Parametergruppe ändern, die einer DB-Instance zugeteilt ist, müssen Sie eine Instance manuell neu starten, bevor die neue DB-Parametergruppe von der DB-Instance verwendet werden kann. Weitere Informationen zum Ändern der DB-Parametergruppe finden Sie unter Ändern einer Amazon RDS-DB-Instance.

  • Sie können den Wert für einen DB-Parameter durch eine Ganzzahl oder als Ganzzahlausdruck aus Formeln, Variablen, Funktionen und Operatoren angeben. Funktionen können einen mathematischen "log"-Ausdruck enthalten. Weitere Informationen finden Sie unter Festlegen von DB-Parametern.

  • Bevor Sie die DB-Instance und eine Datenbank auf der DB-Instance erstellen, legen Sie alle Parameter für den Zeichensatz oder die Datenbankkollation in der Parametergruppe fest. Dadurch kann sichergestellt werden, dass die Standard-Datenbank und neue Datenbanken in Ihrer DB-Instance, Zeichensätze und Werte aus einer Sammlung verwenden, die Sie festlegen können. Wenn Sie einen Zeichensatz oder eine Sammlung von Parametern in Ihrer DB-Instance ändern, werden die Parameteränderungen nicht in Ihren bestehenden Datenbanken angewandt.

    Sie können den Zeichensatz oder die Sammlung von Werten für eine bestehende Datenbank mit dem Befehl ALTER DATABASE ändern, wie zum Beispiel:

    ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
  • 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. Führen Sie Änderungen an einer Parametergruppe immer zuerst auf einer Test-DB-Instance aus, bevor Sie diese Änderungen für eine Produktions-DB-Instance übernehmen.

  • Um die unterstützten Parameter für Ihre DB-Engine zu ermitteln, können Sie die Parameter in der DB-Parametergruppe anzeigen, die vom der DB-Instance verwendet werden. Weitere Informationen erhalten Sie unter Anzeigen von Parameterwerten für eine DB-Parametergruppe.

Erstellen einer DB-Parametergruppe

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

So erstellen Sie eine DB-Parametergruppe:

  1. Melden Sie sich bei der AWS Management Console an 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 Create parameter group (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 Type (Typ)DB Parameter Group (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 AWS CLI-Befehl create-db-parameter-group, um eine DB-Parametergruppe zu erstellen. Im folgenden Beispiel wird eine DB-Parametergruppe mit dem Namen mydbparametergroup für MySQL Version 5.6 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, macOS oder Unix:

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

Für Windows:

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

Die Ausgabe dieses Befehls sieht etwa so aus:

DBPARAMETERGROUP mydbparametergroup mysql5.6 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 mithilfe der AWS Management Console, der AWS CLI oder der RDS-API zu einer DB-Instance zuordnen. 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 die DB-Parametergruppe ändern, die einer DB-Instance zugeteilt ist, müssen Sie eine Instance manuell neu starten, bevor die neue DB-Parametergruppe von der DB-Instance verwendet werden kann.

So verknüpfen Sie eine DB-Parametergruppe mit einer DB-Instance

  1. Melden Sie sich bei der AWS Management Console an 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-Befehl modify-db-instance 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 unterVerwenden der Einstellung „Sofort anwenden“.

Beispiel

Für Linux, macOS oder Unix:

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

Für 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. Wenn beispielsweise auf der DB-Instance die neuesten Änderungen an der zugeordneten DB-Parametergruppe noch nicht übernommen wurden, gibt die RDS-Konsole für diese DB-Parametergruppe den Status pending-reboot (Neustart ausstehend) 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 AWS Management Console an 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.

Verwenden Sie den AWS CLI-Befehl modify-db-parameter-group mit den folgenden erforderlichen Parametern, um eine DB-Parametergruppe zu ändern:

  • --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, macOS oder 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"

Für 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, aber Sie können 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 und 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. Wenn beispielsweise auf der DB-Instance die neuesten Änderungen an der zugeordneten DB-Parametergruppe noch nicht übernommen wurden, gibt die RDS-Konsole für diese DB-Parametergruppe den Status pending-reboot (Neustart ausstehend) 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 AWS Management Console an und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

  2. Wähleereich n Sie im NavigationsbParameter 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 Befehl AWS CLIreset-db-parameter-group 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, macOS oder Unix:

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

Für 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, macOS oder Unix:

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

Für 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 ist eine praktische Lösung, wenn Sie bereits eine DB-Parametergruppe erstellt haben und die am häufigsten verwenden Parameter und Werte aus dieser Gruppe in einer neuen DB-Parametergruppe aufnehmen möchten. Sie können eine DB-Parametergruppe mit dem AWS Management Console-Befehl AWS CLIcopy-db-parameter-group oder der RDS-API-Operation CopyDBParameterGroup kopieren.

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. Überprüfen Sie mithilfe der Option Parameter Groups (Parametergruppen) in der Amazon RDS-Konsole oder mithilfe des Befehls describe-db-parameters, 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.

Derzeit können Sie eine Parametergruppe nicht in eine andere AWS-Region kopieren.

So kopieren Sie eine DB-Parametergruppe

  1. Melden Sie sich bei der AWS Management Console an 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.

Verwenden Sie den Befehl AWS CLIcopy-db-parameter-group mit den folgenden erforderlichen Parametern, um eine DB-Parametergruppe zu kopieren:

  • --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, macOS oder 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"

Für 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 können Sie alle DB-Parametergruppen für ein AWS-Konto auflisten lassen

  1. Melden Sie sich bei der AWS Management Console an 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.

Zum Auflisten aller DB-Parametergruppen für ein AWS-Konto verwenden Sie den AWS CLI-Befehl describe-db-parameter-groups.

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.mysql5.6 mysql5.6 Default parameter group for MySQL5.6 DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

Im folgenden Beispiel wird die Parametergruppe mydbparamgroup1 beschrieben.

Für Linux, macOS oder Unix:

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

Für Windows:

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

Die Ausgabe des Befehls ähnelt der Folgenden:

DBPARAMETERGROUP mydbparametergroup1 mysql5.6 My new parameter group

Zum Auflisten aller DB-Parametergruppen für ein AWS-Konto verwenden Sie die RDS-API-Operation DescribeDBParameterGroups.

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 AWS Management Console an 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.

Verwenden Sie den AWS CLI-Befehl describe-db-parameters mit dem folgenden erforderlichen Parameter, um die Parameterwerte für eine DB-Parametergruppe anzusehen.

  • --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

Vergleichen von DB-Parametergruppen

Mit der AWS Management Console können Sie schnell die Unterschiede zwischen zwei Parametergruppen der gleichen DB-Engine und -Version anzeigen.

So vergleichen Sie zwei Parametergruppen

  1. Melden Sie sich bei der AWS Management Console an 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 beiden zu vergleichenden Parametergruppen.

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

    Anmerkung

    Wenn die von Ihnen ausgewählten Elemente nicht identisch sind, können Sie Compare (Vergleichen) nicht wählen. Beispielsweise können Sie eine MySQL 5.6- und eine MySQL 5.7-Parametergruppe nicht vergleichen. Sie können eine DB-Parametergruppe nicht mit einer Aurora DB-Cluster-Parametergruppe vergleichen.

Festlegen von DB-Parametern

Zu den DB-Parametertypen gehören die folgenden:

  • Ganzzahl

  • Boolesch

  • Zeichenfolge

  • Long

  • Double

  • Zeitstempel

  • Objekt anderer definierter Datentypen

  • Array von Werten vom Typ Ganzzahlwert, Boolesch, String, Long, Double, Zeitstempel oder Objekt

Sie können auch Ganzzahl- und Boolesche DB-Parameter mit Ausdrücken, Formeln und Funktionen angeben.

Für die Oracle-Engine können Sie die DBInstanceClassHugePagesDefault-Formelvariable zur Angabe eines booleschen DB-Parameters verwenden. Siehe DB-Parameter-Formel-Variablen.

Für die PostgreSQL-Engine können Sie einen Ausdruck verwenden, um einen booleschen DB-Parameter anzugeben. Siehe Boolesche DB-Parameterausdrücke.

DB-Parameter-Formeln

Eine DB-Parameterformel ist ein Ausdruck, der in einen Ganzzahlwert oder einen booleschen Wert aufgelöst wird. Sie schließen den Ausdruck in Klammern ein: {}. Sie können eine Formel entweder für einen DB-Parameterwert oder als Argument für eine DB-Parameterfunktion verwenden.

Syntax
{FormulaVariable} {FormulaVariable*Integer} {FormulaVariable*Integer/Integer} {FormulaVariable/Integer}

DB-Parameter-Formel-Variablen

Jede Formelvariable gibt einen Ganzzahlwert oder einen booleschen Wert zurück. Bei den Namen aller Variablen muss die Groß- und Kleinschreibung beachtet werden.

AllocatedStorage

Gibt einen Ganzzahlwert zurück, der die Größe des Datenvolumens in Byte darstellt.

DBInstanceClassHugePagesDefault

Gibt einen booleschen Wert zurück. Sie wird derzeit nur für Oracle-Engines unterstützt.

Weitere Informationen finden Sie unter Aktivieren von HugePages für eine Oracle DB-Instance.

DBInstanceClassMemory

Gibt einen Ganzzahlwert in Anzahl von Bytes den zugeteilten Speicherplatz für die DB-Instance-Klasse zurück, die der aktuellen DB-Instance zugeteilt ist, abzüglich des Speichers, der von RDS-Vorgängen für die Verwaltung der Instance verwendet wird.

DBInstanceVCPU

Gibt eine Ganzzahl zurück, die die Anzahl der virtuellen zentralen Verarbeitungseinheiten (vCPUs) darstellt, die von Amazon RDS verwendet werden, um die Instance zu verwalten. Derzeit wird dies nur für die PostgreSQL-Engine unterstützt.

Endpunkt-Port

Gibt eine Ganzzahl zurück, die den beim Herstellen einer Verbindung mit der DB-Instance verwendeten Port darstellt.

DB-Parameter-Formel-Operatoren

DB-Parameter-Formeln unterstützen zwei Operatoren: Division und Multiplikation.

Divisions-Operator: /

Dividiert den Dividend durch den Divisor, gibt einen Quotienten als Ganzzahl zurück. Dezimalzahlen in einem Quotienten werden gekürzt und nicht gerundet.

Syntax

dividend / divisor

Die Dividend- und Divisor-Argumente müssen Ausdrücke mit Ganzzahlen sein.

Multiplikations-Operator: *

Multipliziert die Ausdrücke und gibt das Produkt der Ausdrücke zurück. Dezimalstellen in Ausdrücken werden gekürzt (und nicht gerundet).

Syntax

expression * expression

Beide Ausdrücke müssen Ganzzahlen sein.

DB-Parameter-Funktionen

Sie geben die Argumente von DB-Parameter-Funktionen entweder als Ganzzahlen oder Formeln an. Jede Funktion muss mindestens ein Argument haben. Geben Sie mehrere Argumente als kommagetrennte Liste an. Die Liste darf keine leeren Elemente aufweisen, z. B. argument1,,argument3. Bei Funktionsnamen wird zwischen Groß- und Kleinschreibung unterschieden.

IF

Gibt ein Argument zurück.

Sie wird derzeit nur für Oracle-Engines unterstützt und das einzige unterstützte erste Argument ist {DBInstanceClassHugePagesDefault}. Weitere Informationen finden Sie unter Aktivieren von HugePages für eine Oracle DB-Instance.

Syntax

IF(argument1, argument2, argument3)

Gibt das zweite Argument zurück, wenn das erste Argument als wahr ausgewertet wird. Gibt andernfalls das dritte Argument zurück.

GREATEST

Gibt den größten Wert aus einer Liste von Ganzzahlen oder Parameter-Formeln zurück.

Syntax

GREATEST(argument1, argument2,...argumentn)

Gibt eine Ganzzahl zurück.

LEAST

Gibt den kleinsten Wert aus einer Liste von Ganzzahlen oder Parameter-Formeln zurück.

Syntax

LEAST(argument1, argument2,...argumentn)

Gibt eine Ganzzahl zurück.

SUM

Addiert die Werte der festgelegten Ganzzahlen oder Parameter-Formeln.

Syntax

SUM(argument1, argument2,...argumentn)

Gibt eine Ganzzahl zurück.

Boolesche DB-Parameterausdrücke

Ein boolescher DB-Parameterausdruck wird in einen booleschen Wert von 1 oder 0 aufgelöst. Der Ausdruch ist in Anführungszeichen gesetzt.

Anmerkung

Boolesche DB-Parameterausdrücke werden nur für die PostgreSQL-Engine unterstützt.

Syntax
"expression operator expression"

Beide Ausdrücke müssen in Ganzzahlen aufgelöst werden. Ein Ausdruck kann folgender sein:

  • Konstante mit Ganzzahlwert

  • DB-Parameter-Formel

  • DB-Parameter-Funktion

  • DB-Parametervariable

Boolesche DB-Parameterausdrücke unterstützen die folgenden Operatoren für Ungleichheit:

Der Operator größere als: >

Syntax

"expression > expression"
Der Operator kleiner als: <

Syntax

"expression < expression"
Die Operatoren größer als oder gleich: >=, =>

Syntax

"expression >= expression" "expression => expression"
Die Operatoren kleiner als oder gleich: <=, =<

Syntax

"expression <= expression" "expression =< expression"

Beispiel Verwenden eines booleschen DB-Parameterausdrucks

Im folgenden Beispiel für einen booleschen DB-Parameterausdruck wird das Ergebnis einer Parameterformel mit einer Ganzzahl verglichen, um den booleschen DB-Parameter wal_compression für eine PostgreSQL-DB-Instance zu ändern. Der Parameterausdruck vergleicht die Anzahl der vCPUs mit dem Wert 2. Wenn die Anzahl der vCPUs größer als 2 ist, wird der wal_compression-DB-Parameter auf „true“ festgelegt.

aws rds modify-db-parameter-group --db-parameter-group-name group-name \ --parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "

Protokollausdrücke von DB-Parametern

Sie können einen DB-Parameterwert, der eine Ganzzahl ist, auf einen Protokollausdruck festlegen. Sie schließen den Ausdruck in Klammern ein: {}. Zum Beispiel:

{log(DBInstanceClassMemory/8187281418)*1000}

Die log-Funktion repräsentiert die Protokollbasis 2. In diesem Beispiel wird auch die DBInstanceClassMemory-Formelvariable verwendet. Siehe DB-Parameter-Formel-Variablen.

Anmerkung

Derzeit können Sie den MySQL-Parameter innodb_log_file_size nicht mit einem anderen Wert als einer Ganzzahl angeben.

Beispiele für DB-Parameterwerte

Diese Beispiele zeigen die Verwendung von Formeln, Funktionen und Ausdrücken für die Werte von DB-Parametern.

Anmerkung

DB Parameter-Funktionen werden derzeit nur in der Konsole unterstützt und werden in der AWS CLI nicht unterstützt.

Warnung

Wenn die Parameter in einer DB-Parametergruppe unpassend eingestellt werden, kann dies unbeabsichtigte unerwünschte Auswirkungen haben. Dies kann eine gestörte Leistung und Systeminstabilität umfassen. Gehen Sie mit Bedacht vor, wenn Sie Datenbank-Parameter ändern und sichern Sie Ihre Daten bevor Sie Ihre DB-Parametergruppe ändern. Führen Sie Änderungen an einer Parametergruppe immer zuerst auf einer Test-DB-Instance aus, für die zeitpunktbezogene Wiederherstellungen vorhanden sind, bevor Sie diese Änderungen für eine Produktions-DB-Instance übernehmen.

Beispiel mit der DB-Parameter-Funktion GREATEST

Sie können die Funktion GREATEST in einem Oracle-Prozessparameter angeben. Verwenden Sie es, um die Anzahl der Benutzerprozesse auf größer als 80 oder DBInstanceClassMemory geteilt durch 9.868.951 einzustellen.

GREATEST({DBInstanceClassMemory/9868951},80)

Beispiel Verwenden der DB-Parameter-Funktion LEAST

Sie können die LEAST-Funktion in einem MySQL-max_binlog_cache_size-Parameter-Wert angeben. Verwenden Sie es, um die maximale Cachegröße, die bei einer Transaktion von einer MySQL-Instance belegt werden darf, auf den kleineren Wert von entweder 1 MB oder geteilt durch 256 festzu DBInstanceClass/256.

LEAST({DBInstanceClassMemory/256},10485760)