Todos los productos
Search

Este producto

    Time Series Database:Solución de migración de datos para InfluxDB en la nube

    Centro de documentos

    Time Series Database:Solución de migración de datos para InfluxDB en la nube

    Última actualización: Sep 04, 2026

    Cloud TSDB for InfluxDB se descontinuará próximamente, por lo que es necesario migrar los datos existentes. Este tema describe cómo utilizar las herramientas backup y restore de InfluxDB para migrar datos históricos desde su instancia en la nube hacia una instancia autoalojada de InfluxDB 1.x, fragmento por fragmento.

    Importante

    TSDB for InfluxDB® se descontinuará oficialmente el 23 de octubre de 2026. Para garantizar la continuidad del servicio, complete la migración de sus datos antes de la fecha de descontinuación. Para obtener más detalles sobre este proceso, consulte the TSDB for InfluxDB® discontinuation notice.

    Requisitos previos

    1. Actualice su instancia de Cloud TSDB for InfluxDB a la versión 1.8.14 o posterior.

    2. Envíe un ticket a través del sistema de tickets de Alibaba Cloud para contactar al soporte técnico y habilitar el puerto de copia de seguridad 8088.

    3. Adquiera una instancia ECS con las mismas especificaciones, en la misma región, zona, VPC y vSwitch que su instancia de TSDB for InfluxDB. Esta instancia ECS se utilizará para la migración y para alojar la instancia autoalojada de InfluxDB. Para obtener más información, consulte Create an ECS instance.

    4. Descargue InfluxDB 1.8.10 de código abierto y complete la instalación, el inicio y la configuración básica para utilizarla como instancia de destino autoalojada.

    5. Lea la sección Backup and Restore en la documentación oficial de InfluxDB para comprender el proceso de copia de seguridad y restauración.

    6. Compruebe que el almacenamiento disponible de la instancia de Cloud TSDB for InfluxDB sea como mínimo del 40%. La operación de copia de seguridad ocupa almacenamiento temporal en la instancia. Si el espacio libre es insuficiente, la copia de seguridad podría fallar y afectar el funcionamiento normal de la instancia.

    7. Compruebe que el uso de memoria de la instancia de Cloud TSDB for InfluxDB no exceda el 60%. Si el uso de memoria supera este límite, actualice las especificaciones de la instancia antes de ejecutar la copia de seguridad y la migración.

    Consideraciones

    • La copia de seguridad y la restauración solo migran datos históricos. No se garantiza la migración de los datos incrementales escritos después de la copia de seguridad. Se recomienda escribir datos tanto en Cloud TSDB for InfluxDB como en la instancia autoalojada de InfluxDB simultáneamente antes de migrar los datos históricos.

    • Los archivos de copia de seguridad ocupan espacio de almacenamiento en la instancia ECS que aloja la instancia autoalojada de InfluxDB. Reserve como mínimo el doble de la capacidad de almacenamiento de su volumen de datos.

    • La migración de datos utiliza una estrategia de importación serial por fragmento de tiempo. Complete la migración total de datos para toda la base de datos dentro de un fragmento de tiempo antes de comenzar con el siguiente.

    Descripción general del flujo de trabajo

    La migración se realiza fragmento por fragmento. El flujo de trabajo completo es el siguiente:

    1. Confirme que se cumplen todos los requisitos previos.

    2. Ejecute SHOW SHARDS para obtener información sobre todos los fragmentos.

    3. Seleccione un fragmento y ejecute influxd backup en la instancia ECS para realizar una copia de seguridad de los datos localmente.

    4. Ejecute influxd restore para restaurar la copia de seguridad en una base de datos temporal en la instancia autoalojada de InfluxDB.

    5. Utilice SELECT INTO para escribir datos desde la base de datos temporal hacia la base de datos de destino.

    6. Verifique la integridad de los datos en la base de datos de destino.

    7. Elimine la base de datos temporal.

    8. Repita los pasos 3 al 7 para los fragmentos restantes hasta que todos hayan sido migrados.

    Procedimiento

    Consultar la lista de fragmentos

    Antes de realizar una copia de seguridad, ejecute la siguiente sentencia InfluxQL para consultar la información de todos los fragmentos y determinar cuáles se deben migrar:

    SHOW SHARDS

    Del resultado obtenido, extraiga los campos id, database y retention_policy de cada fragmento. Estos campos se utilizan como parámetros en los comandos de copia de seguridad posteriores. Debe ejecutar las operaciones de copia de seguridad y restauración en cada fragmento individualmente.

    Copia de seguridad

    Ejecute el comando de copia de seguridad en la instancia ECS que aloja la instancia autoalojada de InfluxDB para respaldar los datos fragmento por fragmento. Debe especificar el nombre de la base de datos, el nombre de la política de retención y el ID del fragmento para cada copia de seguridad.

    • Sintaxis

      influxd backup -portable \
  -host <source instance VPC address:8088> \
  -db <database name> \
  -rp <retention policy name> \
  -shard <shard ID> \
  <backup directory>

    • Parámetros

      Parámetro

      Descripción

      -portable

      Utiliza el formato de copia de seguridad portátil.

      -host

      El endpoint de VPC y el puerto de copia de seguridad de la instancia de Cloud TSDB for InfluxDB, con el formato ts-xxx:8088.

      -db

      El nombre de la base de datos de la que se realizará la copia de seguridad.

      -rp

      El nombre de la política de retención de la que se realizará la copia de seguridad.

      -shard

      El ID del fragmento del que se realizará la copia de seguridad. Ejecute SHOW SHARDS para obtener los ID de los fragmentos.

      <backup directory>

      El directorio donde se guardan los archivos de copia de seguridad; por ejemplo, /root/tmp/influx_backup.

    • Ejemplo

      influxd backup -portable \
  -host ts-xxx.influxdata.tsdb.aliyuncs.com:8088 \
  -db example_db \
  -rp example_rp \
  -shard 123 \
  /root/tmp/influx_backup
      Nota

      En este ejemplo, reemplace ts-xxx.influxdata.tsdb.aliyuncs.com:8088, example_db, example_rp, 123 y /root/tmp/influx_backup con los valores correspondientes a su alcance real de migración.

    Restauración

    Consulte la documentación oficial para restaurar datos en una base de datos existente.

    1. En la instancia ECS que aloja la instancia autoalojada de InfluxDB, ejecute el comando de restauración para recuperar los datos en una base de datos temporal.

      • Sintaxis

        influxd restore -portable \
  -db <backed-up database name> \
  -rp <backed-up retention policy name> \
  -shard <shard ID> \
  -newdb <temporary database name> \
  <backup directory>

      • Parámetros

        Parámetro

        Descripción

        -portable

        Lee el formato de copia de seguridad portátil.

        -db

        El nombre de la base de datos respaldada.

        -rp

        El nombre de la política de retención respaldada.

        -shard

        El ID del fragmento respaldado.

        -newdb

        El nombre de la base de datos temporal donde se restaurarán los datos.

        <backup directory>

        El directorio donde se almacenan los datos de la copia de seguridad; por ejemplo, /root/tmp/influx_backup.

      • Ejemplo

        influxd restore -portable \
  -db example_db \
  -rp example_rp \
  -shard 123 \
  -newdb example_tmp_db \
  /root/tmp/influx_backup
        En este ejemplo, reemplace example_db , example_rp , 123 , example_tmp_db y /root/tmp/influx_backup con los valores correspondientes al contenido real de su copia de seguridad.

    2. Utilice InfluxQL para consultar datos de la base de datos temporal y escribirlos en la base de datos de destino.

      Para grandes volúmenes de datos, SELECT INTO puede generar datos incompletos debido a tiempos de espera agotados en las consultas. Confirme lo siguiente antes de la ejecución:

      • Si el tiempo de espera de consulta está habilitado (es decir, si INFLUXDB_COORDINATOR_QUERY_TIMEOUT tiene un valor configurado), auméntelo a un valor suficientemente grande. InfluxDB no aplica un tiempo de espera de consulta de forma predeterminada.

      • Para escenarios con grandes volúmenes de datos, ejecute SELECT INTO en lotes por rango de tiempo para evitar que se agote el tiempo de espera en una sola consulta.

        SELECT *
INTO "example_db"."example_rp".:MEASUREMENT
FROM "example_tmp_db"."example_rp"/.*/
GROUP BY *
      /.*/ es la sintaxis de expresión regular de InfluxQL que coincide con todas las mediciones.

    3. Verifique la integridad de los datos. Consulte el recuento de filas tanto en la base de datos temporal como en la base de datos de destino. Confirme que los datos son consistentes antes de continuar con el siguiente paso.

      SELECT COUNT(*) FROM "example_tmp_db"."example_rp"/.*/
SELECT COUNT(*) FROM "example_db"."example_rp"/.*/

    4. Elimine la base de datos temporal.

      DROP DATABASE "example_tmp_db";

    Preguntas frecuentes

    • P: ¿La copia de seguridad y la restauración migran datos incrementales?

      R: No, los datos incrementales no se migran automáticamente. influxd backup captura únicamente los datos que existen en el momento en que se realiza la copia de seguridad. Los datos escritos después de que finaliza la copia de seguridad no se incluyen. Se recomienda escribir datos tanto en Cloud TSDB for InfluxDB como en la instancia autoalojada de InfluxDB simultáneamente antes de migrar los datos históricos.

    • P: ¿Cómo puedo consultar las especificaciones de mi instancia de Cloud TSDB for InfluxDB?

      R: Inicie sesión en la consola de TSDB y vaya a la página Instance Details. En la sección Configuration Information, consulte las especificaciones de la instancia, incluida la capacidad de almacenamiento, CPU, memoria de la base de datos, tipo de disco y versión del motor.

    • P: ¿Cómo determino si una instancia todavía tiene tráfico de lectura o escritura?

      R: Inicie sesión en la consola de TSDB y vaya a la página Instance Monitoring. Seleccione Engine Monitoring. Revise la métrica Data Points Written per Second para confirmar si las solicitudes de escritura siguen activas, y revise la métrica Queries per Second para confirmar si las solicitudes de consulta siguen activas.

    • P: ¿Cómo migro a una base de datos diferente?

      R: Se recomienda migrar primero a una instancia autoalojada de InfluxDB. El costo de migración es relativamente bajo y le permite conservar su modelo de datos existente, lenguaje de consulta y patrones de uso del cliente. Al migrar a una base de datos diferente, el modelo de datos, el lenguaje de consulta, la precisión temporal, los tipos de datos y las herramientas de importación pueden diferir de InfluxDB. Evalúe y verifique la migración según las capacidades de la base de datos de destino. Este tema no proporciona pasos de migración para bases de datos específicas.

    Referencias