Method USqlStatement():createVirtualTableFromWorkarea() Foundation

Creates a virtual table from a used workarea.

Syntax
:createVirtualTableFromWorkarea( <cnAlias> ) --> cAlias
Parameters
<cnAlias>
Alias name or ordinal of the workarea for which a virtual table is created.
Return

The method returns the alias name for the virtual table

Description

The method :createVirtualTableFromWorkarea() creates a virtual table for a used workarea. The virtual table is a projection of the workarea, not a copy. By using the alias name in the FROM clause of any SELECT statement, the data of the workarea can be accessed via SQL. Consequently, data from DBF tables, and csv/txt files (via SDFDBE) can be processed using SQL statements.

This method raises a runtime error if the workarea passed is not used or if the data model of the current workarea can not be mapped to a virtual table.

Note that a virtual table is read-only. Consequently, INSERT/DELETE/REPLACE or ALTER statements are not supported.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.