Kinetica   C#   API  Version 7.2.3.0
kinetica.AggregateGroupByRequest.Options Struct Reference

A set of string constants for the parameter options. More...

Public Attributes

const string CREATE_TEMP_TABLE = "create_temp_table"
 If TRUE, a unique temporary table name will be generated in the sys_temp schema and used in place of RESULT_TABLE. More...
 
const string TRUE = "true"
 
const string FALSE = "false"
 
const string COLLECTION_NAME = "collection_name"
 [DEPRECATED–please specify the containing schema as part of RESULT_TABLE and use Kinetica.createSchema to create the schema if non-existent] Name of a schema which is to contain the table specified in RESULT_TABLE. More...
 
const string EXPRESSION = "expression"
 Filter expression to apply to the table prior to computing the aggregate group by. More...
 
const string CHUNKED_EXPRESSION_EVALUATION = "chunked_expression_evaluation"
 evaluate the filter expression during group-by chunk processing. More...
 
const string HAVING = "having"
 Filter expression to apply to the aggregated results. More...
 
const string SORT_ORDER = "sort_order"
 [DEPRECATED–use order_by instead] String indicating how the returned values should be sorted - ascending or descending. More...
 
const string ASCENDING = "ascending"
 Indicates that the returned values should be sorted in ascending order. More...
 
const string DESCENDING = "descending"
 Indicates that the returned values should be sorted in descending order. More...
 
const string SORT_BY = "sort_by"
 [DEPRECATED–use order_by instead] String determining how the results are sorted. More...
 
const string KEY = "key"
 Indicates that the returned values should be sorted by key, which corresponds to the grouping columns. More...
 
const string VALUE = "value"
 Indicates that the returned values should be sorted by value, which corresponds to the aggregates. More...
 
const string ORDER_BY = "order_by"
 Comma-separated list of the columns to be sorted by as well as the sort direction, e.g., 'timestamp asc, x desc'. More...
 
const string STRATEGY_DEFINITION = "strategy_definition"
 The tier strategy for the table and its columns. More...
 
const string RESULT_TABLE = "result_table"
 The name of a table used to store the results, in [schema_name. More...
 
const string RESULT_TABLE_PERSIST = "result_table_persist"
 If TRUE, then the result table specified in RESULT_TABLE will be persisted and will not expire unless a TTL is specified. More...
 
const string RESULT_TABLE_FORCE_REPLICATED = "result_table_force_replicated"
 Force the result table to be replicated (ignores any sharding). More...
 
const string RESULT_TABLE_GENERATE_PK = "result_table_generate_pk"
 If TRUE then set a primary key for the result table. More...
 
const string TTL = "ttl"
 Sets the TTL of the table specified in RESULT_TABLE. More...
 
const string CHUNK_SIZE = "chunk_size"
 Indicates the number of records per chunk to be used for the result table. More...
 
const string CHUNK_COLUMN_MAX_MEMORY = "chunk_column_max_memory"
 Indicates the target maximum data size for each column in a chunk to be used for the result table. More...
 
const string CHUNK_MAX_MEMORY = "chunk_max_memory"
 Indicates the target maximum data size for all columns in a chunk to be used for the result table. More...
 
const string CREATE_INDEXES = "create_indexes"
 Comma-separated list of columns on which to create indexes on the result table. More...
 
const string VIEW_ID = "view_id"
 ID of view of which the result table will be a member. More...
 
const string PIVOT = "pivot"
 pivot column More...
 
const string PIVOT_VALUES = "pivot_values"
 The value list provided will become the column headers in the output. More...
 
const string GROUPING_SETS = "grouping_sets"
 Customize the grouping attribute sets to compute the aggregates. More...
 
const string ROLLUP = "rollup"
 This option is used to specify the multilevel aggregates. More...
 
const string CUBE = "cube"
 This option is used to specify the multidimensional aggregates. More...
 
const string SHARD_KEY = "shard_key"
 Comma-separated list of the columns to be sharded on; e.g. More...
 

Detailed Description

A set of string constants for the parameter options.

Optional parameters.

Definition at line 95 of file AggregateGroupBy.cs.

Member Data Documentation

◆ ASCENDING

const string kinetica.AggregateGroupByRequest.Options.ASCENDING = "ascending"

Indicates that the returned values should be sorted in ascending order.

Definition at line 175 of file AggregateGroupBy.cs.

◆ CHUNK_COLUMN_MAX_MEMORY

const string kinetica.AggregateGroupByRequest.Options.CHUNK_COLUMN_MAX_MEMORY = "chunk_column_max_memory"

Indicates the target maximum data size for each column in a chunk to be used for the result table.

Must be used in combination with the RESULT_TABLE option.

Definition at line 312 of file AggregateGroupBy.cs.

◆ CHUNK_MAX_MEMORY

const string kinetica.AggregateGroupByRequest.Options.CHUNK_MAX_MEMORY = "chunk_max_memory"

Indicates the target maximum data size for all columns in a chunk to be used for the result table.

Must be used in combination with the RESULT_TABLE option.

Definition at line 319 of file AggregateGroupBy.cs.

◆ CHUNK_SIZE

const string kinetica.AggregateGroupByRequest.Options.CHUNK_SIZE = "chunk_size"

Indicates the number of records per chunk to be used for the result table.

Must be used in combination with the RESULT_TABLE option.

Definition at line 305 of file AggregateGroupBy.cs.

◆ CHUNKED_EXPRESSION_EVALUATION

const string kinetica.AggregateGroupByRequest.Options.CHUNKED_EXPRESSION_EVALUATION = "chunked_expression_evaluation"

evaluate the filter expression during group-by chunk processing.

Supported values:

The default value is FALSE.

Definition at line 145 of file AggregateGroupBy.cs.

◆ COLLECTION_NAME

const string kinetica.AggregateGroupByRequest.Options.COLLECTION_NAME = "collection_name"

[DEPRECATED–please specify the containing schema as part of RESULT_TABLE and use Kinetica.createSchema to create the schema if non-existent] Name of a schema which is to contain the table specified in RESULT_TABLE.

If the schema provided is non-existent, it will be automatically created.

Definition at line 126 of file AggregateGroupBy.cs.

◆ CREATE_INDEXES

const string kinetica.AggregateGroupByRequest.Options.CREATE_INDEXES = "create_indexes"

Comma-separated list of columns on which to create indexes on the result table.

Must be used in combination with the RESULT_TABLE option.

Definition at line 326 of file AggregateGroupBy.cs.

◆ CREATE_TEMP_TABLE

const string kinetica.AggregateGroupByRequest.Options.CREATE_TEMP_TABLE = "create_temp_table"

If TRUE, a unique temporary table name will be generated in the sys_temp schema and used in place of RESULT_TABLE.

Supported values:

The default value is FALSE.

Definition at line 112 of file AggregateGroupBy.cs.

◆ CUBE

const string kinetica.AggregateGroupByRequest.Options.CUBE = "cube"

This option is used to specify the multidimensional aggregates.

Definition at line 357 of file AggregateGroupBy.cs.

◆ DESCENDING

const string kinetica.AggregateGroupByRequest.Options.DESCENDING = "descending"

Indicates that the returned values should be sorted in descending order.

Definition at line 179 of file AggregateGroupBy.cs.

◆ EXPRESSION

const string kinetica.AggregateGroupByRequest.Options.EXPRESSION = "expression"

Filter expression to apply to the table prior to computing the aggregate group by.

Definition at line 130 of file AggregateGroupBy.cs.

◆ FALSE

const string kinetica.AggregateGroupByRequest.Options.FALSE = "false"

Definition at line 115 of file AggregateGroupBy.cs.

◆ GROUPING_SETS

const string kinetica.AggregateGroupByRequest.Options.GROUPING_SETS = "grouping_sets"

Customize the grouping attribute sets to compute the aggregates.

These sets can include ROLLUP or CUBE operartors. The attribute sets should be enclosed in paranthesis and can include composite attributes. All attributes specified in the grouping sets must present in the groupby attributes.

Definition at line 349 of file AggregateGroupBy.cs.

◆ HAVING

const string kinetica.AggregateGroupByRequest.Options.HAVING = "having"

Filter expression to apply to the aggregated results.

Definition at line 149 of file AggregateGroupBy.cs.

◆ KEY

const string kinetica.AggregateGroupByRequest.Options.KEY = "key"

Indicates that the returned values should be sorted by key, which corresponds to the grouping columns.

If you have multiple grouping columns (and are sorting by key), it will first sort the first grouping column, then the second grouping column, etc.

Definition at line 213 of file AggregateGroupBy.cs.

◆ ORDER_BY

const string kinetica.AggregateGroupByRequest.Options.ORDER_BY = "order_by"

Comma-separated list of the columns to be sorted by as well as the sort direction, e.g., 'timestamp asc, x desc'.

The default value is ''.

Definition at line 226 of file AggregateGroupBy.cs.

◆ PIVOT

const string kinetica.AggregateGroupByRequest.Options.PIVOT = "pivot"

pivot column

Definition at line 334 of file AggregateGroupBy.cs.

◆ PIVOT_VALUES

const string kinetica.AggregateGroupByRequest.Options.PIVOT_VALUES = "pivot_values"

The value list provided will become the column headers in the output.

Should be the values from the pivot_column.

Definition at line 340 of file AggregateGroupBy.cs.

◆ RESULT_TABLE

const string kinetica.AggregateGroupByRequest.Options.RESULT_TABLE = "result_table"

The name of a table used to store the results, in [schema_name.

]table_name format, using standard name resolution rules and meeting table naming criteria.

Column names (group-by and aggregate fields) need to be given aliases e.g. ["FChar256 as fchar256", "sum(FDouble) as sfd"]. If present, no results are returned in the response. This option is not available if one of the grouping attributes is an unrestricted string (i.e.; not charN) type.

Definition at line 245 of file AggregateGroupBy.cs.

◆ RESULT_TABLE_FORCE_REPLICATED

const string kinetica.AggregateGroupByRequest.Options.RESULT_TABLE_FORCE_REPLICATED = "result_table_force_replicated"

Force the result table to be replicated (ignores any sharding).

Supported values:

The default value is FALSE.

Definition at line 278 of file AggregateGroupBy.cs.

◆ RESULT_TABLE_GENERATE_PK

const string kinetica.AggregateGroupByRequest.Options.RESULT_TABLE_GENERATE_PK = "result_table_generate_pk"

If TRUE then set a primary key for the result table.

Supported values:

The default value is FALSE.

Definition at line 293 of file AggregateGroupBy.cs.

◆ RESULT_TABLE_PERSIST

const string kinetica.AggregateGroupByRequest.Options.RESULT_TABLE_PERSIST = "result_table_persist"

If TRUE, then the result table specified in RESULT_TABLE will be persisted and will not expire unless a TTL is specified.

Supported values:

The default value is FALSE.

Definition at line 263 of file AggregateGroupBy.cs.

◆ ROLLUP

const string kinetica.AggregateGroupByRequest.Options.ROLLUP = "rollup"

This option is used to specify the multilevel aggregates.

Definition at line 353 of file AggregateGroupBy.cs.

◆ SHARD_KEY

const string kinetica.AggregateGroupByRequest.Options.SHARD_KEY = "shard_key"

Comma-separated list of the columns to be sharded on; e.g.

'column1, column2'.

The columns specified must be present in column_names. If any alias is given for any column name, the alias must be used, rather than the original column name. The default value is ''.

Definition at line 365 of file AggregateGroupBy.cs.

◆ SORT_BY

const string kinetica.AggregateGroupByRequest.Options.SORT_BY = "sort_by"

[DEPRECATED–use order_by instead] String determining how the results are sorted.

Supported values:

  • KEY: Indicates that the returned values should be sorted by key, which corresponds to the grouping columns. If you have multiple grouping columns (and are sorting by key), it will first sort the first grouping column, then the second grouping column, etc.
  • VALUE: Indicates that the returned values should be sorted by value, which corresponds to the aggregates. If you have multiple aggregates (and are sorting by value), it will first sort by the first aggregate, then the second aggregate, etc.

The default value is VALUE.

Definition at line 206 of file AggregateGroupBy.cs.

◆ SORT_ORDER

const string kinetica.AggregateGroupByRequest.Options.SORT_ORDER = "sort_order"

[DEPRECATED–use order_by instead] String indicating how the returned values should be sorted - ascending or descending.

Supported values:

  • ASCENDING: Indicates that the returned values should be sorted in ascending order.
  • DESCENDING: Indicates that the returned values should be sorted in descending order.

The default value is ASCENDING.

Definition at line 171 of file AggregateGroupBy.cs.

◆ STRATEGY_DEFINITION

const string kinetica.AggregateGroupByRequest.Options.STRATEGY_DEFINITION = "strategy_definition"

The tier strategy for the table and its columns.

Definition at line 231 of file AggregateGroupBy.cs.

◆ TRUE

const string kinetica.AggregateGroupByRequest.Options.TRUE = "true"

Definition at line 114 of file AggregateGroupBy.cs.

◆ TTL

const string kinetica.AggregateGroupByRequest.Options.TTL = "ttl"

Sets the TTL of the table specified in RESULT_TABLE.

Definition at line 298 of file AggregateGroupBy.cs.

◆ VALUE

const string kinetica.AggregateGroupByRequest.Options.VALUE = "value"

Indicates that the returned values should be sorted by value, which corresponds to the aggregates.

If you have multiple aggregates (and are sorting by value), it will first sort by the first aggregate, then the second aggregate, etc.

Definition at line 220 of file AggregateGroupBy.cs.

◆ VIEW_ID

const string kinetica.AggregateGroupByRequest.Options.VIEW_ID = "view_id"

ID of view of which the result table will be a member.

The default value is ''.

Definition at line 331 of file AggregateGroupBy.cs.


The documentation for this struct was generated from the following file: