Relations API (Retrieve) Overview¶
When a data object or a collection of objects is retrieved using the client API, Backendless does not automatically include related objects into the returned object hierarchy. The reason for this is it would make it very easy to load a lot of unnecessary data which could impact application's performance. There are multiple ways to retrieve related data:
- Relations auto-load - a mechanism built-into Backendless Console for configuring specific relations to be included into responses with the parent objects.
- Single-step relations retrieval - initializing and including related objects into the response when running a find query for parent objects.
- Two-step relations retrieval - a process of retrieving relations where the first step is to load the parent object and the second step is to load specific relations for the given parent.
- Loading with relations depth - retrieving related objects by specifying the depth of the object hierarchy
- Relation paging API - enables "chunked" (or paged) retrieval of related objects
- Inverted Retrieval - loading related child objects by condition applied to parent - load related objects using a search query where the condition applies to the parent object properties.