Gestión de una configuración

Puede editar una configuración personalizada, copiar una configuración, actualizar la configuración de un sistema de base de datos o comparar dos configuraciones.

Edición de una configuración personalizada

Puede editar el nombre, la descripción y las etiquetas de una configuración personalizada. No se puede editar una configuración por defecto.

Uso de la consola
Mediante la API de REST, ejecute la operación UpdateConfiguration.

Uso de la consola

Utilice la consola para editar una configuración personalizada.

En la página de lista Configuración, seleccione la configuración con la que desea trabajar. Si necesita ayuda para buscar la página de lista o la configuración, consulte Listing Configuration - Using the Console.

Se abre la página de detalles y muestra información sobre la configuración.
Seleccione el separador Detalles.
Seleccione Editar en el campo Nombre o Descripción.
En el cuadro de diálogo Editar configuración, edite el nombre y la descripción de la configuración.
Seleccione Guardar cambios.

Temas relacionados

Copia de una Configuración

Puede copiar una configuración personalizada existente o una configuración por defecto, y crear una nueva configuración personalizada.

La nueva configuración personalizada hereda la unidad de la configuración copiada. Si desea crear una configuración personalizada que soporte sistemas de base de datos de alta disponibilidad, debe copiarla de una configuración existente que soporte la alta disponibilidad. Por ejemplo, si desea crear una configuración personalizada para la unidad MySQL.8 que soporte alta disponibilidad, puede copiar desde MySQL.8. Configuración de alta disponibilidad.

Utilice la consola o una interfaz de línea de comandos para copiar una configuración.

Uso de la consola
Uso de la CLI
Mediante la API de REST, ejecute la operación CreateConfiguration con el atributo parentConfigurationId.

Uso de la consola

Utilice la consola para copiar una configuración.

En la página de lista Configuración, seleccione la configuración con la que desea trabajar. Si necesita ayuda para buscar la página de lista o la configuración, consulte Listing Configuration - Using the Console.

Se abre la página de detalles y muestra información sobre la configuración.
Seleccione Copiar configuración en la parte superior de la página.
En la sección Proporcionar información básica para la configuración, introduzca la siguiente información:
- Nombre: especifique un nombre mostrado fácil de recordar para la configuración. El nombre no tiene que ser único. Se genera un identificador de Oracle Cloud (OCID) único para identificar la configuración.
- Descripción: (Opcional) especifique una descripción para la configuración.
En la sección Configurar ubicación y hardware, introduzca la siguiente información:
- Seleccionar un compartimento: si desea crear la configuración en un compartimento diferente, seleccione el compartimento necesario.
- Seleccionar una unidad: la unidad no se puede cambiar en la configuración Copiar.
En la sección Variables de inicialización, puede seleccionar Ignorar mayúsculas/minúsculas en nombres de tablas y esquemas para desactivar la distinción entre mayúsculas y minúsculas en los nombres de tablas y esquemas. Consulte Variables de inicialización.
En la sección Variables de usuario (lectura/escritura), seleccione la variable que desea editar en la lista desplegable Nombre de variable e introduzca o seleccione el valor de variable. Para suprimir una variable de la configuración, seleccione la cruz (X) al final de la fila. Para agregar otra variable a la configuración, seleccione variable +Another.
Cada configuración tiene un juego de variables de usuario por defecto. Si no selecciona ninguna variable, Oracle agrega estas variables por defecto a la configuración. Consulte Variables de usuario.

Nota

La consola redondea los valores enteros grandes que lee de la configuración a 16 dígitos significativos. Por ejemplo, 9223372036854775807 se redondea a 9223372036854776000. Debe corregir el valor redondeado de las variables existentes que exceden el valor máximo.
La sección Variables del sistema (solo lectura) muestra variables del sistema no editables. Consulte Variables del sistema.
(Opcional) Seleccione Mostrar opciones avanzadas para ampliar la sección Etiquetas. Puede agregar una etiqueta seleccionando un espacio de nombres de etiqueta e introduciendo una clave de etiqueta y su valor de etiqueta. Si desea agregar otra etiqueta, seleccione Agregar etiqueta para crear otra fila.
(Opcional) Para guardar la definición de recurso como una configuración de Terraform, seleccione Guardar como pila. Consulte Creación de una pila a partir de una página de creación de recursos.
Para copiar la configuración, seleccione Crear.

Nota

Una vez creada la configuración, no puede editar las variables definidas en la configuración. Para editar variables, cree una nueva configuración con las variables deseadas, o bien copie una configuración existente, edite las variables y edite el sistema de base de datos para utilizar la nueva configuración. Consulte Actualización de la configuración de un sistema de base de datos.

Temas relacionados

Creación de una configuración personalizada

Uso de la CLI

Utilice la interfaz de línea de comandos para copiar una configuración.

Para esta tarea, se necesita lo siguiente:

Oracle Cloud Identifier (OCID) del compartimento.
OCID de una configuración existente desde la que copiar.
Una política que permite crear configuraciones en el compartimento o arrendamiento.
Si está copiando desde una configuración personalizada, una política que le permita leer la configuración personalizada.
Una instalación de CLI configurada correctamente y claves SSH requeridas. Consulte Interfaz de la línea de comandos.

Copie una configuración para crear una nueva configuración personalizada mediante la CLI:

Abra un símbolo del sistema y ejecute el siguiente comando:
```
oci mysql configuration create 
     --compartment-id <CompartmentOCID>
     --parent-configuration-id <ConfigurationOCID>
     --description <Description>
     --display-name <DisplayName> 
     --shape-name <ShapeName> 
     --variables <JSONObject>
```
- compartment-id: especifique el OCID del compartimento utilizado para crear la nueva configuración.
- parent-configuration-id: especifique el OCID de la configuración desde la que se va a copiar.
- description: (Opcional) especifique una breve descripción de la configuración.
- display-name: (Opcional) especifique el nombre mostrado de la configuración. Si no define un nombre mostrado, Oracle genera uno con el formato mysqlconfigurationYYYYMMDDHHMMSS.
- shape-name: especifique el nombre de la unidad. Por ejemplo, MySQL.4.
  Nota
  
  La unidad debe ser la misma que la unidad de la configuración principal.
- variables: (opcional) especifique las variables y sus valores correspondientes como pares de clave-valor en un objeto JSON, por ejemplo:
```
{ "autocommit": true, "connectTimeout": 20 } 
```

Si el comando se valida y ejecuta correctamente, obtiene una respuesta similar a la siguiente, que resume la solicitud y crea la configuración:

{
  "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"
}

Actualización de la configuración de un sistema de base de datos

Puede actualizar la configuración de un sistema de base de datos a una configuración existente o a una configuración recién creada para cambiar los valores de variables del sistema de base de datos.

Si todas las variables cambiadas son dinámicas, el sistema de base de datos no necesita un reinicio y no se produce ningún tiempo de inactividad.

Si se cambian una o más variables no dinámicas, se debe reiniciar el sistema de base de datos.

Un sistema de base de datos independiente genera un tiempo de inactividad durante el reinicio.
Un sistema de base de datos de alta disponibilidad provoca un breve tiempo de inactividad y un cambio en la ubicación principal actual a medida que realiza un reinicio sucesivo. El reinicio sucesivo acorta el tiempo de inactividad y provoca un cambio en la ubicación principal actual del sistema de base de datos de alta disponibilidad.
Si el sistema de base de datos tiene asociado un cluster HeatWave activo, los datos del cluster HeatWave se vuelven a cargar automáticamente.

Utilice la consola de una interfaz de línea de comandos para actualizar la configuración de un sistema de base de datos:

Uso de la consola
Uso de la CLI
Mediante la API de REST, ejecute la operación UpdateDbSystem con el atributo configurationId.

Uso de la consola

Utilice la consola para actualizar la configuración de un sistema de base de datos.

Realice lo siguiente para actualizar la configuración de un sistema de base de datos:

(Opcional) Cree una nueva configuración. Consulte Creación de una configuración personalizada.
Edite el sistema de base de datos para actualizar la configuración. Consulte Edición de un sistema de base de datos.
Nota

No puede actualizar la configuración si hay un canal activo conectado al sistema de base de datos. Pare el canal para actualizar la configuración.

Temas relacionados

Creación de una configuración personalizada

Uso de la CLI

Utilice la interfaz de línea de comandos para actualizar la configuración de un sistema de base de datos.

Para esta tarea, se necesita lo siguiente:

Identificador de Oracle Cloud (OCID) del sistema de base de datos.
Un OCID de configuración de HeatWave.
Una instalación de CLI configurada correctamente y claves SSH requeridas. Consulte Interfaz de la línea de comandos.

(Opcional) Cree una nueva configuración. Consulte Creación de una configuración personalizada.
Abra un símbolo del sistema y ejecute el siguiente comando:
```
oci mysql db-system update 
     --db-system-id <DBSystemOCID>
     --configuration-id <ConfigurationOCID>
```
- db-system-id: especifique el OCID del sistema de base de datos que desea actualizar.
- configuration-id: especifique el OCID de la configuración con la que desea sustituir la configuración existente.

Comparación de configuraciones

Compare las unidades, las variables de inicialización y las variables de usuario de dos configuraciones.

Nota

Esta es una función solo de consola. No hay ningún comando equivalente de la CLI o la API de REST. Puede ver los detalles de ambas configuraciones y comparar la salida.

Uso de la consola

Utilice la consola para comparar dos configuraciones.

En la página de lista Configuración, seleccione dos configuraciones que desee comparar. Si necesita ayuda para buscar la página de lista o la configuración, consulte Listing Configurations - Using the Console.
En el menú Acciones situado en la parte superior de la lista de configuración, seleccione Comparar.
En el panel Comparar configuraciones, seleccione uno de los siguientes botones:
- Mostrar diferencias de configuración: muestra las diferencias en las unidades, las variables de inicialización y las variables de usuario.
- Mostrar toda la información de configuración: muestra toda la información relacionada con las unidades, las variables de inicialización y las variables de usuario de las dos configuraciones.
Seleccione Cerrar.

Temas relacionados

Visualización de Detalles de Configuración

Supresión de una Configuración

Puede suprimir una configuración personalizada que no esté utilizando actualmente ningún sistema de base de datos.

Utilice la consola, una interfaz de línea de comandos o la API de REST para suprimir una configuración.

Uso de la consola
Uso de la CLI
Mediante la API de REST, ejecute la operación DeleteConfiguration.

Uso de la consola

Use la consola para suprimir una configuración personalizada.

Para esta tarea, se necesita lo siguiente:

La configuración personalizada que desea suprimir no la está utilizando ningún sistema de base de datos.
Una política que permite suprimir configuraciones en el compartimento o arrendamiento.

Realice lo siguiente para suprimir una configuración personalizada mediante la consola:

En la página de lista Configuración, busque la configuración con la que desea trabajar. Si necesita ayuda para buscar la página de lista o la configuración, consulte Listing Configurations - Using the Console.
En el menú Acciones de la configuración, seleccione Suprimir.
Cuando se le pida, confirme la supresión.

Uso de la CLI

Utilice la interfaz de línea de comandos para suprimir una configuración.

Para esta tarea, se necesita lo siguiente:

OCID de una configuración HeatWave que no está utilizando ningún sistema de base de datos.
Una política que permite suprimir configuraciones en el compartimento o arrendamiento.
Una instalación de CLI configurada correctamente y claves SSH requeridas. Consulte Interfaz de la línea de comandos.

Suprima una configuración mediante la CLI:

Abra un símbolo del sistema y ejecute el siguiente comando:
```
oci mysql configuration delete 
     --configuration-id <ConfigurationOCID>
```
- configuration-id: especifique el OCID de la configuración que desea suprimir.

Documentación de Oracle Cloud Infrastructure