Python Polars: The Definitive Guide

Chapter 5. Eager and Lazy APIs

A Note for Early Release Readers

With Early Release ebooks, you get books in their earliest form—the author’s raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.

This will be the 5th chapter of the final book. Please note that the GitHub repo will be made active later on.

If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the editor at [e-mail].

Now that you have an understanding of the data structures and data types available in Polars, we look at the two different Application Programming Interfaces (APIs) to interact with that data: the eager API and the lazy API. Each API addresses specific use cases and has unique performance characteristics. Understanding these APIs is critical to using Polars’ data processing and analysis capabilities effectively.

In this chapter, you’ll learn:

• That the eager API uses an immediate execution model, ideal for data exploration and iterative tasks.

• That the lazy API defers the execution of data transformations until necessary, which allows comprehensively optimize queries and improving performance, especially in large-scale and performance-sensitive scenarios.

• About which API fits with which use cases, and how to choose the right one for your needs.

Eager API: DataFrame

The eager API in Polars operates ...