Todos los productos
Search
Centro de documentos

ApsaraDB for OceanBase (Deprecated):Consultar y modificar los objetos de sincronización y sus condiciones de filtro

Última actualización: Sep 04, 2026

Este tema describe cómo consultar y modificar los objetos de sincronización de una tarea de sincronización de datos configurada, así como modificar las condiciones de filtro SQL de dichos objetos mediante el servicio de transmisión de datos.

Contexto

Es posible agregar o quitar objetos de sincronización y modificar sus condiciones de filtro durante la sincronización, sujeto a ciertas limitaciones. Los cambios realizados quedan registrados. Cuando finaliza una tarea de adición de objetos, esta se integra con la tarea original asociada. Una vez completada la integración, la tarea original se ejecuta con normalidad y la tarea de adición de objetos se libera automáticamente.

Para obtener información sobre cómo modificar los objetos de sincronización seleccionados mediante reglas de coincidencia y cambiar sus condiciones de filtro SQL, consulte Configure and modify matching rules.

Limitaciones

  • En una tarea de sincronización de datos con estado Not Started, Running o Stopped, puede agregar o quitar objetos de sincronización.

    Importante

    Si una tarea de sincronización de datos tiene el estado Stopped y su paso de Incremental Synchronization también presenta el estado Stopped, no es posible agregar objetos de sincronización.

  • No se pueden agregar objetos de sincronización a una tarea de sincronización de datos con estado Failed.

  • Si una tarea de sincronización de datos tiene el estado Modifying o Integrating, no es posible volver a modificar sus objetos de sincronización.

  • Cuando el paso Incremental Synchronization de una tarea de sincronización de datos presenta el estado Stopped o Failed, no se pueden agregar objetos de sincronización.

  • En tareas de sincronización de datos con estado Stopped, Failed, Not Started o Running, es posible modificar las condiciones de filtro de filas.

Consultar objetos de sincronización

  1. Inicie sesión en ApsaraDB for OceanBase console

    .

  2. En el panel de navegación izquierdo, seleccione Data Transmission > Data Synchronization.

  3. En la página Data Synchronization, haga clic en el nombre de la tarea deseada para acceder a su página de detalles.

    image.png

  4. Haga clic en View Objects en la esquina superior derecha y revise la información en las pestañas Synchronization Objects y Object Modifications.

    • La pestaña Synchronization Objects muestra los objetos de sincronización de la tarea actual. Desde aquí puede agregar o quitar objetos, además de modificar sus condiciones de filtro de filas.

    • La pestaña Object Modifications muestra el tipo, estado y hora de todas las modificaciones de objetos.

Agregar objetos de sincronización

  1. En la página de detalles de la tarea deseada, haga clic en View Objects en la esquina superior derecha.

    image.png

  2. En el cuadro de diálogo View Objects, seleccione Synchronization Objects > Add Objects.

    image.png

  3. En el cuadro de diálogo Add Objects, seleccione los objetos de sincronización que desea agregar.

    Importante
    • De forma predeterminada, los objetos recién agregados heredan todas las opciones de configuración de la tarea original de sincronización de datos. Si cancela la operación de adición, deberá eliminar manualmente los objetos que ya se hayan agregado a la base de datos destino.

    • Si especificó un nombre de esquema o de base de datos para el origen de datos fuente, solo podrá agregar objetos de sincronización bajo ese nombre de esquema o base de datos específico.

    • Si el destino de la tarea de sincronización de datos es una cola de mensajes, en el cuadro de diálogo Add Objects, seleccione los objetos de sincronización en la sección izquierda Source Object(s) y haga clic en > para agregarlos a la lista derecha. En el cuadro de diálogo Map Object to Topic, elija el método de asignación según sus necesidades.

      image.png

      Una vez seleccionados los objetos de sincronización por agregar, puede realizar operaciones como cambiar el topic, configurar filtros de filas y quitar objetos.

      image.png

    • Si el destino de la tarea de sincronización de datos es una base de datos, en el cuadro de diálogo Add Objects, seleccione los objetos de sincronización en la sección izquierda Source Object(s) y haga clic en > para agregarlos a la lista derecha.

      image

      Tras seleccionar los objetos de sincronización por agregar, puede ejecutar operaciones como renombrar objetos destino, establecer filtros de filas y quitar objetos.

      image

  4. Haga clic en Next.

  5. El sistema realiza automáticamente una verificación previa de los objetos agregados. Una vez que estos superan todas las comprobaciones, haga clic en Save.

  6. Confirme la información y haga clic en OK en el cuadro de diálogo que aparece.

    • En tareas detenidas o con errores, puede cancelar la operación y modificar los objetos nuevamente. Los objetos se agregarán únicamente después de reanudar la tarea de sincronización de datos.

    • Si agrega objetos a una tarea en ejecución, estos se incorporan de inmediato tras hacer clic en Save.

    Al iniciar una operación de adición de objetos, se genera el registro correspondiente. Para consultar los detalles, haga clic en View Objects en la página de detalles de la tarea y luego seleccione la pestaña Object Modifications.

    image.png

    El estado de un registro de adición de objetos puede ser Pending, Canceled, Modifying, Running, Aborted, Integrating, Succeeded o Failed. Las operaciones disponibles para cada registro y el estado de la tarea original varían según el estado del registro de adición.

    Nota

    Si la tarea original tiene el estado Not Started, se genera un registro de modificación con estado Succeeded para la operación de adición. Si la tarea original presenta el estado Stopped, se genera un registro de modificación con estado Pending.

    El estado de un registro de adición de objetos cambia únicamente cuando la tarea original se encuentra en estado Running; asimismo, el estado de la tarea original cambia junto con el del registro de adición. La siguiente tabla proporciona más detalles.

    Estado del registro de adición de objetos

    Operación compatible

    Estado de la tarea original

    Pending

    Consultar detalles y cancelar.

    Running

    Canceled

    Ninguna

    Running

    Modifying

    Ninguna

    Modifying

    Running

    Consultar detalles y cancelar.

    Modifying

    Aborted

    Consultar detalles.

    Running

    Integrating

    Consultar detalles.

    Integrating

    Succeeded

    Consultar detalles.

    Running

    Failed

    Consultar detalles y reintentar.

    También puede hacer clic en View Causes para ir a la página de detalles de la tarea y revisar las causas del error.

    Modifying o Integrating

Quitar objetos de sincronización

  1. En la página de detalles de la tarea deseada, haga clic en View Objects en la esquina superior derecha.

    image.png

  2. En el cuadro de diálogo View Objects, seleccione Synchronization Objects > Remove Objects.

    image.png

  3. En el cuadro de diálogo Remove Objects, pase el cursor sobre el objeto de sincronización que desea quitar en la sección derecha Target Object(s) y haga clic en Remove.

    image.png

    Si el destino de la tarea de sincronización de datos es una cola de mensajes, puede seleccionar varios objetos de sincronización y hacer clic en Batch Remove. En el cuadro de diálogo que aparece, haga clic en OK.

    image.png

  4. En el cuadro de diálogo Remove Objects, haga clic en Remove.

  5. En el cuadro de diálogo de confirmación que aparece, confirme el objeto por quitar y haga clic en OK.

    Si la tarea tiene el estado Stopped, Failed o Running, el objeto se quita de inmediato tras hacer clic en OK.

    Importante
    • Un objeto eliminado no se puede recuperar. Proceda con precaución.

    • El resultado final de la operación de eliminación de objetos es exitoso o con errores para todos los objetos involucrados.

    Al iniciar una operación de eliminación de objetos, se genera el registro correspondiente. Para consultar los detalles, haga clic en View Objects en la página de detalles de la tarea y luego seleccione la pestaña Object Modifications.

    image.png

    El estado de un registro de eliminación de objetos puede ser Pending, Canceled, Modifying, Succeeded o Failed. Las operaciones disponibles para cada registro y el estado de la tarea original varían según el estado del registro de eliminación.

    Estado del registro de eliminación de objetos

    Operación compatible

    Estado de la tarea original

    Pending

    Consultar detalles y cancelar.

    Running

    Canceled

    Ninguna

    Running

    Modifying

    Consultar detalles.

    Modifying

    Succeeded

    Consultar detalles.

    Running

    Failed

    Consultar detalles y reintentar.

    También puede hacer clic en View Causes para ir a la página de detalles de la tarea y revisar las causas del error.

    Modifying

Modificar las condiciones de filtro de los objetos de sincronización

Puede modificar las condiciones SQL para filtrar datos de los objetos de sincronización seleccionados mediante la opción Specify Objects mientras se ejecuta una tarea de sincronización de datos.

  1. En la página de detalles de la tarea deseada, haga clic en View Objects en la esquina superior derecha.

    image.png

  2. En el cuadro de diálogo View Objects, haga clic en la pestaña Synchronization Objects, expanda el esquema destino, pase el cursor sobre el objeto objetivo y haga clic en Settings.

    image

  3. En la sección Row Filters del cuadro de diálogo Settings, especifique una cláusula WHERE estándar de SQL para configurar o modificar los filtros de filas. Para obtener más información, consulte Use SQL conditions to filter data.

    image

  4. Haga clic en Validate Syntax.

  5. Una vez validada correctamente la sintaxis, haga clic en OK en el cuadro de diálogo Settings.

  6. En el cuadro de diálogo que aparece, haga clic en Apply para aplicar la modificación al objeto.

  7. En la pestaña Object Modifications, consulte el progreso de la modificación.

    image

    También puede hacer clic en View Details para ir a la página Modify Setting Details, pasar el cursor sobre la tabla de datos objetivo y hacer clic en View Settings para consultar los filtros de filas modificados.

    image