Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen - Amazon Aurora

Arbeiten mit DB-Parametergruppen und DB-Cluster-Parametergruppen

Sie können Ihre DB-Engine-Konfiguration verwalten, indem Sie Ihre DB-Instances und Aurora-DB-Cluster zu Parametergruppen zuordnen. Amazon RDS definiert Parametergruppen mit Standardeinstellungen, die auf neu erstellte DB-Instances und Aurora-Cluster angewendet werden.

Wichtig

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

Informationen zum Ändern eines DB-Clusters oder einer DB-Instance finden Sie unter Ändern eines Amazon Aurora-DB-Clusters.

Eine DB-Parametergruppe dient als Container für Engine-Konfigurationswerte, die auf eine oder mehr DB-Instance angewendet werden. DB-Parametergruppen gelten für DB-Instances in Amazon RDS und Aurora. Diese Konfigurationseinstellungen gelten für Eigenschaften, die je nach DB-Instances in einem Aurora-Cluster unterschiedlich sein können, z. B. Größe der Speicherpuffer.

Eine DB-Cluster-Parametergruppe dient als Container für Engine-Konfigurationswerte, die auf jede DB-Instance in einem Aurora-DB-Cluster angewendet werden. Das freigegebene Aurora-Speichermodell erfordert, dass jede DB-Instance in einem Aurora-Cluster dieselbe Einstellung für Parameter wie innodb_file_per_table verwendet. Daher sind Parameter, die sich auf das Layout des physischen Speichers auswirken, Teil der Cluster-Parametergruppe. Die DB-Cluster-Parametergruppe enthält auch Standardwerte für alle Parameter auf Instance-Ebene.

Wenn Sie eine DB-Instance ohne Angabe einer DB-Parametergruppe erstellen, verwendet die DB-Instance eine Standard-DB-Parametergruppe. Beim Erstellen eines Aurora-DB-Clusters ohne Angabe einer DB-Cluster-Parametergruppe verwendet der DB-Cluster ebenso eine Standard-DB-Cluster-Parametergruppe. Jede Standard-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 oder Ihren DB-Cluster, 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. Wenn Sie Parameter innerhalb einer DB-Cluster-Parametergruppe aktualisieren, gelten die Änderungen ebenso für alle Aurora-Cluster, die dieser DB-Cluster-Parametergruppe zugeordnet sind.

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

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

  • Wenn Sie einen dynamischen Parameter ändern und die 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 über die RDS-Konsole oder durch den expliziten Aufruf der API-Operation RebootDbInstance neu starten (ohne Failover, wenn sich die DB-Instance in einer Multi-AZ-Bereitstellung befindet). 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 eines Amazon Aurora-DB-Clusters.

    Anmerkung

    Nachdem Sie die DB-Clusterparametergruppe geändert haben, die einem DB-Cluster zugeordnet ist, starten Sie die primäre DB-Instance im Cluster neu, um die Änderungen auf alle DB-Instances im Cluster anzuwenden.

  • Sie können den Wert für einen 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 DB-Parameterwerte.

  • 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-Datenbank ä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 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 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.

  • Für eine globale Aurora-Datenbank können Sie verschiedene Konfigurationseinstellungen für die einzelnen Aurora-Cluster festlegen. Wenn Sie einen sekundären Cluster zum primären Cluster hochstufen, müssen die Einstellungen in ausreichendem Umfang ähnlich sein, um ein einheitliches Verhalten zu erzeugen. Verwenden Sie beispielsweise die gleichen Einstellungen für Zeitzonen und Zeichensätze für alle Cluster einer globalen Aurora-Datenbank.

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

Amazon Aurora-DB-Cluster und DB-Instance-Parameter

Aurora verwendet wie folgt ein Zwei-Level-System von Konfigurationseinstellungen:

  • Parameter in einer DB-Cluster-Parametergruppe werden auf jede DB-Instance in einem DB-Cluster angewandt. Ihre Daten werden im freigegebenen Aurora-Speicher-Subsystem gespeichert. Daher müssen alle Parameter, die sich auf das physische Layout von Tabellendaten beziehen, bei allen DB-Instances in einem Aurora-Cluster gleich sein. Da Aurora-DB-Instances durch Replikation verbunden sind, müssen alle Parameter für Replikationseinstellungen innerhalb eines Aurora-Clusters ebenfalls identisch sein.

  • Parameter in einer DB-Parametergruppe werden auf eine einzelne DB-Instance in einem Aurora-DB-Cluster angewandt. Diese Parameter beziehen sich auf Aspekte wie die Speichernutzung, die Sie über die DB-Instances in demselben Aurora-Cluster hinweg unterschiedlich einstellen können. Ein Cluster enthält beispielsweise oft DB-Instances mit verschiedenen AWS-Instance-Klassen.

Jeder Aurora-Cluster ist einer DB-Cluster-Parametergruppe zugeordnet. Jede DB-Instance im Cluster übernimmt die Einstellungen von dieser DB-Cluster-Gruppe und wird einer DB-Parametergruppe zugeordnet. Wenn Sie einen Cluster oder eine neue DB-Instance erstellen, weist Aurora Standard-Parametergruppen basierend auf der angegebenen Datenbank-Engine und -Version zu. Sie können die Parametergruppen zu einem späteren Zeitpunkt in von Ihnen erstellte ändern, bei denen Sie die Parameterwerte bearbeiten können.

Die DB-Cluster-Parametergruppen enthalten auch Standardwerte für alle Parameter auf Instance-Ebene aus der DB-Parametergruppe. Diese Standardwerte sind hauptsächlich für die Konfiguration von Aurora Serverless-Clustern vorgesehen, die nur DB-Cluster-Parametergruppen, nicht DB-Parametergruppen, zugeordnet sind. In der DB-Cluster-Parametergruppe können Sie die Parametereinstellungen auf Instance-Ebene ändern. Aurora wendet diese Einstellungen dann auf jede neue DB-Instance an, die zu einem Serverless-Cluster hinzugefügt wird. Weitere Informationen zu Konfigurationseinstellungen für Aurora Serverless-Cluster und welche Einstellungen Sie ändern können, finden Sie unter Aurora Serverless und Parametergruppen.

Bei Nicht-Serverless-Clustern überschreiben alle Konfigurationswerte, die Sie in der DB-Cluster-Parametergruppe ändern, die Standardwerte in der DB-Parametergruppe. Wenn Sie die entsprechenden Werte in der DB-Parametergruppe bearbeiten, überschreiben diese Werte die Einstellungen aus der DB-Cluster-Parametergruppe.

Alle von Ihnen geänderten DB-Parameter-Einstellungen haben Vorrang vor den Werten der DB-Cluster-Parametergruppe. Dies gilt selbst dann, wenn Sie die Konfigurationsparameter wieder auf deren Standardwerte zurücksetzen. Mithilfe des AWS CLI-Befehls describe-db-parameters oder der RDS-API DescribeDBParameters können Sie anzeigen, welche Parameter überschrieben werden. Das Feld Source enthält den Wert user, wenn Sie diesen Parameter geändert haben. Um einen oder mehrere Parameter zurückzusetzen, sodass dem Wert der DB-Cluster-Parametergruppe Vorrang gegeben wird, verwenden Sie den AWS CLI-Befehl reset-db-parameter-group oder die RDS-API-Operation ResetDBParameterGroup.

Die Parameter des DB-Clusters und der DB-Instance, die Ihnen in Aurora zur Verfügung stehen, variieren je nach Kompatibilität der Datenbank-Engine.

Datenbank-Engine Parameter

Aurora MySQL

Siehe Aurora MySQL parameters.

Für Aurora Serverless-Cluster finden Sie weitere Einzelheiten unter Aurora Serverless und Parametergruppen.

Aurora PostgreSQL

Siehe Amazon Aurora PostgreSQL parameters.

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 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 aurora5.6 \ --description "My new parameter group"

Für Windows:

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

Die Ausgabe dieses Befehls sieht etwa so aus:

DBPARAMETERGROUP mydbparametergroup aurora5.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

Erstellen einer DB-Cluster-Parametergruppe

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

So erstellen Sie eine DB-Cluster-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 Cluster Parameter Group (DB-Cluster-Parametergruppe) aus.

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

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

  8. Wählen Sie Create aus.

Verwenden Sie den AWS CLI-Befehl create-db-cluster-parameter-group zum Erstellen einer DB-Cluster-Parametergruppe. Im folgenden Beispiel wird eine DB-Cluster-Parametergruppe mit dem Namen mydbclusterparametergroup für MySQL Version 5.6 und der Beschreibung „My new parameter group“ erstellt.

Nutzen Sie die folgenden erforderlichen Parameter:

  • --db-cluster-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-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family aurora5.6 \ --description "My new cluster parameter group"

Für Windows:

aws rds create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --db-parameter-group-family aurora5.6 ^ --description "My new cluster parameter group"

Die Ausgabe dieses Befehls sieht etwa so aus:

DBCLUSTERPARAMETERGROUP mydbclusterparametergroup mysql5.6 My cluster new parameter group

Um eine DB-Cluster-Parametergruppe zu erstellen, verwenden Sie die RDS-API-Aktion CreateDBClusterParameterGroup.

Nutzen Sie die folgenden erforderlichen Parameter:

  • DBClusterParameterGroupName

  • DBParameterGroupFamily

  • Description

Ä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

Um eine DB-Parametergruppe zu ändern, verwenden Sie den RDS-API-Befehl ModifyDBParameterGroup mit den folgenden erforderlichen Parametern:

  • DBParameterGroupName

  • Parameters

Ändern von Parametern in einer DB-Cluster-Parametergruppe

Sie können Parameterwerte in einer vom Kunden erstellten DB-Clusterparametergruppe ändern. Sie können die Parameterwerte in einer Standard-DB-Clusterparametergruppe nicht ändern. Änderungen an Parametern in einer benutzerdefinierten DB-Cluster-Parametergruppe gelten für alle DB-Cluster, die dieser DB-Cluster-Parametergruppe zugeordnet sind.

So ändern Sie eine DB-Cluster-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 die Werte der Parameter, die Sie ändern möchten. 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.

  7. Starten Sie die primäre DB-Instance im Cluster neu, um die Änderungen auf alle DB-Instances in dem Cluster anzuwenden.

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

  • --db-cluster-parameter-group-name

  • --parameters

Im folgenden Beispiel werden die Werte server_audit_logging und server_audit_logs_upload in der DB-Cluster-Parametergruppe mydbclusterparametergroup geändert.

Beispiel

Für Linux, macOS oder Unix:

aws rds modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Für Windows:

aws rds modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Die Ausgabe des Befehls ähnelt der Folgenden:

DBCLUSTERPARAMETERGROUP mydbclusterparametergroup

Um eine DB-Cluster-Parametergruppe zu ändern, verwenden Sie den RDS-API-Befehl ModifyDBClusterParameterGroup mit den folgenden erforderlichen Parametern:

  • DBClusterParameterGroupName

  • Parameters

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 (Kopieren) aus.

Verwenden Sie den Befehl AWS CLI copy-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

Kopieren einer DB-Cluster-Parametergruppe

Sie können die von Ihnen erstellten benutzerdefinierten DB-Cluster-Parametergruppen kopieren. Das Kopieren einer Parametergruppe ist eine praktische Lösung, wenn Sie bereits eine DB-Cluster-Parametergruppe erstellt haben und die am häufigsten verwendeten Parameter und Werte aus dieser Gruppe in eine neuen DB-Cluster-Parametergruppe übernehmen möchten. Sie können eine DB-Cluster-Parametergruppe mit dem AWS CLI-Befehl copy-db-cluster-parameter-group oder der RDS-API-Operation CopyDBClusterParameterGroup kopieren.

Nachdem Sie eine DB-Cluster-Parametergruppe kopiert haben, warten Sie mindestens fünf Minuten, bevor Sie den ersten DB-Cluster erstellen, der diese DB-Cluster-Parametergruppe als Standard-Parametergruppe verwendet. So kann der Kopiervorgang in Amazon RDS abgeschlossen werden, bevor die Parametergruppe als Standard für einen neuen DB-Cluster verwendet wird. Mithilfe der Option Parameter Groups (Parametergruppen) in der Amazon RDS-Konsole oder mithilfe des Befehls describe-db-cluster-parameters können Sie überprüfen, ob Ihre DB-Cluster-Parametergruppe erstellt wurde.

Anmerkung

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

So kopieren Sie eine DB-Cluster-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 (Kopieren) aus.

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

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

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

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

Im folgenden Beispiel wird eine neue DB-Cluster-Parametergruppe mit dem Namen mygroup2 als Kopie der DB-Cluster-Parametergruppe mygroup1 erstellt.

Beispiel

Für Linux, macOS oder Unix:

aws rds copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier mygroup1 \ --target-db-cluster-parameter-group-identifier mygroup2 \ --target-db-cluster-parameter-group-description "DB parameter group 2"

Für Windows:

aws rds copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier mygroup1 ^ --target-db-cluster-parameter-group-identifier mygroup2 ^ --target-db-cluster-parameter-group-description "DB parameter group 2"

Um eine DB-Cluster-Parametergruppe zu kopieren, verwenden Sie die RDS-API-Operation CopyDBClusterParameterGroup mit den folgenden erforderlichen Parametern:

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

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

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

Auflisten von DB-Cluster-Parametergruppen

Sie können die DB-Cluster-Parametergruppen, die Sie für Ihr AWS-Konto erstellt haben, in einer Liste anzeigen.

Anmerkung

Standardparametergruppen werden automatisch aus einer Standardparametervorlage generiert, wenn Sie ein DB-Cluster 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 zeigen Sie alle DB-Cluster-Parametergruppen für ein AWS-Konto in einer Liste an

  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 DB-Cluster-Parametergruppen erscheinen in der Liste mit DB cluster parameter group (DB-Cluster-Parametergruppe) als Type (Typ).

Verwenden Sie den AWS CLI-Befehl describe-db-cluster-parameter-groups, um alle DB-Cluster-Parametergruppen für ein AWS-Konto auflisten zu lassen.

Beispiel

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

aws rds describe-db-cluster-parameter-groups

Die Ausgabe des Befehls ähnelt der Folgenden:

DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:default.aurora5.6 default.aurora5.6 aurora5.6 Default cluster parameter group for aurora5.6 DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group

Im folgenden Beispiel wird die Parametergruppe mydbclusterparametergroup beschrieben.

Für Linux, macOS oder Unix:

aws rds describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name mydbclusterparametergroup

Für Windows:

aws rds describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name mydbclusterparametergroup

Die Ausgabe des Befehls ähnelt der Folgenden:

DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group

Verwenden Sie die RDS-API-Aktion DescribeDBClusterParameterGroups, um alle DB-Cluster-Parametergruppen für ein AWS-Konto in einer Liste anzuzeigen.

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

Anzeigen der Parameterwerte für eine DB-Cluster-Parametergruppe

Sie können alle Parameter in einer DB-Cluster-Parametergruppe mit ihren Werten in einer Liste anzeigen.

So zeigen Sie die Parameterwerte für eine DB-Cluster-Parametergruppe an

  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 DB-Cluster-Parametergruppen erscheinen in der Liste mit DB cluster parameter group (DB-Cluster-Parametergruppe) als Type (Typ).

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

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

  • --db-cluster-parameter-group-name

Beispiel

Das folgende Beispiel listet die Parameter und Parameterwerte für eine DB-Cluster-Parametergruppe namens mydbclusterparametergroup im JSON-Format auf.

Die Ausgabe des Befehls ähnelt der Folgenden:

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
{ "Parameters": [ { "ApplyMethod": "pending-reboot", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "DataType": "boolean", "AllowedValues": "0,1", "SupportedEngineModes": [ "provisioned" ], "Source": "engine-default", "IsModifiable": false, "ParameterName": "allow-suspicious-udfs", "ApplyType": "static" }, { "ApplyMethod": "pending-reboot", "Description": "Enables new features in the Aurora engine.", "DataType": "boolean", "IsModifiable": true, "AllowedValues": "0,1", "SupportedEngineModes": [ "provisioned" ], "Source": "engine-default", "ParameterValue": "0", "ParameterName": "aurora_lab_mode", "ApplyType": "static" }, ...

Das folgende Beispiel listet die Parameter und Parameterwerte für eine DB-Cluster-Parametergruppe namens mydbclusterparametergroup im Klartextformat auf.

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup --output text

Die Ausgabe des Befehls ähnelt der Folgenden:

PARAMETERS 0,1 pending-reboot static boolean Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded False allow-suspicious-udfs engine-default SUPPORTEDENGINEMODES provisioned PARAMETERS 0,1 pending-reboot static boolean Enables new features in the Aurora engine. True aurora_lab_mode 0 engine-default SUPPORTEDENGINEMODES provisioned ...

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

  • DBClusterParameterGroupName

Vergleichen von -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.

DB-Parameterwerte

Sie können für einen DB-Parameter einen beliebigen der folgenden Werte angeben:

  • Eine Konstante mit Ganzzahl

  • Eine DB-Parameter-Formel

  • Eine DB-Parameter-Funktion

  • Eine Konstante mit einer Zeichenfolge

  • Ein Logarithmus-Ausdruck (die Logarithmus-Funktion ist ein Logarithmus zur Basis 2) wie z. B. value={log(DBInstanceClassMemory/8187281418)*1000}

DB-Parameter-Formeln

Eine DB-Parameterformel ist ein Ausdruck, der in einen Ganzzahlwert oder einen booleschen Wert aufgelöst wird und in geschweiften Klammern steht: {}. Sie können Formeln entweder für einen DB-Parameterwert oder als Argument für eine DB-Parameterfunktion angeben.

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 die Größe des Volumens in Byte zurück.

DBInstanceClassMemory

Gibt 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 Amazon RDS-Vorgängen für die Verwaltung der Instance verwendet wird.

Endpunkt-Port

Gibt die Anzahl der für die Verbindung mit der DB-Instance verwendeten Ports zurück.

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

Der Wert für einen DB-Parametern kann wie folgt festgelegt werden: Jede Funktion muss mindestens ein Argument haben. Mehrere Argumente können als eine kommagetrennte Liste angegeben werden. Die Liste darf keine leeren Elemente aufweisen, z. B. argument1,,argument3. Bei Funktionsnamen wird zwischen Groß- und Kleinschreibung unterschieden.

Anmerkung

DB-Parameterfunktionen werden in der AWS CLI derzeit nicht unterstützt.

IF()

Gibt ein Argument zurück.

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.

Beispiele für DB-Parameterwerte

In diesen Beispielen wird die Verwendung von Formeln und Funktionen in den Werten für DB-Parameter veranschaulicht.

Warnung

Wenn die Parameter in einer DB-Parametergruppe unpassend eingestellt werden, kann dies unbeabsichtigte unerwünschte Auswirkungen haben, einschließlich verminderter Leistung und Systeminstabilität. Gehen Sie immer 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.

Sie können die LEAST()-Funktion in einem Aurora MySQL-table_definition_cache-Parameterwert angeben, um die Anzahl der Tabellendefinitionen, die im Definitionscache gespeichert werden können, auf den kleineren Wert von DBInstanceClassMemory geteilt durch 393 040 oder 20 000 festzulegen.

LEAST({DBInstanceClassMemory/393040}, 20000)