ApsaraDB RDS:Ativar a aceleração HTAP para uma instância primária

Aplicabilidade

A instância primária do ApsaraDB RDS for PostgreSQL deve ser da série Basic ou de alta disponibilidade.

Observações de uso

Antes de ativar a aceleração HTAP, observe o seguinte:

• Espaço em disco — Após iniciar a conversão de linhas para colunas, o sistema adiciona um armazenamento colunar. Monitore o uso de espaço em disco da sua instância para evitar a falta de espaço.

• Desconexão transitória — Uma desconexão transitória ocorre durante a ativação da aceleração HTAP na instância primária. Execute esta operação em horários de baixa demanda ou certifique-se de que sua aplicação tenha um mecanismo de reconexão automática.

• Restrição de instância somente leitura — Depois de ativar a aceleração HTAP para uma instância primária, você não pode adicionar instâncias analíticas somente leitura baseadas em DuckDB a ela. Você também não pode ativar a aceleração HTAP para uma instância primária que já tenha uma instância analítica somente leitura baseada em DuckDB associada.

• Recuperação de banco de dados — Ao recuperar um banco de dados em uma instância primária com a aceleração HTAP ativada, a nova instância criada a partir da recuperação não herda automaticamente o recurso HTAP. Ative o recurso novamente para a nova instância.

Etapa 1: Ativar a aceleração HTAP

Nesta etapa, você ativa a aceleração HTAP por meio do console do ApsaraDB RDS.

1. Acesse o console do ApsaraDB RDS.

2. No painel de navegação à esquerda, clique em Instances. Em seguida, na barra de navegação superior, selecione a região da instância.

3. Encontre a instância de destino e clique no instance ID.

4. Acesse a página de aceleração HTAP de uma das seguintes maneiras:

   • Método 1: Na parte superior da página de detalhes da instância, clique em HTAP Acceleration.

   • Método 2: Na seção Configuration Information da página de detalhes da instância, localize o item de configuração HTAP Acceleration e clique em Settings.

5. Na caixa de diálogo HTAP Acceleration Pre-check, revise os resultados da verificação de pré-requisitos.

   • Se todas as verificações forem aprovadas, clique em confirm para ativar a aceleração HTAP.

   • Se alguma verificação falhar, resolva o problema conforme solicitado:

     • Itens com correção automática: Para itens como Minor Version e Parameter Settings, clique em confirm. O sistema conclui automaticamente a atualização ou a configuração.

     • Itens com correção manual: Para itens como Major Version ou Instance Resources, siga as instruções nos documentos referenciados. Em seguida, ative a aceleração HTAP novamente.

       • Atualização da versão principal do mecanismo: Consulte Upgrade a major engine version.

       • Alteração de configuração: Consulte Change instance specifications.

   A caixa de diálogo de verificação de pré-requisitos exibe as seguintes informações na parte superior: A ativação do HTAP adiciona o armazenamento colunar. Monitore o uso de disco da instância. Ocorre uma desconexão transitória durante o processo. Se a verificação de parâmetros falhar, o sistema modifica automaticamente os seguintes parâmetros:

   Parâmetro	Alteração
   shared_preload_libraries	Adição de rds_duckdb.
   wal_level	Alteração de replica para logical.
   hot_standby_feedback	Alteração de off para on.
   max_replication_slots	Alteração de 16 para 1024.
   max_worker_processes	Alteração de 8 para 1024.
   max_wal_senders	Alteração de 64 para 1024.

6. Aguarde a ativação do recurso. Após a ativação, o status de HTAP Acceleration na seção Configuration Information muda para Enabled.

Etapa 2: Configurar o armazenamento colunar

Após ativar a aceleração HTAP na instância primária, configure o armazenamento colunar para as tabelas a serem usadas em consultas analíticas.

1. Use o DMS ou outro cliente de banco de dados para se conectar ao banco de dados de destino com uma conta privilegiada.

2. Execute o seguinte comando e crie a extensão rds_duckdb:

   CREATE EXTENSION IF NOT EXISTS rds_duckdb;

3. Execute o comando a seguir para converter uma tabela específica para armazenamento colunar:

   • Converter uma única tabela:

     SELECT rds_duckdb.create_duckdb_table('table_name');

     Substitua table_name pelo nome da tabela a ser convertida. Para converter várias tabelas, repita a execução deste comando.

   • Converter várias tabelas em lote:

     SELECT rds_duckdb.create_duckdb_tables('{a,b,c...}');

     Use create_duckdb_tables (no plural) para transformar várias tabelas em lote. Insira os nomes das tabelas entre chaves e separe-os por vírgulas.

Referências

• DuckDB-based analytical instance