How to Add a Query Table to an Ingest Instance Data Source¶

Normal Timextender staging tables are populated with a simple SELECT <Fields> FROM query. While some conditions may be added to this query with incremental and data selection rules, more advanced queries can also be performed by creating a Query Table, which allows for the creation a new source table populated by a custom query executed against the source database.

Note that complex queries may increase the processing load in the source database during the transfer phase of execution.

Adding a Query Table¶

1. To create a Query Table, right-click on an Ingest Instance Data Source and select “Manage Query Tables”.

2. Click the “Add” button in the Query Tables window.

3. Enter a name for the Query and amend the Schema as needed.

4. (Optional) Drag one of the tables from the table pane on the left into the query window to begin with a standard SELECT statement for all the fields in the table.

5. Update this Query as needed to create the custom query, i.e. add a WHERE statement for one of the fields.

6. Once the Query is complete, click the “Validate” button to have the Timextender Ingest Service (TIS) Server confirm the query is ok.

1. Click Ok to create the new query table.
2. Synchronize the data source.
3. Right-click on the data source and click on “Select Tables”.

4. In the Select Tables window, select the new Query Table and then click the “Add” button to add it to the selected tables.

5. Click the Preview button to get a view of the query table.

6. Click the Execute button to see the data populated below.

Use Subquery¶

The “Use Subquery” checkbox is checked by default and provides a way to use alias in the query that can later be used to later apply data selection and incremental loading rules to the query table. Using the following query as a query table example (MyCustomerOrderLinesView)

The query will expose one OrderId column from OrderLines but the table also contains an OrderId column. For a data selection rule to be able to distinguish between the two OrderID column instances, the “Use Subquery” checkbox would need to be checked. If the “Use Subquery”is notchecked, then the query that Timextender would send would be similar to the following, which results in an “Ambiguous Column Name” message.

If “Use Subquery” is checked, then the query that Timextender would send would look like the following instead, which mitigates the ambiguous column name condition.

It may also be the case that the column names in the data source are hard to interpret and using alias names instead will make it easier for developers to use these fields in a prepare instance. The following example shows replacing letter column names with the following more descriptive alias names:

1. Timextender Id
2. Name
3. LastName
4. LastModifiedDate

Adding an incremental rule on LastModifiedDate will without "Use Subquery" cause an error: 'Invalid column name 'LastModifiedDate'