Gerenciando uma Configuração

Você pode editar uma configuração personalizada, copiar uma configuração, atualizar a configuração de um sistema de banco de dados ou comparar duas configurações.

Editando uma Configuração Personalizada

Você pode editar o nome, a descrição e as tags de uma configuração personalizada. Não é possível editar uma configuração padrão.

Usando a Console

Use a Console para editar uma configuração personalizada.

  1. Abra o menu de navegação e selecione Bancos de Dados. Em HeatWave MySQL, clique em Configuração.
  2. Localize a configuração personalizada que você deseja editar e execute uma das seguintes ações:
    • Clique no menu Ações e selecione Editar para abrir a caixa de diálogo Editar configuração.
    • Clique no nome da configuração para abrir a página Detalhes da configuração e clique em Editar.
  3. Na caixa de diálogo Editar configuração, edite o nome e a descrição da configuração.
  4. (Opcional) Selecione Mostrar opções avançadas para expandir a seção Tags. Você pode editar tags existentes, adicionar tags adicionais e excluir tags indesejadas.
  5. Clique em Salvar alterações.

Copiando uma Configuração

Você pode copiar uma configuração personalizada existente ou padrão e criar uma nova configuração personalizada.

A nova configuração personalizada herda a forma da configuração copiada. Se quiser criar uma configuração personalizada que suporte sistemas de BD de alta disponibilidade, copie de uma configuração existente que suporte alta disponibilidade. Por exemplo, se quiser criar uma configuração personalizada para a forma MySQL.8 que suporte alta disponibilidade, você poderá copiar da forma MySQL.8. Configuração de HA.

Use a Console ou uma interface de linha de comando para copiar uma configuração.

Usando a Console

Use a Console para copiar uma configuração.

  1. Abra o menu de navegação e selecione Bancos de Dados. Em HeatWave MySQL, clique em Configuração.
  2. Clique no menu Ações na mesma linha da configuração que você deseja copiar e selecione Copiar Configuração.
  3. Na seção Fornecer informações básicas para a configuração, especifique as seguintes informações:
    • Nome: Especifique um nome para exibição amigável na configuração. O nome não precisa ser exclusivo. Um OCID (Oracle Cloud Identifier) exclusivo é gerado para identificar a configuração.
    • Descrição: (Opcional) Especifique uma descrição para a configuração.
  4. Na seção Configurar posicionamento e hardware, digite as seguintes informações:
    • Selecionar um Compartimento: Se você quiser criar a configuração em outro compartimento, selecione o compartimento necessário.
    • Selecionar uma Forma: A forma não pode ser alterada na configuração Copiar.
  5. Na seção Variáveis de inicialização, você pode selecionar Ignorar maiúsculas e minúsculas em nomes de tabela e esquema para desativar a distinção entre maiúsculas e minúsculas de nomes de tabela e esquema. Consulte Variáveis de Inicialização.
  6. Na seção Variáveis de usuário (leitura/gravação), selecione a variável que você deseja editar na lista drop-down Nomes de Variáveis e informe ou selecione o Valor da Variável. Para excluir uma variável da configuração, selecione a cruz (X) no final da linha. Para adicionar outra variável à sua configuração, selecione +Another Variable.
    Cada configuração tem um conjunto de variáveis de usuário padrão. Se você não selecionar alguma variável, a Oracle adicionará essas variáveis padrão à Configuração. Consulte Variáveis de Usuário.
    Observação

    A Console arredonda valores inteiros grandes que lê da Configuração para 16 dígitos significativos. Por exemplo, 9223372036854775807 é arredondado para 9223372036854776000. É necessário corrigir o valor arredondado de variáveis existentes que excedem o valor máximo.
  7. A seção Variáveis do sistema (somente leitura) mostra variáveis de sistema não editáveis. Consulte Variáveis do Sistema
  8. (Opcional) Selecione Mostrar opções avançadas para expandir a seção Tags. Você pode adicionar uma tag selecionando um Namespace de tag e informando uma Chave de tag e seu Valor de tag. Se quiser adicionar outra tag, selecione Adicionar tag para criar outra linha.
  9. (Opcional) Para salvar a definição de recurso como uma configuração do Terraform, selecione Salvar como pilha. Consulte Criando uma Pilha a partir de uma Página de Criação de Recurso.
  10. Para copiar a configuração, selecione Criar.
    Observação

    Depois de criar a configuração, você não poderá editar as variáveis definidas na configuração. Para editar variáveis, crie uma nova configuração com as variáveis desejadas ou copie uma configuração existente, edite as variáveis e edite o sistema de banco de dados para usar a nova configuração. Consulte Atualizando a Configuração de um Sistema de BD.

Usando a CLI

Use a interface de linha de comando para copiar uma configuração.

Esta tarefa requer o seguinte:
  • O OCID (Oracle Cloud Identifier) do seu compartimento.
  • O OCID de uma configuração existente da qual copiar.
  • Uma política que permite criar configurações no compartimento ou na tenancy.
  • Se você estiver copiando de uma configuração personalizada, uma política que permita ler a configuração personalizada.
  • Uma instalação da CLI configurada corretamente e as chaves SSH necessárias. Consulte Interface de Linha de Comando.
Copie uma configuração para criar uma nova configuração personalizada usando a CLI:
  1. Abra um prompt de comando e execute o seguinte 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 o OCID do compartimento usado para criar a nova configuração.
    • parent-configuration-id: Especifique o OCID da configuração a ser copiada.
    • description: (Opcional) Especifique uma breve descrição da configuração.
    • display-name: (Opcional) Especifique o nome para exibição da configuração. Se você não definir um nome para exibição, o sistema Oracle gerará um nome para você no formato mysqlconfigurationYYYYMMDDHHMMSS.
    • shape-name: Especifique o nome da forma. Por exemplo, MySQL.4.
      Observação

      A forma deve ser igual à forma da configuração pai.
    • variables: (Opcional) Especifique as variáveis e seus valores correspondentes como pares de valores de chave em um objeto JSON, por exemplo:
      { "autocommit": true, "connectTimeout": 20 } 
Se o comando for validado e executado com sucesso, você obterá uma resposta semelhante a esta, que resume a solicitação e cria a configuração:
{
  "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"
}

Atualizando a Configuração de um Sistema de BD

Você pode atualizar a configuração de um sistema de banco de dados para uma configuração existente ou uma configuração recém-criada para alterar as definições de variável do sistema de banco de dados.

Se todas as variáveis alteradas forem dinâmicas, o sistema de banco de dados não exigirá uma reinicialização e nenhum tempo de inatividade será incorrido.

Se uma ou mais variáveis não dinâmicas forem alteradas, o sistema de banco de dados precisará ser reiniciado.
  • Um sistema de banco de dados independente incorre em um período de indisponibilidade durante a reinicialização.
  • Um sistema de banco de dados de alta disponibilidade incorre em um breve período de indisponibilidade e uma alteração no posicionamento principal atual à medida que ele executa uma reinicialização incremental. A reinicialização incremental reduz o tempo de inatividade e causa uma alteração no posicionamento principal atual do sistema de banco de dados de alta disponibilidade.
  • Se o sistema de BD tiver um cluster HeatWave ativo anexado a ele, os dados no cluster HeatWave serão recarregados automaticamente.
Use a Console de uma interface de linha de comando para atualizar a configuração de um sistema de banco de dados:

Usando a Console

Use a Console para atualizar a configuração de um sistema de banco de dados.

Faça o seguinte para atualizar a configuração de um sistema de banco de dados:

  1. (Opcional) Crie uma nova configuração. Consulte Criando uma Configuração Personalizada.
  2. Edite o sistema de banco de dados para atualizar a configuração. Consulte Editando um Sistema de Banco de Dados
    Observação

    Você não poderá atualizar a configuração se houver um canal ativo conectado ao sistema de banco de dados. Interrompa o canal para atualizar a configuração.

Usando a CLI

Use a interface da linha de comando para atualizar a configuração de um sistema de banco de dados.

Esta tarefa requer o seguinte:
  • Um OCID (Oracle Cloud Identifier) do sistema de banco de dados.
  • Um OCID de configuração HeatWave.
  • Uma instalação da CLI configurada corretamente e as chaves SSH necessárias. Consulte Interface de Linha de Comando.
  1. (Opcional) Crie uma nova configuração. Consulte Criando uma Configuração Personalizada.
  2. Abra um prompt de comando e execute o seguinte comando:
    oci mysql db-system update 
         --db-system-id <DBSystemOCID>
         --configuration-id <ConfigurationOCID>
    • db-system-id: Especifique o OCID do sistema de banco de dados que você deseja atualizar.
    • configuration-id: Especifique o OCID da configuração com a qual você deseja substituir a configuração existente.

Comparando Configurações

Compare as formas, as variáveis de inicialização e as variáveis de usuário de duas configurações.

Observação

Este é um recurso somente da Console; não há comando equivalente da CLI ou da API REST. Você pode exibir os detalhes das duas configurações e comparar a saída.

Usando a Console

Use a Console para comparar duas configurações.

  1. Abra o menu de navegação e selecione Bancos de Dados. Em HeatWave MySQL, clique em Configuração.
  2. Marque a caixa de seleção das duas configurações que você deseja comparar, clique no botão Ações na parte superior da página e, em seguida, clique em Comparar.
  3. No painel Comparar configurações, clique em um dos seguintes botões de opção:
    • Mostrar diferenças de configuração: Exibe as diferenças nas formas, variáveis de inicialização e variáveis de usuário.
    • Mostrar todas as informações de configuração: Exibe todas as informações relacionadas a formas, variáveis de inicialização e variáveis de usuário das duas configurações.
  4. Clique em Fechar.

Tópicos Relacionados