Konfiguration verwalten

Sie können eine benutzerdefinierte Konfiguration bearbeiten, eine Konfiguration kopieren, die Konfiguration eines DB-Systems aktualisieren oder zwei Konfigurationen vergleichen.

Benutzerdefinierte Konfiguration bearbeiten

Sie können den Namen, die Beschreibung und die Tags einer benutzerdefinierten Konfiguration bearbeiten. Sie können eine Standardkonfiguration nicht bearbeiten.

Konsole verwenden

Mit der Konsole können Sie eine benutzerdefinierte Konfiguration bearbeiten.

  1. Öffnen Sie das Navigationsmenü, und wählen Sie Datenbanken. Klicken Sie unter HeatWave MySQL auf Konfigurationen.
  2. Suchen Sie die benutzerdefinierte Konfiguration, die Sie bearbeiten möchten, und führen Sie einen der folgenden Schritte aus:
    • Klicken Sie im Menü "Aktionen" auf Bearbeiten, um das Dialogfeld Konfiguration bearbeiten zu öffnen.
    • Klicken Sie auf den Konfigurationsnamen, um die Seite Konfigurationsdetails zu öffnen, und klicken Sie auf Bearbeiten.
  3. Bearbeiten Sie im Dialogfeld Konfiguration bearbeiten den Konfigurationsnamen und die Beschreibung.
  4. (Optional) Wählen Sie Erweiterte Optionen anzeigen aus, um den Abschnitt Tags einzublenden. Sie können vorhandene Tags bearbeiten, zusätzliche Tags hinzufügen und unerwünschte Tags löschen.
  5. Klicken Sie auf Änderungen speichern.

Konfiguration kopieren

Sie können eine vorhandene benutzerdefinierte Konfiguration oder eine Standardkonfiguration kopieren und eine neue benutzerdefinierte Konfiguration erstellen.

Die neue benutzerdefinierte Konfiguration erbt die Ausprägung aus der kopierten Konfiguration. Wenn Sie eine benutzerdefinierte Konfiguration erstellen möchten, die High Availability-DB-Systeme unterstützt, müssen Sie sie aus einer vorhandenen Konfiguration kopieren, die High Availability unterstützt. Beispiel: Wenn Sie eine benutzerdefinierte Konfiguration für die Ausprägung MySQL.8 erstellen möchten, die High Availability unterstützt, können Sie sie aus der Datei MySQL.8 kopieren. HA-Konfiguration.

Kopieren Sie eine Konfiguration mit der Konsole oder einer Befehlszeilenschnittstelle.

Konsole verwenden

Verwenden Sie die Konsole, um eine Konfiguration zu kopieren.

  1. Öffnen Sie das Navigationsmenü, und wählen Sie Datenbanken. Klicken Sie unter HeatWave MySQL auf Konfigurationen.
  2. Klicken Sie auf das Menü "Aktionen" in derselben Zeile wie die Konfiguration, die Sie kopieren möchten, und wählen Sie Konfiguration kopieren aus.
  3. Geben Sie im Abschnitt Grundlegende Informationen für die Konfiguration angeben die folgenden Informationen ein:
    • Name: Geben Sie einen benutzerfreundlichen Anzeigenamen für die Konfiguration an. Der Name muss nicht eindeutig sein. Zur Identifizierung der Konfiguration wird eine eindeutige Oracle Cloud-ID (OCID) generiert.
    • Beschreibung: (Optional) Geben Sie eine Beschreibung für die Konfiguration an.
  4. Geben Sie im Abschnitt Platzierung und Hardware konfigurieren die folgenden Informationen ein:
    • Compartment auswählen: Wenn Sie die Konfiguration in einem anderen Compartment erstellen möchten, wählen Sie das gewünschte Compartment aus.
    • Ausprägung auswählen: Die Ausprägung kann in der Kopierkonfiguration nicht geändert werden.
  5. Im Abschnitt Initialisierungsvariablen können Sie Groß-/Kleinschreibung in Tabellen- und Schemanamen ignorieren auswählen, um die Groß-/Kleinschreibung bei Tabellen- und Schemanamen zu deaktivieren. Siehe Initialisierungsvariablen.
  6. Wählen Sie im Abschnitt Benutzervariablen (lesen/schreiben) in der Dropdown-Liste Variablennamen die Variable aus, die Sie bearbeiten möchten, und geben Sie den Variablenwert ein, oder wählen Sie ihn aus. Um eine Variable aus der Konfiguration zu löschen, wählen Sie das Kreuz (X) am Ende der Zeile aus. Um Ihrer Konfiguration eine weitere Variable hinzuzufügen, wählen Sie Variable +Another aus.
    Jede Konfiguration verfügt über ein Set von Standardbenutzervariablen. Wenn Sie keine Variable auswählen, fügt Oracle der Konfiguration diese Standardvariablen hinzu. Siehe Benutzervariablen.
    Hinweis

    Die Konsole rundet große Ganzzahlwerte, die von der Konfiguration gelesen werden, auf 16 wichtige Stellen. Beispiel: 9223372036854775807 wird auf 9223372036854776000 gerundet. Sie müssen den gerundeten Wert vorhandener Variablen korrigieren, die den Höchstwert überschreiten.
  7. Im Abschnitt Systemvariablen (schreibgeschützt) werden nicht bearbeitbare Systemvariablen angezeigt. Siehe Systemvariablen.
  8. (Optional) Wählen Sie Erweiterte Optionen anzeigen aus, um den Abschnitt Tags einzublenden. Sie können ein Tag hinzufügen, indem Sie einen Tag-Namespace auswählen und einen Tagschlüssel und den zugehörigen Tagwert eingeben. Wenn Sie ein weiteres Tag hinzufügen möchten, wählen Sie Tag hinzufügen aus, um eine weitere Zeile zu erstellen.
  9. (Optional) Um die Ressourcendefinition als Terraform-Konfiguration zu speichern, wählen Sie Als Stack speichern aus. Siehe Stack auf der Seite "Ressourcen erstellen" erstellen.
  10. Um die Konfiguration zu kopieren, wählen Sie Erstellen aus.
    Hinweis

    Nachdem Sie die Konfiguration erstellt haben, können Sie die in der Konfiguration definierten Variablen nicht mehr bearbeiten. Um Variablen zu bearbeiten, können Sie eine neue Konfiguration mit den gewünschten Variablen erstellen oder eine vorhandene Konfiguration kopieren und die Variablen entsprechend bearbeiten. Bearbeiten Sie anschließend das DB-System, um die neue Konfiguration zu verwenden. Siehe Konfiguration eines DB-Systems aktualisieren.

CLI verwenden

Kopieren Sie eine Konfiguration mit der Befehlszeilenschnittstelle.

Diese Aufgabe erfordert Folgendes:
  • Die Oracle Cloud-ID (OCID) des Compartments.
  • Die OCID einer vorhandenen Konfiguration, aus der kopiert werden soll.
  • Eine Policy, die Sie zum Erstellen von Konfigurationen im Compartment oder im Mandanten berechtigt.
  • Wenn Sie aus einer benutzerdefinierten Konfiguration kopieren, eine Policy, mit der Sie die benutzerdefinierte Konfiguration lesen können.
  • Eine ordnungsgemäß konfigurierte CLI-Installation und die erforderlichen SSH-Schlüssel. Siehe Befehlszeilenschnittstelle (CLI).
Kopieren Sie eine Konfiguration, um eine neue benutzerdefinierte Konfiguration mit der CLI zu erstellen:
  1. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:
    oci mysql configuration create 
         --compartment-id <CompartmentOCID>
         --parent-configuration-id <ConfigurationOCID>
         --description <Description>
         --display-name <DisplayName> 
         --shape-name <ShapeName> 
         --variables <JSONObject>
    • compartment-id: Geben Sie die OCID des Compartments an, mit dem die neue Konfiguration erstellt wird.
    • parent-configuration-id: Geben Sie die OCID der Konfiguration an, aus der kopiert werden soll.
    • description: (Optional) Geben Sie eine kurze Beschreibung der Konfiguration an.
    • display-name: (Optional) Geben Sie den Anzeigenamen der Konfiguration an. Wenn Sie keinen Anzeigenamen definieren, generiert Oracle einen Anzeigenamen im Format mysqlconfigurationYYYYMMDDHHMMSS.
    • shape-name: Geben Sie den Namen der Ausprägung an. Beispiel: MySQL.4.
      Hinweis

      Die Ausprägung muss der Ausprägung der übergeordneten Konfiguration entsprechen.
    • variables: (Optional) Geben Sie die Variablen und ihre entsprechenden Werte als Schlüsselwertpaare in einem JSON-Objekt an. Beispiel:
      { "autocommit": true, "connectTimeout": 20 } 
Wenn der Befehl erfolgreich validiert und ausgeführt wurde, erhalten Sie eine ähnliche Antwort wie im folgenden Beispiel. Dabei wird die Anforderung zusammenfasst und die Konfiguration erstellt:
{
  "data": {
    "compartment-id": "ocid1.compartment.oc1..longAlphanumericString",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "userName",
        "CreatedOn": "2024-07-11T00:51:53.856Z"
      }
    },
    "description": "This is a user defined descrption",
    "display-name": "ConfigName",
    "freeform-tags": {},
    "id": "ocid1.mysqlconfiguration.oc1.longAlphanumericString",
    "init-variables": {
      "lower-case-table-names": "CASE_SENSITIVE"
    },
    "lifecycle-state": "ACTIVE",
    "parent-configuration-id": "ocid1.mysqlconfiguration.oc1.longAlphanumericString",
    "shape-name": "MySQL.2",
    "time-created": "2024-07-11T00:51:53.866000+00:00",
    "time-updated": "2024-07-11T00:51:53.866000+00:00",
    "type": "CUSTOM",
    "variables": {
      "autocommit": true,
      "big-tables": null,
      "binlog-expire-logs-seconds": 3600,
      "binlog-row-metadata": null,
      "binlog-row-value-options": "PARTIAL_JSON",
      "binlog-transaction-compression": null,
      "completion-type": null,
      "connect-timeout": 20,
      "connection-memory-chunk-size": null,
      "connection-memory-limit": null,
      "cte-max-recursion-depth": null,
      "default-authentication-plugin": null,
      "foreign-key-checks": null,
      "generated-random-password-length": null,
      "global-connection-memory-limit": null,
      "global-connection-memory-tracking": null,
      "group-replication-consistency": "BEFORE_ON_PRIMARY_FAILOVER",
      "information-schema-stats-expiry": null,
      "innodb-buffer-pool-dump-pct": null,
      "innodb-buffer-pool-instances": 4,
      "innodb-buffer-pool-size": 9126805504,
      "innodb-ddl-buffer-size": null,
      "innodb-ddl-threads": null,
      "innodb-ft-enable-stopword": null,
      "innodb-ft-max-token-size": null,
      "innodb-ft-min-token-size": null,
      "innodb-ft-num-word-optimize": null,
      "innodb-ft-result-cache-limit": 33554432,
      "innodb-ft-server-stopword-table": null,
      "innodb-lock-wait-timeout": null,
      "innodb-log-writer-threads": null,
      "innodb-max-purge-lag": null,
      "innodb-max-purge-lag-delay": 300000,
      "innodb-stats-persistent-sample-pages": null,
      "innodb-stats-transient-sample-pages": null,
      "interactive-timeout": null,
      "local-infile": true,
      "mandatory-roles": "public",
      "max-allowed-packet": null,
      "max-binlog-cache-size": 4294967296,
      "max-connect-errors": null,
      "max-connections": 1000,
      "max-execution-time": null,
      "max-heap-table-size": null,
      "max-prepared-stmt-count": null,
      "mysql-firewall-mode": null,
      "mysql-zstd-default-compression-level": null,
      "mysqlx-connect-timeout": null,
      "mysqlx-deflate-default-compression-level": null,
      "mysqlx-deflate-max-client-compression-level": null,
      "mysqlx-document-id-unique-prefix": null,
      "mysqlx-enable-hello-notice": null,
      "mysqlx-idle-worker-thread-timeout": null,
      "mysqlx-interactive-timeout": null,
      "mysqlx-lz4-default-compression-level": null,
      "mysqlx-lz4-max-client-compression-level": null,
      "mysqlx-max-allowed-packet": null,
      "mysqlx-min-worker-threads": null,
      "mysqlx-read-timeout": null,
      "mysqlx-wait-timeout": null,
      "mysqlx-write-timeout": null,
      "mysqlx-zstd-default-compression-level": null,
      "mysqlx-zstd-max-client-compression-level": null,
      "net-read-timeout": null,
      "net-write-timeout": null,
      "parser-max-mem-size": null,
      "query-alloc-block-size": null,
      "query-prealloc-size": null,
      "regexp-time-limit": null,
      "sort-buffer-size": null,
      "sql-mode": null,
      "sql-require-primary-key": true,
      "sql-warnings": null,
      "thread-pool-dedicated-listeners": null,
      "thread-pool-max-transactions-limit": null,
      "time-zone": "UTC",
      "tmp-table-size": null,
      "transaction-isolation": null,
      "wait-timeout": null
    }
  },
  "etag": "longAlphanumericString"
}

Konfiguration eines DB-Systems aktualisieren

Sie können die Konfiguration eines DB-Systems auf eine vorhandene Konfiguration oder eine neu erstellte Konfiguration aktualisieren, um die Variableneinstellungen des DB-Systems zu ändern.

Wenn alle geänderten Variablen dynamisch sind, ist für das DB-System kein Neustart erforderlich, und es fallen keine Ausfallzeiten an.

Wenn eine oder mehrere nicht dynamische Variablen geändert werden, muss das DB-System neu gestartet werden.
  • Bei einem Standalone-DB-System tritt beim Neustart eine Ausfallzeit auf.
  • Ein High-Availability-DB-System führt bei einem rollierenden Neustart zu einer kurzen Ausfallzeit und einer Änderung der aktuellen primären Platzierung. Der rollierende Neustart verkürzt die Ausfallzeit und führt zu einer Änderung der aktuellen primären Platzierung des High-Availability-DB-Systems.
  • Wenn dem DB-System ein aktives HeatWave-Cluster zugeordnet ist, werden die Daten im HeatWave-Cluster automatisch neu geladen.
Mit der Konsole einer Befehlszeilenschnittstelle die Konfiguration eines DB-Systems aktualisieren:

Konsole verwenden

Mit der Konsole können Sie die Konfiguration eines DB-Systems aktualisieren.

Führen Sie die folgenden Schritte aus, um die Konfiguration eines DB-Systems zu aktualisieren:

  1. (Optional) Erstellen Sie eine neue Konfiguration. Siehe Benutzerdefinierte Konfiguration erstellen.
  2. Bearbeiten Sie das DB-System, um die Konfiguration zu aktualisieren. Siehe DB-System bearbeiten.
    Hinweis

    Sie können die Konfiguration nicht aktualisieren, wenn ein aktiver Kanal mit dem DB-System verbunden ist. Stoppen Sie den Kanal, um die Konfiguration zu aktualisieren.

CLI verwenden

Mit der Befehlszeilenschnittstelle (CLI) können Sie die Konfiguration eines DB-Systems aktualisieren.

Diese Aufgabe erfordert Folgendes:
  • Oracle Cloud-ID (OCID) des DB-Systems.
  • Eine HeatWave-Konfigurations-OCID.
  • Eine ordnungsgemäß konfigurierte CLI-Installation und die erforderlichen SSH-Schlüssel. Siehe Befehlszeilenschnittstelle (CLI).
  1. (Optional) Erstellen Sie eine neue Konfiguration. Siehe Benutzerdefinierte Konfiguration erstellen.
  2. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:
    oci mysql db-system update 
         --db-system-id <DBSystemOCID>
         --configuration-id <ConfigurationOCID>
    • db-system-id: Geben Sie die OCID des zu aktualisierenden DB-Systems an.
    • configuration-id: Geben Sie die OCID der Konfiguration an, mit der Sie die vorhandene Konfiguration ersetzen möchten.

Konfigurationen vergleichen

Vergleichen Sie die Ausprägungen, Initialisierungsvariablen und Benutzervariablen zweier Konfigurationen.

Hinweis

Dies ist ein Feature nur für die Konsole. Es gibt keinen entsprechenden CLI- oder REST-API-Befehl. Sie können die Details beider Konfigurationen anzeigen und die Ausgabe vergleichen.

Konsole verwenden

Verwenden Sie die Konsole, um zwei Konfigurationen zu vergleichen.

  1. Öffnen Sie das Navigationsmenü, und wählen Sie Datenbanken. Klicken Sie unter HeatWave MySQL auf Konfigurationen.
  2. Aktivieren Sie das Kontrollkästchen der beiden Konfigurationen, die Sie vergleichen möchten. Klicken Sie oben auf der Seite auf die Schaltfläche Aktionen, und klicken Sie dann auf Vergleichen.
  3. Klicken Sie im Bereich Konfigurationen vergleichen auf eine der folgenden Optionsschaltflächen:
    • Konfigurationsunterschiede anzeigen: Zeigt die Unterschiede in den Ausprägungen, Initialisierungsvariablen und Benutzervariablen an.
    • Alle Konfigurationsinformationen anzeigen: Zeigt alle Informationen der beiden Konfigurationen zu Ausprägungen, Initialisierungsvariablen und Benutzervariablen an.
  4. Klicken Sie auf Schließen.