Arbeiten mit DB-Cluster-Parametergruppen für Multi-AZ-DB-Cluster - 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-Cluster-Parametergruppen für Multi-AZ-DB-Cluster

Multi-AZ-DB-Cluster verwenden DB-Cluster-Parametergruppen. Die folgenden Abschnitte beschreiben das Konfigurieren und Verwalten von DB-Cluster-Parametergruppen.

Erstellen einer DB-Cluster-Parametergruppe

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

Nachdem Sie eine DB-Cluster-Parametergruppe erstellt haben, sollten Sie mindestens fünf Minuten warten, bevor Sie einen DB-Cluster erstellen, der diese DB-Cluster-Parametergruppe verwendet. Auf diese Weise kann Amazon RDS die Parametergruppe vollständig erstellen, bevor sie vom neuen DB-Cluster verwendet wird. Sie können die Seite Parametergruppen in der Amazon-RDS-Konsole oder den -describe-db-cluster-parametersBefehl verwenden, um zu überprüfen, ob Ihre DB-Cluster-Parametergruppe erstellt wurde.

Die folgenden Einschränkungen gelten für den Namen der DB-Cluster-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.aurora-mysql5.7. 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-Cluster-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 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 Typ die Option 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 (Erstellen) aus.

Verwenden Sie den Befehl , um eine DB-Cluster-Parametergruppe zu AWS CLI create-db-cluster-parameter-group erstellen.

Im folgenden Beispiel wird eine DB-Cluster-Parametergruppe mit dem Namen mydbclusterparametergroup für RDS for MySQL Version 8.0 und der Beschreibung „My new cluster 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, macOSoder Unix:

aws rds create-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family mysql8.0 \ --description "My new cluster parameter group"

Windows:

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

Die Ausgabe dieses Befehls sieht etwa so aus:

{ "DBClusterParameterGroup": { "DBClusterParameterGroupName": "mydbclusterparametergroup", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2" } }

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-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 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 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 (Writer-)DB-Instance im Cluster neu, um die Änderungen darauf anzuwenden.

  8. Starten Sie dann die Reader-DB-Instances neu, um die Änderungen auf sie anzuwenden.

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

  • --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, macOSoder 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"

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

Zurücksetzen von Parametern in einer DB-Cluster-Parametergruppe

Sie können Parameter in einer vom Kunden erstellten DB-Clusterparametergruppe auf ihre Standardwerte zurücksetzen. Änderungen an Parametern in einer benutzerdefinierten DB-Cluster-Parametergruppe gelten für alle DB-Cluster, die dieser DB-Cluster-Parametergruppe zugeordnet sind.

Anmerkung

In einer Standardparametergruppe des DB-Clusters werden die Parameter immer auf ihre Standardwerte eingestellt.

So setzen Sie Parameter in einer DB-Cluster-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).

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

Um Parameter in einer DB-Cluster-Parametergruppe auf ihre Standardwerte zurückzusetzen, verwenden Sie den AWS CLI reset-db-cluster-parameter-group Befehl mit der folgenden erforderlichen Option: --db-cluster-parameter-group-name.

Um alle Parameter in der Parametergruppe des DB-Clusters zurückzusetzen, wählen Sie die Option --reset-all-parameters. 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-cluster-parameter-group \ --db-cluster-parameter-group-name mydbparametergroup \ --reset-all-parameters

Windows:

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

Im folgenden Beispiel werden die Werte server_audit_logging und server_audit_logs_upload in der DB-Cluster-Parametergruppe mydbclusterparametergroup auf ihre Standardwerte zurückgesetzt.

Beispiel

Für Linux, macOSoder Unix:

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

Windows:

aws rds reset-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:

DBClusterParameterGroupName mydbclusterparametergroup

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

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

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 Befehl AWS CLI 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 einen DB-Cluster erstellen, der diese DB-Cluster-Parametergruppe verwendet. Auf diese Weise kann Amazon RDS die Parametergruppe vollständig kopieren, bevor sie vom neuen DB-Cluster verwendet wird. Sie können die Seite Parametergruppen in der Amazon-RDS-Konsole oder den -describe-db-cluster-parametersBefehl verwenden, um zu ü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.

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

So kopieren Sie eine DB-Cluster-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-Cluster-Parametergruppe zu kopieren, verwenden Sie den AWS CLI copy-db-cluster-parameter-group Befehl mit den folgenden erforderlichen Parametern:

  • --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, macOSoder 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"

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-Cluster-Parametergruppen

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

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

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

Beispiel

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

aws rds describe-db-cluster-parameter-groups

Im folgenden Beispiel wird die Parametergruppe mydbclusterparametergroup beschrieben.

Für Linux, macOSoder Unix:

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

Windows:

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

Die Ausgabe des Befehls ähnelt der Folgenden:

{ "DBClusterParameterGroups": [ { "DBClusterParameterGroupName": "mydbclusterparametergroup2", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup" } ] }

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

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

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

  • --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": [ { "ParameterName": "activate_all_roles_on_login", "ParameterValue": "0", "Description": "Automatically set all granted roles as active after the user has authenticated successfully.", "Source": "engine-default", "ApplyType": "dynamic", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": true, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot", "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

In einigen Fällen werden die zulässigen Werte für einen Parameter nicht angezeigt. Es handelt sich dabei immer um Parameter, bei denen die Quelle die Standardeinstellung der Datenbank-Engine ist.

Um die Werte dieser Parameter anzuzeigen, können Sie die folgenden SQL-Anweisungen ausführen:

  • MySQL:

    -- Show the value of a particular parameter mysql$ SHOW VARIABLES LIKE '%parameter_name%'; -- Show the values of all parameters mysql$ SHOW VARIABLES;
  • PostgreSQL:

    -- Show the value of a particular parameter postgresql=> SHOW parameter_name; -- Show the values of all parameters postgresql=> SHOW ALL;

Löschen einer DB-Cluster-Parametergruppe

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

So löschen Sie Parametergruppen
  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 Parametergruppen werden in einer Liste angezeigt.

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

  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-Cluster-Parametergruppe zu löschen, verwenden Sie den AWS CLI delete-db-cluster-parameter-group Befehl mit dem folgenden erforderlichen Parameter.

  • --db-parameter-group-name

Beispiel

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

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

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

  • DBParameterGroupName