Table Iterator

Application programs can query a data grid table to retrieve a subset of its rows.

Procedure

  1. Formulate a filter string that specifies the query, that is, the constraints that determine the rows that the query retrieves.
  2. Call the create iterator method of the table object.
    Supply the filter string as an argument.
    The API library sends the filter string to a proxy process, which retrieves matching rows from the data grid, and funnels them to the application through the iterator object.
  3. Iterate over the resulting rows.
    The iterator presents the rows in an order that is deterministic and repeatable, however, the application program cannot influence that order.
  4. Close the iterator object.
    Closing the iterator releases the resources that hold the query results within the component processes of the data grid.
Related tasks