Changelog

v2.4.0 (2026-02-03)

  • Require td-client minimum version of 1.7.0

  • Require urllib3 minimum version of 2.0.0

  • Require pyarrow minimum version of 14.0.1

v2.3.0 (2025-11-14)

  • Require td-client version 1.6.0

  • Support type hinting

  • Support infinity/nan for InsertIntoWriter

v2.2.0 (2025-08-15)

  • Add new option perform_wait_callback for BulkImportWriter

  • Require td-client to be of at least version 1.5.0

v2.1.0 (2025-08-08)

  • Add new options for BulkImportWriter: bulk_import_name, commit_timeout and perform_wait_callback

v2.0.0 (2025-08-05)

  • Migrate presto-python-client to trino-python-client

  • Add support for Python 3.12, 3.13

  • Drop support for Python 3.8

v1.9.0 (2025-03-21)

  • Add show_progress flag to BulkImportWriter

  • Enable Multithreading on msgpack Chunking in BulkImportWriter

v1.7.0 (2024-09-20)

  • New parallel upload feature. Use two new parameters max_workers and chunk_record_size in Client’s load_table_from_dataframe api to configure parallelization of uploading data to Treasure Data, saving time

  • Support for pandas 2

  • Increase supported numpy versions to between 1.17.3 and less than 2.0.0

v1.6.0 (2024-08-26)

  • Add support for python 3.11

  • Drop support of EOL python 3.7

v1.5.2 (2024-06-03)

  • Handle cases with cur.description is None

  • Keep single quotes in InsertIntoWriter

  • Use obj.items instead of iteritems()

v1.5.1 (2022-12-08)

  • Updated dependencies and pytd now supports python 3.9 and 3.10

v1.4.4 (2022-09-06)

  • Upgrade urllib3 version (#112)

v1.4.3 (2021-02-10)

  • [hot fix] Set upper version for pandas lower than 1.2 (#108)

v1.4.2 (2021-02-10)

  • Presto queries issued by pandas_td.read_td_query use join_distribution_type session property instead of the deprecated distributed_join property. See our documentation for more information about the change. (#100)

Note

pytd does not offer its version 1.4.1 because an unofficial 1.4.1 binary was unexpectedly published to PyPI and deleted immediately; PyPI refuses to re-upload deleted version numbers.

v1.4.0 (2021-01-11)

  • Deprecate (Py)Spark 2.x and Python 3.5 support, and migrate to Spark 3.x and Python 3.8, respectively. SparkWriter requires running with Spark 3.x from now on. (#94)

v1.3.0 (2020-05-11)

  • Enable passing extra keyword arguments (e.g., fmt="msgpack") to pandas_td.to_td. (#80)

  • Support engine_version option in query APIs. (#81)

  • Add force_tdclient option to Presto query interfaces for deterministically using tdclient rather than prestodb. (#85)

  • Add a precondition check to Writer#write_dataframe for making sure the type of table argument. (#86)

  • Documentation updates. (#82, #89)

v1.2.0 (2020-03-18)

  • Support nullable column containing pandas.NA, which was newly introduced in pandas 1.0.0. The Writer module internally converts pandas.NA into None before ingesting pandas.DataFrame to Treasure Data. Note that Writer#write_dataframe may behave differently between before and after upgrading pandas to 1.0.0 because of the experimental, backward-incompatible updates on the dependent package. (#72)

v1.1.0 (2020-03-07)

  • Support list-type column in BulkImportWriter#write_dataframe. A list-type column of pandas.DataFrame will be stored into Treasure Data table as an array-type column. (#60)

  • Store a resulting object from Client#query to Client.query_executed. The object could be a Treasure Data job id if query is executed via tdclient. (#63)

  • Support null value in str, bool, and "Int64"-type column of pandas.DataFrame. (#68, #71)

  • Update minimum required pandas version to 0.24.0 (#69)

v1.0.0 (2019-11-11)

  • Update documentation site. (#49, #57)

  • Add Treasure Data API endpoint HTTPS scheme validation. (#51)

  • Support bulk importing with the MessagePack format. (#53)

  • Improve stability of BulkImportWriter session ID. (#55)

  • Require td-client-python version 1.1.0 or later. (#56)

  • Add Client#exists(database, table) and Client#create_database_if_not_exists(database) method. (#58)

v0.8.0 (2019-09-17)

  • Clean up docstrings and launch documentation site. (#43, #44)

  • Disable type, one of the Treasure Data-specific query parameters, because it is conflicted with the engine option. (#45)

  • Add td-pyspark dependency for easily accessing to the td-spark functionalities. (#46, #47)

v0.7.0 (2019-08-23)

  • Support if_exists="append" option in BulkImportWriter. (#38)

  • PrestoQueryEngine and HiveQueryEngine accept Treasure Data-specific query parameters such as priority. (#41)