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. Sur la page de liste Configuration, sélectionnez la configuration à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou la configuration, reportez-vous à Liste des configurations - Utilisation de la console.

    La page de détails s'ouvre et affiche des informations sur la configuration.

  2. Sélectionnez l'onglet Détails.
  3. Sélectionnez Modifier dans le champ Nom ou Description.
  4. Dans la boîte de dialogue Modifier la configuration, modifiez le nom et la description de la configuration.
  5. Sélectionnez 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. Sur la page de liste Configuration, sélectionnez la configuration à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou la configuration, reportez-vous à Liste des configurations - Utilisation de la console.

    La page de détails s'ouvre et affiche des informations sur la configuration.

  2. Sélectionnez Copier la configuration en haut de la page.
  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 Nom 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. Sur la page de liste Configurations, sélectionnez deux configurations à comparer. Si vous avez besoin d'aide pour trouver la page de liste ou la configuration, reportez-vous à Liste des configurations - Utilisation de la console.
  2. Dans le menu Actions en haut de la liste de configuration, sélectionnez Comparer.
  3. Dans le panneau Comparer la configuration, sélectionnez 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. Sélectionnez Fermer.

Suppression d'une configuration

Vous pouvez supprimer une configuration personnalisée qui n'est actuellement utilisée par aucun système de base de données.

Pour supprimer une configuration, utilisez la console, une interface de ligne de commande ou l'API REST.

Utilisation de la console

Pour supprimer une configuration personnalisée, utilisez la console.

Cette tâche requiert les éléments suivants :
  • La configuration personnalisée à supprimer n'est utilisée par aucun système de base de données.
  • Stratégie vous permettant de supprimer des configurations dans le compartiment ou de la location.
Pour supprimer une configuration personnalisée à l'aide de la console, procédez comme suit :
  1. Sur la page de liste Configurations, recherchez la configuration à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou la configuration, reportez-vous à Liste des configurations - Utilisation de la console.
  2. Dans le menu Actions de la configuration, sélectionnez Supprimer.
  3. A l'invite, confirmez la suppression.

Utilisation de l'interface de ligne de commande

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

Cette tâche requiert les éléments suivants :
  • OCID d'une configuration HeatWave qui n'est utilisée par aucun système de base de données.
  • Stratégie vous permettant de supprimer des configurations dans le compartiment ou de la location.
  • Interface de ligne de commande installée et correctement configurée, et clés SSH requises. Reportez-vous à Interface de ligne de commande.
Supprimez une configuration à l'aide de la CLI :
  1. Ouvrez une invite de commande et exécutez la commande suivante :
    oci mysql configuration delete 
         --configuration-id <ConfigurationOCID>
    • configuration-id : indiquez l'OCID de la configuration à supprimer.