6 Reading Table Rows

There are several ways to retrieve table rows from the store. You can:

  1. Retrieve a single row at a time using the TableAPI.get() method.

  2. Retrieve rows associated with a shard key (which is based on at least part of your primary keys) using either the TableAPI.multiGet() or TableAPI.multiGetIterator() methods.

  3. Retrieve table rows that share a shard key, or an index key, using the TableAPI.tableIterator() method.

  4. Retrieve and process records from each shard in parallel using a single key as the retrieval criteria. Use one of the TableAPI.tableIterator() or TableAPI.tableKeysIterator() methods that provide parallel scans.

  5. Retrieve and process records from each shard in parallel using a set of keys as the retrieval criteria. Use one of the TableAPI.tableIterator() or TableAPI.tableKeysIterator() methods that provide bulk retrievals.

Each of these are described in the following sections.