CRUD - Read - React Native SDK
On this page
Read operations are queries to find your data stored in Realm. Data in Realm is live, which means that an object always reflects its most recent saved state and read operations never block. Objects automatically update in response to changes, so you can see up-to-date data in your application without running a new query.
Use the following @realm/react hooks to read data in a realm:
useObject(): Find a specific object by primary key.useQuery(): Get a collection of objects by object type.
These hooks return live objects, which are automatically updated when the data in the realm changes. When objects returned by these hooks are updated, the component calling the hook rerenders.
The examples on this page use the following schemas:
Find a Specific Object by Primary Key
If you know the primary key for a given
object, you can look it up directly by passing the class type and primary key to
the useObject() hook.
In the following example of a TaskItem component, we use the useObject()
hook to find a task based on its primary key: _id. Then we render the task's
name and priority in the UI.
Query for an Object Type and Filter Results
The useQuery() hook returns a collection of Realm objects that match the query as a
Realm.Results object. A basic query matches all
objects of a given type in a realm, but you can also apply a filter to the
collection to find specific objects.
A filter selects a subset of results based on the value(s) of one or more object properties. Realm lets you filter data using Realm Query Language, a string-based query language to constrain searches when retrieving objects from a realm.
Call filtered() on the query results
collection to filter a query. Pass a Realm Query Language query as an argument
to filtered().
In the following example of a TaskList component, we:
Obtain all
Taskobjects by passing "Task" to theuseQuery()hook.Obtain all high-priority tasks and low-progress task by passing a query to
filtered().Use the map function to render a list of Text components displaying information about the high-priority and low-progress tasks.
Tip
Filter on Related and Embedded Object Properties
To filter a query based on a property of an embedded object or a related object, use dot-notation as if it were in a regular, nested object.
Query for an Object Type and Sort Results
A sort operation allows you to configure the order in which Realm returns queried objects. You can sort based on one or more properties of the objects in the results collection. Realm only guarantees a consistent order of results if you explicitly sort them.
To sort a query, call the sorted() method on the query results collection.
In the following example of a TaskList component, we use the useQuery()
hook to initially retrieve the set of Task objects. We then use the
sorted() method to work with the data in various ways:
Sort objects based on the task's name alphabetically.
Sort objects based on the task's name alphabetically in descending order.
Sort objects based on the task's priority in descending order and the task's name in ascending order.
Sort objects based on the assignee object's name alphabetically.
Finally, we map through each list of tasks and render them in the UI.
Tip
Sort on Related and Embedded Object Properties
To sort a query based on a property of an embedded object or a related object, use dot-notation as if it were in a regular, nested object.