Gestion d'une configuration

Vous pouvez modifier une configuration personnalisée, copier une configuration, mettre à jour la configuration d'un système de base de données ou comparer deux configurations.

Modification d'une configuration personnalisée

Vous pouvez modifier le nom, la description et les balises d'une configuration personnalisée. Vous ne pouvez pas modifier une configuration par défaut.

Utilisation de la console

Utilisez la console pour modifier une configuration personnalisée.

  1. Ouvrez le menu de navigation et sélectionnez Bases de données. Sous HeatWave MySQL, cliquez sur Configurations.
  2. Localisez la configuration personnalisée à modifier et effectuez l'une des opérations suivantes :
    • Cliquez sur le menu Actions et sélectionnez Modifier pour ouvrir la boîte de dialogue Modifier la configuration.
    • Cliquez sur le nom de la configuration pour ouvrir la page Détails de configuration et cliquez sur Modifier.
  3. Dans la boîte de dialogue Modifier la configuration, modifiez le nom et la description de la configuration.
  4. (Facultatif) Sélectionnez Afficher les options avancées pour développer la section Balises. Vous pouvez modifier des balises existantes, ajouter des balises supplémentaires et supprimer des balises indésirables.
  5. Cliquez sur Enregistrer les modifications.

Copie d'une configuration

Vous pouvez copier une configuration personnalisée existante ou une configuration par défaut et créer une configuration personnalisée.

La nouvelle configuration personnalisée hérite de la forme de la configuration copiée. Si vous voulez créer une configuration personnalisée prenant en charge les systèmes de base de données haute disponibilité, vous devez la copier à partir d'une configuration existante prenant en charge la haute disponibilité. Par exemple, si vous souhaitez créer une configuration personnalisée pour la forme MySQL.8 prenant en charge la haute disponibilité, vous pouvez effectuer une copie à partir de MySQL.8. Configuration HA.

Utilisez la console ou une interface de ligne de commande pour copier une configuration.

Utilisation de la console

Utilisez la console pour copier une configuration.

  1. Ouvrez le menu de navigation et sélectionnez Bases de données. Sous HeatWave MySQL, cliquez sur Configurations.
  2. Cliquez sur le menu Actions figurant sur la ligne de la configuration à copier et sélectionnez Copier la configuration.
  3. Dans la section Fournir les informations de base pour la configuration, entrez les informations suivantes :
    • Nom : indiquez un nom d'affichage convivial pour la configuration. Le nom ne doit pas nécessairement être unique. Un OCID (identificateur Oracle Cloud) unique est généré pour identifier la configuration.
    • Description : (facultatif) indiquez une description pour la configuration.
  4. Dans la section Configurer le placement et le matériel, entrez les informations suivantes :
    • Sélectionner un compartiment : pour créer la configuration dans un autre compartiment, sélectionnez ce dernier.
    • Sélectionner une forme : la forme ne peut pas être modifiée dans la configuration de copie.
  5. Dans la section Variables d'initialisation, vous pouvez sélectionner Ignorer la casse dans les noms de table et de schéma pour désactiver la sensibilité à la casse des noms de table et de schéma. Reportez-vous à Variables d'initialisation.
  6. Dans la section Variables utilisateur (lecture/écriture), sélectionnez la variable à modifier dans la liste déroulante Noms de variable, puis entrez ou sélectionnez la valeur de variable. Pour supprimer une variable de la configuration, sélectionnez la croix (X) à la fin de la ligne. Pour ajouter une autre variable à la configuration, sélectionnez +Another Variable.
    Chaque configuration comporte un ensemble de variables utilisateur par défaut. Si vous ne sélectionnez aucune variable, Oracle ajoute ces variables par défaut à la configuration. Reportez-vous à Variables utilisateur.
    Remarque

    La console arrondit les valeurs entières volumineuses lues à partir de la configuration à 16 chiffres significatifs. Par exemple, 9223372036854775807 est arrondi à 9223372036854776000. Vous devez corriger la valeur arrondie des variables existantes qui dépassent la valeur maximale.
  7. La section Variables système (en lecture seule) affiche les variables système non modifiables. Reportez-vous à Variables système.
  8. (Facultatif) Sélectionnez Afficher les options avancées pour développer la section Balises. Vous pouvez ajouter une balise en sélectionnant un espace de noms de balise, puis en saisissant une clé de balise et sa valeur de balise. Si vous voulez ajouter une autre balise, sélectionnez Ajouter une balise pour créer une autre ligne.
  9. (Facultatif) Pour enregistrer la définition de ressource en tant que configuration Terraform, sélectionnez Enregistrer en tant que pile. Reportez-vous à Création d'une pile à partir d'une page de création de ressource.
  10. Pour copier la configuration, sélectionnez Créer.
    Remarque

    Une fois la configuration créée, vous ne pouvez plus modifier les variables qui y sont définies. Pour modifier des variables, créez une configuration avec les variables souhaitées, ou copiez une configuration existante et modifiez les variables, puis modifiez le système de base de données afin qu'il utilise la nouvelle configuration. Reportez-vous à Mise à jour de la configuration d'un système de base de données.

Utilisation de l'interface de ligne de commande

Utilisez l'interface de ligne de commande pour copier une configuration.

Cette tâche requiert les éléments suivants :
  • Identificateur Oracle Cloud (OCID) de votre compartiment.
  • OCID d'une configuration existante à partir de laquelle effectuer la copie.
  • Stratégie vous permettant de créer des configurations dans le compartiment ou la location.
  • Si vous effectuez une copie à partir d'une configuration personnalisée, stratégie qui vous permet de lire la configuration personnalisée.
  • Interface de ligne de commande installée et correctement configurée, et clés SSH requises. Reportez-vous à Interface de ligne de commande.
Copiez une configuration pour créer une configuration personnalisée à l'aide de la CLI :
  1. Ouvrez une invite de commande et exécutez la commande suivante :
    oci mysql configuration create 
         --compartment-id <CompartmentOCID>
         --parent-configuration-id <ConfigurationOCID>
         --description <Description>
         --display-name <DisplayName> 
         --shape-name <ShapeName> 
         --variables <JSONObject>
    • compartment-id : indiquez l'OCID du compartiment utilisé pour créer la configuration.
    • parent-configuration-id : indiquez l'OCID de la configuration à partir de laquelle effectuer la copie.
    • description : (facultatif) indiquez une brève description de la configuration.
    • display-name : (facultatif) indiquez le nom d'affichage de la configuration. Si vous ne définissez pas de nom d'affichage, Oracle en génère un pour vous au format mysqlconfigurationYYYYMMDDHHMMSS.
    • shape-name : indiquez le nom de la forme. Par exemple, MySQL.4.
      Remarque

      La forme doit être identique à la forme de la configuration parent.
    • variables : (facultatif) indiquez les variables et leurs valeurs correspondantes en tant que paires clé/valeur dans un objet JSON, par exemple :
      { "autocommit": true, "connectTimeout": 20 } 
Si la commande est validée et exécutée, vous obtenez une réponse semblable à la suivante, qui synthétise la demande et crée la configuration :
{
  "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"
}

Mise à jour de la configuration d'un système de base de données

Vous pouvez mettre à jour la configuration d'un système de base de données vers une configuration existante ou une configuration nouvellement créée pour modifier les paramètres de variable du système de base de données.

Si toutes les variables modifiées sont dynamiques, le système de base de données ne nécessite pas de redémarrage et aucun temps d'inactivité n'est généré.

Si des variables non dynamiques sont modifiées, le système de base de données doit être redémarré.
  • Un système de base de données autonome entraîne un temps d'inactivité lors du redémarrage.
  • Un système de base de données haute disponibilité entraîne un bref temps d'inactivité et une modification de l'emplacement principal en cours lors d'un redémarrage non simultané. Le redémarrage non simultané réduit le temps d'inactivité et entraîne une modification de l'emplacement principal en cours du système de base de données haute disponibilité.
  • Si un cluster HeatWave actif est attaché au système de base de données, les données du cluster HeatWave sont rechargées automatiquement.
Utilisez la console d'une interface de ligne de commande pour mettre à jour la configuration d'un système de base de données :

Utilisation de la console

Utilisez la console pour mettre à jour la configuration d'un système de base de données.

Pour mettre à jour la configuration d'un système de base de données, procédez comme suit :

  1. (Facultatif) Créez une configuration. Reportez-vous à Création d'une configuration personnalisée.
  2. Modifiez le système de base de données pour mettre à jour la configuration. Reportez-vous à Modification d'un système de base de données.
    Remarque

    Vous ne pouvez pas mettre à jour la configuration si un canal actif est connecté au système de base de données. Arrêtez le canal pour mettre à jour la configuration.

Utilisation de l'interface de ligne de commande

Utilisez l'interface de ligne de commande pour mettre à jour la configuration d'un système de base de données.

Cette tâche requiert les éléments suivants :
  • Identificateur Oracle Cloud (OCID) de système de base de données.
  • OCID de configuration HeatWave.
  • Interface de ligne de commande installée et correctement configurée, et clés SSH requises. Reportez-vous à Interface de ligne de commande.
  1. (Facultatif) Créez une configuration. Reportez-vous à Création d'une configuration personnalisée.
  2. Ouvrez une invite de commande et exécutez la commande suivante :
    oci mysql db-system update 
         --db-system-id <DBSystemOCID>
         --configuration-id <ConfigurationOCID>
    • db-system-id : indiquez l'OCID du système de base de données à mettre à jour.
    • configuration-id : indiquez l'OCID de la configuration par laquelle remplacer la configuration existante.

Comparaison de configurations

Comparez les formes, les variables d'initialisation et les variables utilisateur de deux configurations.

Remarque

Il s'agit d'une fonctionnalité de console uniquement, il n'existe aucune commande d'interface de ligne de commande ou d'API REST équivalente. Vous pouvez visualiser les détails des deux configurations et comparer la sortie.

Utilisation de la console

Utilisez la console pour comparer deux configurations.

  1. Ouvrez le menu de navigation et sélectionnez Bases de données. Sous HeatWave MySQL, cliquez sur Configurations.
  2. Cochez la case des deux configurations à comparer, cliquez sur le bouton Actions en haut de la page, puis cliquez sur Comparaison.
  3. Dans le panneau Comparer les configurations, cliquez sur l'un des boutons d'option suivants :
    • Afficher les différences de configuration : affiche les différences au niveau des formes, des variables d'initialisation et des variables utilisateur.
    • Afficher toutes les informations de configuration : affiche toutes les informations relatives aux formes, aux variables d'initialisation et aux variables utilisateur des deux configurations.
  4. Cliquez sur Fermer.