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. Dans 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, voir Configuration de la liste - 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 Edit (Modifier) dans le champ Name (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 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. Dans 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, voir Configuration de la liste - 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 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 Copier.
  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 Nom de la 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. Dans 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, voir 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 les configurations, sélectionnez 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. 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.

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

Utilisation de la console

Utilisez la console pour supprimer une configuration personnalisée.

Cette tâche nécessite les éléments suivants :
  • La configuration personnalisée à supprimer n'est utilisée par aucun système de base de données.
  • Politique qui vous permet de supprimer des configurations dans le compartiment ou la location.
Effectuez les opérations suivantes pour supprimer une configuration personnalisée à l'aide de la console :
  1. Dans la page de liste Configurations, recherchez la configuration avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la configuration, voir Liste des configurations - Utilisation de la console.
  2. Dans le menu Actions de la configuration, sélectionnez Supprimer.
  3. À 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 nécessite les éléments suivants :
  • OCID d'une configuration HeatWave qui n'est utilisée par aucun système de base de données.
  • Politique qui vous permet de supprimer des configurations dans le compartiment ou la location.
  • Installation de l'interface de ligne de commande correctement configurée et clés SSH requises. Voir Interface de ligne de commande.
Supprimer une configuration à l'aide de l'interface de ligne de commande :
  1. Ouvrez une invite de commande et exécutez la commande suivante :
    oci mysql configuration delete 
         --configuration-id <ConfigurationOCID>
    • configuration-id : Spécifiez l'OCID de la configuration à supprimer.