This property enhances SQL functionality beyond what can be supported through the API directly, by enabling in-memory client-side processing.
When SupportEnhancedSQL = true, the adapter offloads as much of the SELECT statement processing as possible to FreshBooks and then processes the rest of the query in memory. In this way, the adapter can execute unsupported predicates, joins, and aggregation.
When SupportEnhancedSQL = false, the adapter limits SQL execution to what is supported by the FreshBooks API.
Execution of Predicates
The adapter determines which of the clauses are supported by the data source and then pushes them to the source to get the smallest superset of rows that would satisfy the query. It then filters the rest of the rows locally. The filter operation is streamed, which enables the adapter to filter effectively for even very large datasets.
Execution of Joins
The adapter uses various techniques to join in memory. The adapter trades off memory utilization against the requirement of reading the same table more than once.
Execution of Aggregates
The adapter retrieves all rows necessary to process the aggregation in memory.