QScript SQLSummaryTableQuery

From Q
Jump to navigation Jump to search

This is only available in Displayr.

SQLSummaryTableQuery

Represents a SQL query under a SQL connection. A SQL query contains one or more tables produced by the query.

equals(obj)

Whether two objects are the same.
objThe object to compare against.
Returns:true or false
Example:
data_file.getQuestionByName('Q2').equals(data_file.questions()[0])

error

Errors associated with this item as a string. Returns null if there are no errors. Warnings are excluded. Errors only surface on individual tables (Excel tables, SQL tables, summary tables); workbooks, worksheets, queries and SQL connections return null.

getTableByName(name)

Finds a table by name.
nameThe name (title) of the table.
Returns:A SQLSummaryTable object, or null if no matching table exists.

guid

Get the internal identifier for this SQL query, which is unique for all items in the document.

name

Get/set the name of this item. Setting is silently ignored for items that do not support a name change.

referenceName

Get/set the reference name for this item, used to refer to it in the source code of other items. Setting is only supported on individual tables (Excel tables, SQL tables, summary tables); on workbooks, worksheets, SQL queries and SQL connections the setter is a silent no-op.

subItems

Returns an array containing all tables produced by this SQL query.

tables

Gets an array containing all tables in this SQL query. The first table is [0].

type

Returns SQLSummaryTableQuery.