Skip to content
RelationalAI Docs

Release Notes

Python API

Section titled “Python API”

0.9.16

September 19, 2025 4:12 PM UTC

Version 0.9.16 of the relationalai Python package is now available. This release includes the ability to skip invalid rows during data export or query with detailed warnings to improve transparency and troubleshooting.

To upgrade, activate your virtual environment and run the following command:

Terminal window
pip install --upgrade relationalai

New Features and Enhancements

Section titled “New Features and Enhancements”

  • You can now skip invalid rows during data export or query by using the new skip_invalid_data=True option in the Python API’s query and export methods. When enabled, any rows with invalid data (such as type mismatches or constraint violations) are automatically skipped instead of causing failures.

    Importantly, the system will provide detailed warnings showing which rows were rejected, which columns caused errors, and the specific error messages. This helps you quickly identify and fix data quality issues without silent failures or guesswork.

    Example Usage:

    # Skip invalid data during export
    @model.export("<my_db>.<my_schema>", skip_invalid_data=True)
    def my_export():
        ...
    

    # Skip invalid data during query:
    with model.query(skip_invalid_data=True) as select:
        ...

    Example warning output:

    Your data has been loaded but 2 rows were skipped due to erroneous data. Here are the first 2 rejected rows:
    Rejected record: {"id": "abc", "amount": "not_a_number"}
    - Erroneous column: amount
      Error message: Could not convert value to numeric
    

    Rejected record: {"id": 123, "amount": null}
    - Erroneous column: amount
      Error message: Null value not allowed

0.9.15

September 19, 2025 3:21 PM UTC

Version 0.9.15 of the relationalai Python package is now available.

To upgrade, activate your virtual environment and run the following command:

Terminal window
pip install --upgrade relationalai

New Features and Improvements

Section titled “New Features and Improvements”
  • Minor improvements to performance and stability.

0.9.14

September 19, 2025 11:11 AM UTC

Version 0.9.14 of the relationalai Python package is now available. This release includes a new CLI command to manage Snowflake engine pools and an upgrade to the Snowpark dependency that removes import warnings.

To upgrade, activate your virtual environment and run the following command:

Terminal window
pip install --upgrade --force-reinstall relationalai --upgrade-strategy eager

New Features and Enhancements

Section titled “New Features and Enhancements”

  • A new CLI command, rai engines:alter_pool, is now available to manage engine pool sizes for Snowflake-based engines. You can use this command to set the engine size as well as minimum and maximum numbers of engines in the pool, either interactively or by passing parameters (--size, --min, --max).

    Example usage:

    Terminal window
    # Interactive mode: prompts for size and pool limits
    rai engines:alter_pool
    

    # Parameterized mode: set size and pool limits directly
    rai engines:alter_pool --size HIGHMEM_X64_S --min 2 --max 5

    The command validates inputs and provides helpful error messages for invalid engine sizes, pool limits, or unsupported platforms.

Bug Fixes

Section titled “Bug Fixes”
  • Updated the RelationalAI Python package to use snowflake-snowpark-python version 1.38.0 (up from 1.34.0). This upgrade removes a warning message that previously appeared each time the library was imported.
See more

RAI Native App

Section titled “RAI Native App”
See more