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 marqueurs 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 Configuration.
  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 la 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 Marqueurs. Vous pouvez modifier des marqueurs existants, ajouter des marqueurs supplémentaires et supprimer les marqueurs 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 qui prend 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 voulez créer une configuration personnalisée pour la forme MySQL.8 qui prend en charge la haute disponibilité, vous pouvez la copier à partir de la page MySQL.8. Configuration haute disponibilité.

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 Configuration.
  2. Cliquez sur le menu Actions sur la même ligne que la configuration à copier, puis sélectionnez Copier la configuration.
  3. Dans la section Fournir des informations de base pour la configuration, entrez les informations suivantes :
    • Nom : Spécifiez un nom d'affichage convivial pour configuration. Il n'est pas nécessaire que ce nom soit unique. Un identificateur Oracle Cloud (OCID) unique est généré pour identifier la configuration.
    • Description : (Facultatif) Spécifiez une description pour la configuration.
  4. Dans la section Configurer le positionnement et le matériel, entrez les informations suivantes :
    • Sélectionner un compartiment : Pour créer la configuration dans un autre compartiment, sélectionnez le compartiment voulu.
    • 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. Voir Variables d'initialisation.
  6. Dans la section Variables d'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 l'intersection (X) à la fin de la rangée. Pour ajouter une autre variable à votre configuration, sélectionnez +Another Variable.
    Chaque configuration comporte un jeu de variables utilisateur par défaut. Si vous ne sélectionnez aucune variable, Oracle ajoute ces variables par défaut à la configuration. Voir Variables utilisateur.
    Note

    La console arrondit les valeurs entières volumineuses qu'elle lit dans 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 de système (en lecture seule) affiche les variables de système non modifiables. Voir Variables système.
  8. (Facultatif) Sélectionnez Afficher les options avancées pour développer la section Marqueurs. Vous pouvez ajouter un marqueur en sélectionnant un espace de noms de marqueur et en entrant une clé de marqueur et sa valeur de marqueur. Si vous voulez ajouter un autre marqueur, sélectionnez Ajouter un marqueur pour créer une autre rangée.
  9. (Facultatif) Pour enregistrer la définition de ressource en tant que configuration Terraform, sélectionnez Enregistrer en tant que pile. Voir Création d'une pile à partir d'une page de création de ressource.
  10. Pour copier la configuration, sélectionnez Créer.
    Note

    Une fois la configuration créée, vous ne pouvez pas modifier les variables définies dans la configuration. Pour modifier des variables, créez une nouvelle configuration avec les variables souhaitées, ou copiez une configuration existante, modifiez les variables, puis modifiez le système de base de données pour qu'il utilise la nouvelle configuration. Voir 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 nécessite les éléments suivants :
  • L'identificateur Oracle Cloud (OCID) de votre compartiment.
  • OCID d'une configuration existante à partir de laquelle effectuer la copie.
  • Politique qui vous permet de créer des configurations dans le compartiment ou la location.
  • Si vous copiez à partir d'une configuration personnalisée, politique qui vous permet de lire la configuration personnalisée.
  • Installation de l'interface de ligne de commande correctement configurée et clés SSH requises. Voir Interface de ligne de commande.
Copiez une configuration pour créer une nouvelle configuration personnalisée à l'aide de l'interface de ligne de commande :
  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 : Spécifiez l'OCID du compartiment utilisé pour créer la nouvelle configuration.
    • parent-configuration-id : Spécifiez l'OCID de la configuration à copier.
    • description : (Facultatif) Spécifiez une brève description de la configuration.
    • display-name : (Facultatif) Spécifiez 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 : Spécifiez le nom de la forme. Par exemple, MySQL.4.
      Note

      La forme doit être identique à la forme de la configuration parent.
    • variables : (Facultatif) Spécifiez 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 valide et s'exécute correctement, vous obtenez une réponse similaire à la suivante, qui résume 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 à 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'arrêt.

Si une ou plusieurs 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'arrêt lors du redémarrage.
  • Un système de base de données à haute disponibilité entraîne un bref temps d'arrêt et une modification du positionnement principal courant lors de l'exécution d'un redémarrage de repositionnement. Le redémarrage de repositionnement raccourcit le temps d'arrêt et entraîne une modification du positionnement principal courant du système de base de données à haute disponibilité.
  • Si une grappe HeatWave active est associée au système de base de données, les données de la grappe 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.

Effectuez les opérations suivantes pour mettre à jour la configuration d'un système de base de données :

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

    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 nécessite les éléments suivants :
  • Identificateur Oracle Cloud (OCID) d'un système de base de données.
  • OCID de la configuration HeatWave.
  • Installation de l'interface de ligne de commande correctement configurée et clés SSH requises. Voir Interface de ligne de commande.
  1. (Facultatif) Créez une configuration. Voir 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 : Spécifiez l'OCID du système de BD que vous voulez mettre à jour.
    • configuration-id : Spécifiez l'OCID de la configuration qui remplacera la configuration existante.

Comparaison des configurations

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

Note

Il s'agit d'une fonction Console uniquement, il n'y a pas d'interface de ligne de commande ou de commande d'API REST équivalentes. Vous pouvez consulter 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 Configuration.
  2. Cochez la case des deux configurations à comparer, cliquez sur le bouton Actions en haut de la page, puis cliquez sur Comparer.
  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 entre les formes, les variables d'initialisation et les 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.