ApsaraDB RDS:Enable AP acceleration for a primary instance

Aplicabilidad

La instancia principal de ApsaraDB RDS for PostgreSQL debe pertenecer a la serie Básica o de Alta disponibilidad.

Notas de uso

Antes de habilitar la aceleración HTAP, tenga en cuenta lo siguiente:

• Espacio en disco: después de iniciar la conversión de filas a columnas, el sistema agrega un almacén columnar. Supervise el uso del espacio en disco de su instancia para evitar que se agote.

• Desconexión transitoria: se produce una desconexión transitoria mientras se habilita la aceleración HTAP en la instancia principal. Realice esta operación fuera del horario de mayor actividad o asegúrese de que su aplicación cuente con un mecanismo de reconexión automática.

• Restricción de instancias de solo lectura: después de habilitar la aceleración HTAP en una instancia principal, no puede agregarle instancias de solo lectura analíticas basadas en DuckDB. Tampoco puede habilitar la aceleración HTAP en una instancia principal que ya tenga adjunta una instancia de solo lectura analítica basada en DuckDB.

• Recuperación de base de datos: si recupera una base de datos en una instancia principal con la aceleración HTAP habilitada, la nueva instancia creada a partir de la recuperación no hereda automáticamente la función HTAP. Debe volver a habilitar la función para la nueva instancia.

Paso 1: Habilitar la aceleración HTAP

En este paso, se habilita la aceleración HTAP a través de la consola de ApsaraDB RDS.

1. Inicie sesión en la consola de ApsaraDB RDS.

2. En el panel de navegación izquierdo, haga clic en Instances. Luego, en la barra de navegación superior, seleccione la región donde se encuentra la instancia.

3. Localice la instancia objetivo y haga clic en su ID de instancia.

4. Vaya a la página de aceleración HTAP mediante uno de los siguientes métodos:

   • Método 1: En la parte superior de la página de detalles de la instancia, haga clic en HTAP Acceleration.

   • Método 2: En la sección Configuration Information de la página de detalles de la instancia, localice el elemento de configuración HTAP Acceleration y haga clic en Settings.

5. En el cuadro de diálogo HTAP Acceleration Pre-check, revise los resultados de la verificación de requisitos previos.

   • Si todas las verificaciones se superan, haga clic en confirm para comenzar a habilitar la aceleración HTAP.

   • Si alguna verificación falla, resuelva el problema según las indicaciones:

     • Elementos que se pueden corregir automáticamente: Para elementos como Minor Version y Parameter Settings, haga clic en confirm. El sistema completa automáticamente la actualización o la configuración.

     • Elementos que deben corregirse manualmente: Para elementos como Major Version o Instance Resources, siga las instrucciones de los documentos referenciados. Después, vuelva a habilitar la aceleración HTAP.

       • Actualización de la versión principal del motor: consulte Upgrade a major engine version.

       • Cambio de configuración: consulte Change instance specifications.

   El cuadro de diálogo de verificación de requisitos previos muestra la siguiente información en la parte superior: Habilitar HTAP agrega almacenamiento columnar. Supervise el uso del disco de la instancia. Se produce una desconexión transitoria durante el proceso. Si la verificación de parámetros falla, el sistema modifica automáticamente los siguientes parámetros:

   Parámetro	Cambio
   shared_preload_libraries	Se agrega rds_duckdb.
   wal_level	Cambia de replica a logical.
   hot_standby_feedback	Cambia de off a on.
   max_replication_slots	Cambia de 16 a 1024.
   max_worker_processes	Cambia de 8 a 1024.
   max_wal_senders	Cambia de 64 a 1024.

6. Espere a que se habilite la función. Una vez habilitada, el estado de HTAP Acceleration en la sección Configuration Information cambia a Enabled.

Paso 2: Configurar el almacenamiento columnar

Después de habilitar la aceleración HTAP para la instancia principal, configure el almacenamiento columnar para las tablas que desee utilizar en consultas analíticas.

1. Utilice DMS u otro cliente de base de datos para conectarse a la base de datos de destino con una cuenta privilegiada.

2. Ejecute el siguiente comando para crear la extensión rds_duckdb:

   CREATE EXTENSION IF NOT EXISTS rds_duckdb;

3. Ejecute el siguiente comando para convertir una tabla específica a almacenamiento columnar:

   • Convertir una sola tabla:

     SELECT rds_duckdb.create_duckdb_table('table_name');

     Reemplace table_name con el nombre de la tabla que desea convertir. Para convertir varias tablas, ejecute este comando múltiples veces.

   • Convertir varias tablas en lote:

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

     Utilice create_duckdb_tables (forma plural) para transformar varias tablas en lote. Encierre los nombres de las tablas entre llaves y sepárelos con comas.

Referencias

• DuckDB-based analytical instance