Reading Data

Learn to query B-Fabric and retrieve data using different approaches.

• ResultContainer API
• Entity API
• Entity Caching

Choose Your Approach

bfabricPy provides two complementary APIs for reading data:

Approach	Primary Class	Best For	Documentation
ResultContainer API	ResultContainer	Simple queries, data analysis, DataFrame export	ResultContainer API
Entity API	Entity / EntityReader	Typed entities, relationships, URI access	Entity API

Quick Comparison

Feature	ResultContainer API	Entity API
Entry Point	client.read(endpoint, obj)	client.reader
Return Type	Dictionaries (raw data)	Entity objects (typed)
Relationships	Manual handling	Lazy-loading via entity.refs
Caching	Manual	Automatic (via cache_entities())
URI Support	Limited	Full URI-based access
Data Export	Polars DataFrames	Via data_dict
Use Case	Simple queries, data analysis	Working with entities, relationships

See Also

• Working with Entities - Entity type reference

• API Reference: EntityReader - Complete EntityReader documentation

• Error Handling - Query error handling