Skip to main content

TableQuery

Defined in: js-api/src/entities/data-connection.ts:48

Represents a table query

Extends​

Constructors​

Constructor​

new TableQuery(dart): TableQuery

Defined in: js-api/src/entities/data-connection.ts:50

Parameters​

ParameterType
dartany

Returns​

TableQuery

Overrides​

DataQuery.constructor

Properties​

PropertyModifierTypeDescriptionInherited fromDefined in
auxpublicanyAuxiliary data associated with the function, not persisted (a MapBag: indexed access plus the map methods; typed any so it can be cast to a package's own shape).DataQuery.auxjs-api/src/entities/func.ts:25
dartpublicany-DataQuery.dartjs-api/src/entities/entity.ts:19
optionspublicobjectFunction options (the meta.* annotations) as key-value pairs (a MapBag: indexed access plus the map methods; typed any so it can be cast to a package's own shape).DataQuery.optionsjs-api/src/entities/func.ts:27

Accessors​

adHoc​

Get Signature​

get adHoc(): boolean

Defined in: js-api/src/entities/data-connection.ts:28

Deprecated​

Use FuncCall.adHoc. Removed in 1.29.

Returns​

boolean

Set Signature​

set adHoc(a): void

Defined in: js-api/src/entities/data-connection.ts:30

Deprecated​

Use FuncCall.adHoc. Removed in 1.29.

Parameters​
ParameterType
aboolean
Returns​

void

Inherited from​

DataQuery.adHoc


aggregations​

Get Signature​

get aggregations(): GroupAggregation[]

Defined in: js-api/src/entities/data-connection.ts:74

Aggregation clauses {queryPartParams}

Returns​

GroupAggregation[]

Set Signature​

set aggregations(wl): void

Defined in: js-api/src/entities/data-connection.ts:75

Parameters​
ParameterType
wlGroupAggregation[]
Returns​

void


author​

Get Signature​

get author(): any

Defined in: js-api/src/entities/entity.ts:57

Who created entity *

Returns​

any

Inherited from​

DataQuery.author


connection​

Get Signature​

get connection(): DataConnection

Defined in: js-api/src/entities/data-connection.ts:37

The connection this query runs on.

Returns​

DataConnection

Set Signature​

set connection(c): void

Defined in: js-api/src/entities/data-connection.ts:38

Parameters​
ParameterType
cDataConnection
Returns​

void

Inherited from​

DataQuery.connection


createdOn​

Get Signature​

get createdOn(): Dayjs

Defined in: js-api/src/entities/entity.ts:48

Time when entity was created *

Returns​

Dayjs

Inherited from​

DataQuery.createdOn


description​

Get Signature​

get description(): string

Defined in: js-api/src/entities/func.ts:36

Returns​

string

Set Signature​

set description(s): void

Defined in: js-api/src/entities/func.ts:37

Parameters​
ParameterType
sstring
Returns​

void

Inherited from​

DataQuery.description


entityType​

Get Signature​

get entityType(): string

Defined in: js-api/src/entities/entity.ts:64

Entity type name *

Returns​

string

Inherited from​

DataQuery.entityType


fields​

Get Signature​

get fields(): string[]

Defined in: js-api/src/entities/data-connection.ts:63

Fields array

Returns​

string[]

Set Signature​

set fields(fields): void

Defined in: js-api/src/entities/data-connection.ts:64

Parameters​
ParameterType
fieldsstring[]
Returns​

void


friendlyName​

Get Signature​

get friendlyName(): string

Defined in: js-api/src/entities/entity.ts:34

Entity friendly name

Returns​

string

Set Signature​

set friendlyName(x): void

Defined in: js-api/src/entities/entity.ts:35

Parameters​
ParameterType
xstring
Returns​

void

Inherited from​

DataQuery.friendlyName


having​

Get Signature​

get having(): FieldPredicate[]

Defined in: js-api/src/entities/data-connection.ts:81

Having clauses

Returns​

FieldPredicate[]

Set Signature​

set having(wl): void

Defined in: js-api/src/entities/data-connection.ts:82

Parameters​
ParameterType
wlFieldPredicate[]
Returns​

void


helpUrl​

Get Signature​

get helpUrl(): string

Defined in: js-api/src/entities/func.ts:44

Help URL.

Returns​

string

Set Signature​

set helpUrl(url): void

Defined in: js-api/src/entities/func.ts:46

Parameters​
ParameterType
urlstring
Returns​

void

Inherited from​

DataQuery.helpUrl


id​

Get Signature​

get id(): string

Defined in: js-api/src/entities/entity.ts:27

Entity ID (GUID)

Returns​

string

Set Signature​

set id(x): void

Defined in: js-api/src/entities/entity.ts:28

Parameters​
ParameterType
xstring
Returns​

void

Inherited from​

DataQuery.id


inputs​

Get Signature​

get inputs(): Property[]

Defined in: js-api/src/entities/func.ts:76

Input parameters

Returns​

Property[]

Inherited from​

DataQuery.inputs


isVectorFunc​

Get Signature​

get isVectorFunc(): boolean

Defined in: js-api/src/entities/func.ts:54

Indicates that the function (or script) is already vector, meaning it accepts vector input (an entire column) and processes it in a single call, rather than being executed separately for each scalar element (row)

Returns​

boolean

Inherited from​

DataQuery.isVectorFunc


joins​

Get Signature​

get joins(): TableJoin[]

Defined in: js-api/src/entities/data-connection.ts:77

Returns​

TableJoin[]

Set Signature​

set joins(j): void

Defined in: js-api/src/entities/data-connection.ts:78

Parameters​
ParameterType
jTableJoin[]
Returns​

void


limit​

Get Signature​

get limit(): number | undefined

Defined in: js-api/src/entities/data-connection.ts:89

Returns​

number | undefined

Set Signature​

set limit(rows): void

Defined in: js-api/src/entities/data-connection.ts:88

Parameters​
ParameterType
rowsnumber | undefined
Returns​

void


name​

Get Signature​

get name(): string

Defined in: js-api/src/entities/entity.ts:38

Entity short name

Returns​

string

Set Signature​

set name(x): void

Defined in: js-api/src/entities/entity.ts:39

Parameters​
ParameterType
xstring
Returns​

void

Inherited from​

DataQuery.name


nqName​

Get Signature​

get nqName(): string

Defined in: js-api/src/entities/entity.ts:42

Entity full-qualified name

Returns​

string

Inherited from​

DataQuery.nqName


orderBy​

Get Signature​

get orderBy(): FieldOrder[]

Defined in: js-api/src/entities/data-connection.ts:85

Order By clauses

Returns​

FieldOrder[]

Set Signature​

set orderBy(wl): void

Defined in: js-api/src/entities/data-connection.ts:86

Parameters​
ParameterType
wlFieldOrder[]
Returns​

void


outputs​

Get Signature​

get outputs(): Property[]

Defined in: js-api/src/entities/func.ts:81

Output parameters

Returns​

Property[]

Inherited from​

DataQuery.outputs


package​

Get Signature​

get package(): any

Defined in: js-api/src/entities/func.ts:49

A package this function belongs to, or null for core functions (e.g. Sin).

Returns​

any

Inherited from​

DataQuery.package


path​

Get Signature​

get path(): string

Defined in: js-api/src/entities/func.ts:41

Entity path

Returns​

string

Inherited from​

DataQuery.path


postProcessScript​

Get Signature​

get postProcessScript(): string

Defined in: js-api/src/entities/data-connection.ts:41

Script that post-processes the query result.

Returns​

string

Set Signature​

set postProcessScript(script): void

Defined in: js-api/src/entities/data-connection.ts:42

Parameters​
ParameterType
scriptstring
Returns​

void

Inherited from​

DataQuery.postProcessScript


query​

Get Signature​

get query(): string

Defined in: js-api/src/entities/data-connection.ts:33

Query text

Returns​

string

Set Signature​

set query(q): void

Defined in: js-api/src/entities/data-connection.ts:34

Parameters​
ParameterType
qstring
Returns​

void

Inherited from​

DataQuery.query


table​

Get Signature​

get table(): string

Defined in: js-api/src/entities/data-connection.ts:59

Table name

Returns​

string

Set Signature​

set table(tableName): void

Defined in: js-api/src/entities/data-connection.ts:60

Parameters​
ParameterType
tableNamestring
Returns​

void


tags​

Get Signature​

get tags(): string[]

Defined in: js-api/src/entities/func.ts:62

Function tags. Every function kind carries them (scripts, queries, package functions). See also: https://datagrok.ai/help/datagrok/concepts/functions/func-params-annotation

Returns​

string[]

Set Signature​

set tags(tags): void

Defined in: js-api/src/entities/func.ts:63

Parameters​
ParameterType
tagsstring[]
Returns​

void

Inherited from​

DataQuery.tags


topMenu​

Get Signature​

get topMenu(): string | null

Defined in: js-api/src/entities/func.ts:58

The main-menu path the function is registered under (//top-menu: Bio | Analyze | MSA...), or null; the way to tell which function a menu item runs.

Returns​

string | null

Inherited from​

DataQuery.topMenu


type​

Get Signature​

get type(): string

Defined in: js-api/src/entities/func.ts:39

Returns​

string

Inherited from​

DataQuery.type


updatedOn​

Get Signature​

get updatedOn(): Dayjs | null

Defined in: js-api/src/entities/entity.ts:51

Time when entity was updated *

Returns​

Dayjs | null

Inherited from​

DataQuery.updatedOn


where​

Get Signature​

get where(): FieldPredicate[]

Defined in: js-api/src/entities/data-connection.ts:70

Where clauses

Returns​

FieldPredicate[]

Set Signature​

set where(wl): void

Defined in: js-api/src/entities/data-connection.ts:71

Parameters​
ParameterType
wlFieldPredicate[]
Returns​

void

Methods​

apply()​

apply(parameters?): Promise<any>

Defined in: js-api/src/entities/func.ts:89

Executes the function with the specified parameters, and returns result. If necessary, the corresponding package will be loaded as part of the call.

Parameters​

ParameterType
parametersany[] | {[name: string]: any; }

Returns​

Promise<any>

Inherited from​

DataQuery.apply


applySync()​

applySync(parameters?): any

Defined in: js-api/src/entities/func.ts:105

Executes the function synchronously, and returns the result. If the function is asynchronous, throws an exception.

Parameters​

ParameterType
parameters{[name: string]: any; }

Returns​

any

Inherited from​

DataQuery.applySync


executeTable()​

executeTable(): Promise<DataFrame>

Defined in: js-api/src/entities/data-connection.ts:67

Executes query

Returns​

Promise<DataFrame>

Overrides​

DataQuery.executeTable


getProperties()​

getProperties(): Promise<{[index: string]: any; }>

Defined in: js-api/src/entities/entity.ts:67

Gets entity properties

Returns​

Promise<{[index: string]: any; }>

Inherited from​

DataQuery.getProperties


hasTag()​

hasTag(tag): boolean

Defined in: js-api/src/entities/entity.ts:79

Parameters​

ParameterType
tagstring

Returns​

boolean

Inherited from​

DataQuery.hasTag


newId()​

newId(): void

Defined in: js-api/src/entities/entity.ts:31

Generates new id for this entity.

Returns​

void

Inherited from​

DataQuery.newId


prepare()​

prepare(parameters?): FuncCall

Defined in: js-api/src/entities/func.ts:66

Returns FuncCall object in a stand-by state

Parameters​

ParameterType
parameters{[name: string]: any; }

Returns​

FuncCall

Inherited from​

DataQuery.prepare


prepareAsync()​

prepareAsync(parameters?): Promise<FuncCall>

Defined in: js-api/src/entities/func.ts:70

Parameters​

ParameterType
parameters{[name: string]: any; }

Returns​

Promise<FuncCall>

Inherited from​

DataQuery.prepareAsync


setProperties()​

setProperties(props): Promise<any>

Defined in: js-api/src/entities/entity.ts:72

Sets entity properties

Parameters​

ParameterType
props{[index: string]: any; }

Returns​

Promise<any>

Inherited from​

DataQuery.setProperties


tag()​

tag(tag): boolean

Defined in: js-api/src/entities/entity.ts:82

Adds a specified tag

Parameters​

ParameterType
tagstring

Returns​

boolean

Inherited from​

DataQuery.tag


toString()​

toString(): string

Defined in: js-api/src/entities/entity.ts:77

Returns a string representing the object

Returns​

string

Inherited from​

DataQuery.toString


unTag()​

unTag(tag): boolean

Defined in: js-api/src/entities/entity.ts:85

Removes a specified tag

Parameters​

ParameterType
tagstring

Returns​

boolean

Inherited from​

DataQuery.unTag


byName()​

static byName(name): Func

Defined in: js-api/src/entities/func.ts:126

Returns a function with the specified name.

Parameters​

ParameterType
namestring

Returns​

Func

Inherited from​

DataQuery.byName


create()​

static create(connection): TableQuery

Defined in: js-api/src/entities/data-connection.ts:54

Creates a TableQuery

Parameters​

ParameterTypeDescription
connectionDataConnectionDataConnection to query table from

Returns​

TableQuery


find()​

static find(params?): Func[]

Defined in: js-api/src/entities/func.ts:110

Returns functions with the specified attributes.

Parameters​

ParameterType
params?{ meta?: any; name?: string; package?: string; returnSemType?: string; returnType?: string; tags?: string[]; }
params.meta?any
params.name?string
params.package?string
params.returnSemType?string
params.returnType?string
params.tags?string[]

Returns​

Func[]

Inherited from​

DataQuery.find


findAll()​

static findAll(params?): Promise<Func[]>

Defined in: js-api/src/entities/func.ts:117

Parameters​

ParameterType
params?{ meta?: any; name?: string; package?: string; returnSemType?: string; returnType?: string; tags?: string[]; }
params.meta?any
params.name?string
params.package?string
params.returnSemType?string
params.returnType?string
params.tags?string[]

Returns​

Promise<Func[]>

Deprecated​

Use find: the same result, synchronous, without a server query. Removed in 1.29.

Inherited from​

DataQuery.findAll


from()​

static from(table): TableQueryBuilder

Defined in: js-api/src/entities/data-connection.ts:93

Creates TableQueryBuilder from table name

Parameters​

ParameterTypeDescription
tablestringTable name

Returns​

TableQueryBuilder


fromTable()​

static fromTable(table): TableQueryBuilder

Defined in: js-api/src/entities/data-connection.ts:97

Creates TableQueryBuilder from TableInfo

Parameters​

ParameterTypeDescription
tableTableInfoTableInfo object

Returns​

TableQueryBuilder