Retrieve Query Results

Description

QueryResult is a reference class that enables paging through query results.

Details

Synapse has the ability to query for entities using a SQL-like query language. See the Query service API wiki for details on how to form a query: http://sagebionetworks.jira.com/wiki/display/PLFM/Repository+Service+API#RepositoryServiceAPI-QueryAPI

The QueryResult object is returned from the synapseQuery function when blockSize is specified. The client can then call either fetch() or collect() to get the next block of results as a data.frame. The difference is that with collect(), the results are accumulated. For example, after 3 calls to collect(), with a blockSize of 10 we would expect a data.frame with 30 rows.

The collectAll() method repeatedly requests blocks of blocksize query results until there are no more or the limit is reached. This can be slow, so use with caution. It's usually safer to set a limit.

See also

synapseQuery

Author

J. Christopher Bare