Documentazione dell'infrastruttura Oracle Cloud

Gestione di una configurazione

È possibile modificare una configurazione personalizzata, copiare una configurazione, aggiornare la configurazione di un sistema DB o confrontare due configurazioni.

Modifica di una configurazione personalizzata

È possibile modificare il nome, la descrizione e le tag di una configurazione personalizzata. Impossibile modificare una configurazione predefinita.

Utilizzo di Console

Utilizzare la console per modificare una configurazione personalizzata.

  1. Aprire il menu di navigazione e selezionare Database. Nella sezione HeatWave MySQL fare clic su Configurazioni.
  2. Individuare la configurazione personalizzata da modificare ed effettuare una delle operazioni riportate di seguito.
    • Fare clic sul menu Azioni e selezionare Modifica per aprire la finestra di dialogo Modifica configurazione.
    • Fare clic sul nome della configurazione per aprire la pagina Dettagli della configurazione e fare clic su Modifica.
  3. Nella finestra di dialogo Modifica configurazione modificare il nome e la descrizione della configurazione.
  4. (Facoltativo) Selezionare Mostra opzioni avanzate per espandere la sezione Tag. È possibile modificare tag esistenti, aggiungere tag aggiuntive ed eliminare tag indesiderate.
  5. Fare clic su Salva modifiche.

Copia di una configurazione

È possibile copiare una configurazione personalizzata esistente o una configurazione predefinita e creare una nuova configurazione personalizzata.

La nuova configurazione personalizzata eredita la forma dalla configurazione copiata. Se si desidera creare una configurazione personalizzata che supporti i sistemi DB High Availability, è necessario eseguire la copia da una configurazione esistente che supporti l'alta disponibilità. Ad esempio, se si desidera creare una configurazione personalizzata per la forma MySQL.8 che supporti l'alta disponibilità, è possibile eseguire una copia dal file MySQL.8. Configurazione HA.

Utilizzare la console o un'interfaccia a riga di comando per copiare una configurazione.

Utilizzo di Console

Utilizzare la console per copiare una configurazione.

  1. Aprire il menu di navigazione e selezionare Database. Nella sezione HeatWave MySQL fare clic su Configurazioni.
  2. Fare clic sul menu Azioni sulla stessa riga della configurazione che si desidera copiare e selezionare Copia configurazione.
  3. Nella sezione Fornire informazioni di base per la configurazione, immettere le informazioni riportate di seguito.
    • Nome: specificare un nome visualizzato riconoscibile dall'utente per la configurazione. Non è necessario che il nome sia univoco. Viene generato un OCID (Oracle Cloud Identifier) univoco per identificare la configurazione.
    • Descrizione: (facoltativo) specificare una descrizione per la configurazione.
  4. Nella sezione Configura posizionamento e hardware immettere le informazioni riportate di seguito.
    • Selezionare un compartimento: se si desidera creare la configurazione in un compartimento diverso, selezionare il compartimento richiesto.
    • Selezionare una forma: la forma non può essere modificata nella configurazione di copia.
  5. Nella sezione Variabili di inizializzazione è possibile selezionare Ignora distinzione tra maiuscole e minuscole nei nomi di tabella e schema per disabilitare la distinzione tra maiuscole e minuscole dei nomi di tabella e schema. Vedere Variabili di inizializzazione.
  6. Nella sezione Variabili utente (lettura/scrittura) selezionare la variabile da modificare nell'elenco a discesa Nomi variabili, quindi immettere o selezionare Valore variabile. Per eliminare una variabile dalla configurazione, selezionare l'intersezione (X) alla fine della riga. Per aggiungere un'altra variabile alla configurazione, selezionare +Another Variabile.
    Ogni configurazione dispone di un set di variabili utente predefinite. Se non si seleziona alcuna variabile, Oracle aggiunge queste variabili predefinite alla configurazione. Vedere Variabili utente.
    Nota

    La console arrotonda i valori interi di grandi dimensioni letti dalla configurazione a 16 cifre significative. Ad esempio, 9223372036854775807 viene arrotondato a 9223372036854776000. È necessario correggere il valore arrotondato delle variabili esistenti che superano il valore massimo.
  7. La sezione Variabili di sistema (sola lettura) mostra le variabili di sistema non modificabili. Vedere Variabili di sistema.
  8. (Facoltativo) Selezionare Mostra opzioni avanzate per espandere la sezione Tag. Per aggiungere una tag, selezionare uno spazio di nomi tag e immettere una chiave tag e il relativo valore tag. Se si desidera aggiungere un'altra tag, selezionare Aggiungi tag per creare un'altra riga.
  9. (Facoltativo) Per salvare la definizione della risorsa come configurazione Terraform, selezionare Salva come stack. Vedere Creazione di uno stack da una pagina di creazione delle risorse.
  10. Per copiare la configurazione, selezionare Crea.
    Nota

    Una volta creata la configurazione, non è possibile modificare le variabili definite nella configurazione. Per modificare le variabili, creare una nuova configurazione con le variabili desiderate oppure copiare una configurazione esistente, modificare le variabili e modificare il sistema DB per utilizzare la nuova configurazione. Vedere Aggiornamento della configurazione di un sistema DB.

Uso dell'interfaccia CLI

Utilizzare l'interfaccia della riga di comando per copiare una configurazione.

Questa attività richiede quanto segue:
  • L'OCID (Oracle Cloud Identifier) del compartimento.
  • OCID di una configurazione esistente da cui eseguire la copia.
  • Criterio che consente di creare configurazioni nel compartimento o nella tenancy.
  • Se si esegue la copia da una configurazione personalizzata, un criterio che consente di leggere la configurazione personalizzata.
  • Un'installazione CLI configurata correttamente e le chiavi SSH richieste. Vedere Interfaccia della linea di comando.
Copiare una configurazione per creare una nuova configurazione personalizzata utilizzando l'interfaccia CLI:
  1. Aprire un prompt dei comandi ed eseguire il comando seguente:
    oci mysql configuration create 
     --compartment-id <CompartmentOCID>
     --parent-configuration-id <ConfigurationOCID>
     --description <Description>
     --display-name <DisplayName> 
     --shape-name <ShapeName> 
     --variables <JSONObject>
    • compartment-id: specificare l'OCID del compartimento utilizzato per creare la nuova configurazione.
    • parent-configuration-id: specificare l'OCID della configurazione da cui copiare.
    • description: (facoltativo) specificare una breve descrizione della configurazione.
    • display-name: (Facoltativo) Specificare il nome visualizzato della configurazione. Se non si definisce un nome visualizzato, Oracle ne genera uno automaticamente nel formato mysqlconfigurationYYYYMMDDHHMMSS.
    • shape-name: specificare il nome della forma. Ad esempio, MySQL.4.
      Nota

      La forma deve essere uguale alla forma della configurazione padre.
    • variables: (Facoltativo) Specificare le variabili e i relativi valori corrispondenti come coppie di valori chiave in un oggetto JSON, ad esempio: 
      { "autocommit": true, "connectTimeout": 20 }
Se il comando viene convalidato ed eseguito correttamente, si ottiene una risposta simile alla seguente, che riepiloga la richiesta e crea la configurazione: 
{
  "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"
}

Aggiornamento della configurazione di un sistema DB

È possibile aggiornare la configurazione di un sistema DB impostandola su una configurazione esistente o su una configurazione appena creata per modificare le impostazioni di variabile del sistema DB.

Se tutte le variabili modificate sono dinamiche, il sistema DB non richiede un riavvio e non si verifica alcun tempo di inattività.

Se vengono modificate una o più variabili non dinamiche, è necessario riavviare il sistema DB.
  • Un sistema DB standalone prevede un tempo di inattività durante il riavvio.
  • Un sistema DB High Availability subisce un breve periodo di inattività e una modifica nel posizionamento primario corrente durante l'esecuzione di un riavvio in sequenza. Il riavvio in sequenza riduce i tempi di inattività e causa una modifica nel posizionamento primario corrente del sistema DB High Availability.
  • Se al sistema DB è collegato un cluster HeatWave attivo, i dati nel cluster HeatWave vengono ricaricati automaticamente.
Utilizzare la console di un'interfaccia della riga di comando per aggiornare la configurazione di un sistema DB:

Utilizzo di Console

Utilizzare la console per aggiornare la configurazione di un sistema DB.

Effettuare le operazioni riportate di seguito per aggiornare la configurazione di un sistema DB.

  1. (Opzionale) Creare una nuova configurazione. Vedere Creazione di una configurazione personalizzata.
  2. Modificare il sistema DB per aggiornare la configurazione. Vedere Modifica di un sistema DB.
    Nota

    Non è possibile aggiornare la configurazione se esiste un canale attivo connesso al sistema DB. Arrestare il canale per aggiornare la configurazione.

Uso dell'interfaccia CLI

Utilizzare l'interfaccia della riga di comando per aggiornare la configurazione di un sistema DB.

Questa attività richiede quanto segue:
  • Identificativo Oracle Cloud (OCID) del sistema DB.
  • OCID di configurazione HeatWave.
  • Un'installazione CLI configurata correttamente e le chiavi SSH richieste. Vedere Interfaccia della linea di comando.
  1. (Opzionale) Creare una nuova configurazione. Vedere Creazione di una configurazione personalizzata.
  2. Aprire un prompt dei comandi ed eseguire il comando seguente:
    oci mysql db-system update 
     --db-system-id <DBSystemOCID>
     --configuration-id <ConfigurationOCID>
    • db-system-id: specificare l'OCID del sistema DB che si desidera aggiornare.
    • configuration-id: specificare l'OCID della configurazione con cui si desidera sostituire la configurazione esistente.

Confronto delle configurazioni

Confronta le forme, le variabili di inizializzazione e le variabili utente di due configurazioni.

Nota

Questa è solo una funzione della console, non è disponibile alcun comando CLI o API REST equivalente. È possibile visualizzare i dettagli di entrambe le configurazioni e confrontare l'output.

Utilizzo di Console

Utilizzare la console per confrontare due configurazioni.

  1. Aprire il menu di navigazione e selezionare Database. Nella sezione HeatWave MySQL fare clic su Configurazioni.
  2. Selezionare la casella di controllo delle due configurazioni da confrontare, fare clic sul pulsante Azioni nella parte superiore della pagina, quindi fare clic su Confronta.
  3. Nel pannello Confronta configurazioni fare clic su uno dei seguenti pulsanti di opzione:
    • Mostra differenze di configurazione: visualizza le differenze tra le forme, le variabili di inizializzazione e le variabili utente.
    • Mostra tutte le informazioni di configurazione: visualizza tutte le informazioni relative alle forme, alle variabili di inizializzazione e alle variabili utente delle due configurazioni.
  4. Fare clic su Chiudi.