apache/seatunnel

[Feature][Zeta] Support debug mode for zeta

Open

#9764 opened on Aug 25, 2025

View on GitHub
 (5 comments) (0 reactions) (1 assignee)Java (6,897 stars) (1,432 forks)batch import
Zetafeaturehelp wanted

Description

Search before asking

  • I had searched in the feature and found no similar feature requirement.

Description

Implementing debug mode in zeta without writing data to the target database. Allows users to:

  1. Print the table structure and data output by the source;
  2. Print the table structure and data output by the transform;
  3. Print a preview of the create table sql created by the sink (https://github.com/apache/seatunnel/blob/dev/seatunnel-api/src/main/java/org/apache/seatunnel/api/table/catalog/Catalog.java#L325)
  4. Can specify the number of data entries to read (the default is 10).

Usage Scenario

No response

Related issues

No response

Are you willing to submit a PR?

  • Yes I am willing to submit a PR!

Code of Conduct

Contributor guide

Tech stack
javasql
Domain
backenddatabasedeveloper experience
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Java programmingSeaTunnel architectureZeta component
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
45
Research direction
Implement a debug mode in the zeta component that prints source and transform output, and sink SQL preview without writing to target database. The implementation should reference Catalog.java (https://github.com/apache/seatunnel/blob/dev/seatunnel api/src/main/java/org/apache/seatunnel/api/table/catalog/Catalog.java#L325) for the preview. Add a configuration option to limit the number of data entries read (default 10). Ensure debug mode can be enabled via a flag. Review existing debug or dry run patterns in the codebase for consistency.