Support dataframe to tsfile #706

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Open

ColinLeeo wants to merge 9 commits into develop

from support_dataframe_to_tsfile

Open

Support dataframe to tsfile #706

ColinLeeo wants to merge 9 commits into develop from support_dataframe_to_tsfile

Conversation

@ColinLeeo

Copy link

Contributor

@ColinLeeo ColinLeeo commented Jan 14, 2026 •

edited

Loading

def dataframe_to_tsfile(dataframe: pd.DataFrame,
 file_path: str,
 table_name: Optional[str] = None,
 time_column: Optional[str] = None,
 tag_column: Optional[list[str]] = None,
 ):
 """
 Write a pandas DataFrame to a TsFile by inferring the table schema from the DataFrame.
 This function automatically infers the table schema based on the DataFrame's column
 names and data types, then writes the data to a TsFile.
 Parameters
 ----------
 dataframe : pd.DataFrame
 The pandas DataFrame to write to TsFile.
 - If a 'time' column (case-insensitive) exists, it will be used as the time column.
 - Otherwise, the DataFrame index will be used as timestamps.
 - All other columns will be treated as data columns.
 file_path : str
 Path to the TsFile to write. Will be created if it doesn't exist.
 table_name : Optional[str], default None
 Name of the table. If None, defaults to "table".
 time_column : Optional[str], default None
 Name of the time column. If None, will look for a column named 'time' (case-insensitive),
 or use the DataFrame index if no 'time' column is found.
 tag_column : Optional[list[str]], default None
 List of column names to be treated as TAG columns. All other columns will be FIELD columns.
 If None, all columns are treated as FIELD columns.
 Returns
 -------
 None
 Raises
 ------
 ValueError
 If the DataFrame is empty or has no data columns.
 """

@ColinLeeo ColinLeeo force-pushed the support_dataframe_to_tsfile branch from d6aa3e1 to 8c93df1 Compare

January 14, 2026 14:37

@codecov-commenter

Copy link

codecov-commenter commented Jan 14, 2026 •

edited

Loading

Codecov Report

❌ Patch coverage is 0% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 61.80%. Comparing base (052ff6b) to head (6df963f).

Files with missing lines	Patch %	Lines
cpp/src/cwrapper/tsfile_cwrapper.cc	0.00%	2 Missing ⚠️

Additional details and impacted files

@@ Coverage Diff @@
## develop #706 +/- ##
===========================================
- Coverage 61.80% 61.80% -0.01% 
===========================================
 Files 709 709 
 Lines 40375 40376 +1 
 Branches 5686 5687 +1 
===========================================
- Hits 24954 24953 -1 
- Misses 14723 14725 +2 
 Partials 698 698

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow: