PolarDB:Enable binary logging

Contexto

O PolarDB é um banco de dados nativo da cloud totalmente compatível com o MySQL. Por padrão, ele utiliza logs físicos de nível mais alto em vez de logs binários. Para uma melhor integração com o ecossistema MySQL, o PolarDB permite a ativação manual do log binário. Após ativar o log binário, você pode se conectar a services de dados como ElasticSearch e AnalyticDB, além de configurar a sincronização de dados em tempo real do PolarDB para o RDS, do RDS para o PolarDB ou entre clusters do PolarDB.

Limites

Se o seu cluster PolarDB foi criado após 5 de abril de 2019, você pode ativar o log binário diretamente. Se o seu cluster PolarDB foi criado antes de 5 de abril de 2019, é necessário primeiro atualizar a versão secundária do seu cluster para a versão mais recente antes de ativar o log binário. Para mais informações sobre como atualizar a versão secundária, consulte {{XREF_0}}.

Faturamento

Os arquivos de log binário ocupam parte do espaço de armazenamento do cluster e geram taxas de armazenamento. Você pode ajustar o espaço de armazenamento ocupado pelos arquivos de log binário definindo o período de retenção do log binário.

Notas de uso

• O log binário é desativado por padrão. Após ativar o log binário, o cluster é reiniciado automaticamente. Geralmente, a tarefa de reinicialização é concluída em até 5 minutos. Durante a reinicialização, os services sofrem uma interrupção transitória de cerca de 40 segundos. A duração exata depende do volume de dados e do número de tabelas. Recomendamos que você execute esta operação fora dos horários de pico e garanta que suas aplicações possuam um mecanismo de reconexão.

• Após a ativação do log binário, o desempenho de gravação diminui, enquanto o desempenho de leitura não é afetado. Na maioria dos casos, o impacto no desempenho ao ativar o log binário não ultrapassa 10%. Sob pressão extrema, o impacto pode chegar a 40%. Para mais informações, consulte {{XREF_3}}.

• Ao extrair, assinar ou sincronizar logs binários (por exemplo, usando ferramentas como o DTS), recomendamos o uso do PolarDB Primary Endpoint, pois ele aponta diretamente para o nó primário que gera os logs binários, oferecendo melhor compatibilidade e estabilidade. Para mais informações sobre como visualizar o Primary Endpoint, consulte {{XREF_4}}.

• Com o log binário ativado, quando o banco de dados envia uma transação excessivamente grande, ele bloqueia o envio de outras transações, o que pode afetar a duração da reinicialização e da alteração de especificação do cluster.

• O parâmetro loose_polar_log_bin descrito neste tópico é um parâmetro de nível global. Para usar o log binário no nível de sessão, você deve ativar o parâmetro sql_log_bin.

  Nota

  O parâmetro sql_log_bin controla a ativação do log binário no nível de sessão. Por padrão, este parâmetro está desativado. Para ativá-lo, acesse Quota Center. Na linha em que o nome da cota é polardb sql_log_bin parameter permission, na coluna Actions, clique em Apply para ativá-lo.

• Se você usar o DTS para migrar do RDS para o PolarDB, o log binário será ativado automaticamente.

• Os logs binários registram apenas as alterações de dados que ocorrem após a ativação do log binário. As operações INSERT, DELETE e UPDATE executadas antes da ativação do log binário não são registradas nos arquivos de log binário.

Ativar o log binário

Desativar o log binário

1. Faça login no PolarDB console. No painel de navegação à esquerda, clique em Clusters. Selecione a Region onde o cluster está implantado e, em seguida, clique no ID do cluster para acessar a página de detalhes do cluster.

2. Use um dos seguintes métodos para desativar o log binário:

   • Método 1:

     1. Acesse a página Binary Logs do cluster.

     2. Clique em Disable Binary Logging.

     3. Na caixa de diálogo Disable Binary Logging, defina o horário de vigência como Now ou Scheduled. Escolha se deseja selecionar Clear Local Binary Logs.

        Nota

        Se você selecionar Scheduled, especifique o horário de vigência.

     4. Clique em OK.

   • Método 2: Desative o log binário definindo o parâmetro loose_polar_log_bin.

     1. No painel de navegação à esquerda, escolha Settings and Management > Parameters.

     2. Encontre o parâmetro loose_polar_log_bin e modifique seu valor. Para mais informações, consulte {{XREF_8}}.

        Nota

        • Se a versão do seu cluster PolarDB for MySQL for MySQL 5.6, altere o valor atual para OFF_WITH_GTID;

        • Se a versão do seu cluster PolarDB for MySQL for MySQL 5.7 ou MySQL 8.0, altere o valor atual para OFF.

        • Após a desativação do log binário, os arquivos de log binário existentes são retidos. Recomendamos que você primeiro reduza o período de retenção do log binário, aguarde a exclusão automática dos arquivos desnecessários e, em seguida, desative o log binário.

Período de retenção do log binário

Obter e visualizar logs binários

Use a ferramenta mysqlbinlog para visualizar e analisar logs binários. Para mais informações, consulte {{XREF_12}}.

Perguntas frequentes

• P: Por quanto tempo os arquivos de log binário são retidos?

  R: Se o log binário estiver ativado para o seu cluster, os arquivos de log binário são retidos por 3 dias por padrão. Os arquivos de log binário com mais de 3 dias são excluídos automaticamente.

  Nota

  • Para clusters PolarDB for MySQL adquiridos antes de 23 de novembro de 2023, os arquivos de log binário são retidos por duas semanas (14 dias) por padrão.

  • Para clusters PolarDB for MySQL adquiridos antes de 17 de janeiro de 2024, os arquivos de log binário são retidos por uma semana (7 dias) por padrão.

  Se o log binário estiver desativado para o seu cluster, os arquivos de log binário existentes são retidos e não são excluídos automaticamente.

  Nota

  Modifique o período de retenção do log binário para clusters com o log binário ativado alterando os parâmetros. Para mais informações, consulte {{XREF_13}}.

• P: O que significa a mensagem de erro Could not find first log file name in binary log index file?

  R: Could not find first log file name in binary log index file Com base nesta mensagem de erro, os logs binários foram limpos. Os logs binários excluídos não podem ser recuperados.

• P: Posso desativar o log binário após ativá-lo?

  R: Defina o parâmetro loose_polar_log_bin como OFF e envie a alteração.

  Nota

  Após a desativação do log binário, os arquivos de log binário existentes são retidos. Você pode primeiro reduzir o período de retenção do log binário, aguardar a exclusão automática dos arquivos desnecessários e, em seguida, desativar o log binário.

• P: Como reduzo o espaço de armazenamento ocupado pelos logs binários?

  R: Defina o parâmetro de período de retenção do log binário (loose_expire_logs_hours ou binlog_expire_logs_seconds) com um valor baixo para reduzir o espaço de armazenamento ocupado pelos arquivos de log binário.

• P: Qual é o impacto da ativação do log binário no desempenho?

  R: A ativação do log binário não afeta o desempenho de consultas (SELECT). Ela afeta apenas o desempenho de gravação e atualização (INSERT, UPDATE, DELETE, etc.). Na maioria dos casos, o impacto no desempenho ao ativar o log binário não ultrapassa 10%. Sob pressão extrema, o impacto pode chegar a 40%.

• P: Após a ativação do log binário, o cluster é reiniciado automaticamente. Quanto tempo leva a tarefa de reinicialização?

  R: Geralmente, a tarefa de reinicialização é concluída em até 5 minutos. Durante a reinicialização, os services sofrem uma interrupção transitória de cerca de 40 segundos. A duração exata depende do volume de dados e do número de tabelas. Recomendamos que você execute esta operação fora dos horários de pico e garanta que suas aplicações possuam um mecanismo de reconexão.

• P: Como obtenho e visualizo remotamente o conteúdo do log binário?

  R: Para mais informações, consulte {{XREF_14}}.

• P: Por que não posso usar o recurso {{XREF_15}} do DMS para executar alterações de esquema, como adicionar índices em clusters PolarDB for MySQL?

  R: O log binário é desativado por padrão para clusters PolarDB for MySQL. Para usar o recurso de alteração de esquema sem bloqueio do DMS, ative primeiro o log binário para o seu cluster PolarDB for MySQL. Se não quiser ativar o log binário, você também pode usar comandos DDL online para alterar o esquema da tabela.

• P: Posso usar o canal para capturar alterações do MySQL após a ativação do log binário?

  R: Sim, você pode usar o canal para capturar alterações do MySQL.

• P: A execução da instrução SHOW BINARY LOGS para consultar o tamanho do arquivo de log binário afeta o desempenho do cluster?

  R: Não. A instrução SHOW BINARY LOGS é uma operação de gerenciamento e quase não tem impacto no desempenho do cluster. Ela não afeta diretamente o desempenho de leitura e gravação do banco de dados como as operações de gravação de dados (como INSERT, UPDATE e DELETE). Portanto, você pode usar este comando com tranquilidade.

• P: Como consulto o horário da última gravação dos logs binários no PolarDB for MySQL?

  R: Use a instrução show full binary logs para visualizar o nome, o tamanho e o horário da última gravação de todos os arquivos de log binário.

  Nota

  Este recurso é compatível com clusters PolarDB for MySQL com os seguintes requisitos:

  • MySQL 8.0.2, com versão secundária 8.0.2.2.0 ou posterior.

  • MySQL 8.0.1, com versão secundária 8.0.1.1.14 ou posterior.

  • MySQL 5.7, com versão secundária 5.7.1.0.27 ou posterior.

  • MySQL 5.6, com versão secundária 5.6.1.0.38 ou posterior.

• P: Como visualizo o conteúdo do log binário em um horário específico no PolarDB for MySQL?

  R: Não é possível especificar diretamente um horário para fazer o backup dos dados. Execute primeiro o {{XREF_16}} e, em seguida, analise os logs binários para visualizar o conteúdo.