◆ createJoinTable() \[1/4]

CreateJoinTableResponse gpudb::GPUdb::createJoinTable

(

const CreateJoinTableRequest &

request\_

)

const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters

\[in]

request\_

Request object containing the parameters for the operation.

Returns

Response object containing the result of the operation.

◆ createJoinTable() \[2/4]

CreateJoinTableResponse & gpudb::GPUdb::createJoinTable	(	const CreateJoinTableRequest &	request\_,
		CreateJoinTableResponse &	response\_ ) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters

\[in]	request\_	Request object containing the parameters for the operation.
\[out]	response\_	Response object containing the results of the operation.

Returns

Response object containing the result of the operation (initially passed in by reference).

◆ createJoinTable() \[3/4]

CreateJoinTableResponse gpudb::GPUdb::createJoinTable	(	const std::string &	joinTableName,
		const std::vector\< std::string > &	tableNames,
		const std::vector\< std::string > &	columnNames,
		const std::vector\< std::string > &	expressions,
		const std::map\< std::string, std::string > &	options ) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters

\[in]	joinTableName	Name of the join table to be created, in \[schema\_name.]table\_name format, using standard name resolution rules and meeting table naming criteria.
\[in]	tableNames	The list of table names composing the join, each in \[schema\_name.]table\_name format, using standard name resolution rules. Corresponds to a SQL statement FROM clause.
\[in]	columnNames	List of member table columns or column expressions to be included in the join. Columns can be prefixed with 'table\_id.column\_name', where 'table\_id' is the table name or alias. Columns can be aliased via the syntax 'column\_name as alias'. Wild cards '' can be used to include all columns across member tables or 'table\_id.' for all of a single table's columns. Columns and column expressions composing the join must be uniquely named or aliased–therefore, the '\*' wild card cannot be used if column names aren't unique across all tables.
\[in]	expressions	An optional list of expressions to combine and filter the joined tables. Corresponds to a SQL statement WHERE clause. For details see: expressions. The default value is an empty vector.
\[in]	options	Optional parameters. create\_join\_table\_create\_temp\_table: If true, a unique temporary table name will be generated in the sys\_temp schema and used in place of joinTableName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in qualified\_join\_table\_name. Supported values: create\_join\_table\_true create\_join\_table\_false The default value is create\_join\_table\_false. create\_join\_table\_collection\_name: \[DEPRECATED–please specify the containing schema for the join as part of joinTableName and use createSchema to create the schema if non-existent] Name of a schema for the join. If the schema is non-existent, it will be automatically created. The default value is ''. create\_join\_table\_max\_query\_dimensions: No longer used. create\_join\_table\_strategy\_definition: The tier strategy for the table and its columns. create\_join\_table\_ttl: Sets the TTL of the join table specified in joinTableName. create\_join\_table\_view\_id: View this projection is part of. The default value is ''. create\_join\_table\_no\_count: Return a count of 0 for the join table for logging and for showTable; optimization needed for large overlapped equi-join stencils. The default value is 'false'. create\_join\_table\_chunk\_size: Maximum number of records per joined-chunk for this table. Defaults to the gpudb.conf file chunk size. create\_join\_table\_enable\_virtual\_chunking: Collect chunks with accumulated size less than chunk\_size into a single chunk. The default value is 'false'. create\_join\_table\_max\_virtual\_chunk\_size: Maximum number of records per virtual-chunk. When set, enables virtual chunking. Defaults to chunk\_size if virtual chunking otherwise enabled. create\_join\_table\_min\_virtual\_chunk\_size: Minimum number of records per virtual-chunk. When set, enables virtual chunking. Defaults to chunk\_size if virtual chunking otherwise enabled. create\_join\_table\_enable\_sparse\_virtual\_chunking: Materialize virtual chunks with only non-deleted values. The default value is 'false'. create\_join\_table\_enable\_equi\_join\_lazy\_result\_store: Allow using the lazy result store to cache computation of one side of a multichunk equi-join. Reduces computation but also reduces parallelism to the number of chunks on the other side of the equi-join. create\_join\_table\_enable\_predicate\_equi\_join\_lazy\_result\_store: Allow using the lazy result store to cache computation of one side of a multichunk predicate-equi-join. Reduces computation but also reduces parallelism to the number of chunks on the other side of the equi-join. create\_join\_table\_enable\_pk\_equi\_join: Use equi-join to do primary key joins rather than using primary key index. The default value is an empty map.

Returns

Response object containing the result of the operation.

◆ createJoinTable() \[4/4]

CreateJoinTableResponse & gpudb::GPUdb::createJoinTable	(	const std::string &	joinTableName,
		const std::vector\< std::string > &	tableNames,
		const std::vector\< std::string > &	columnNames,
		const std::vector\< std::string > &	expressions,
		const std::map\< std::string, std::string > &	options,
		CreateJoinTableResponse &	response\_ ) const

Creates a table that is the result of a SQL JOIN.

For join details and examples see: Joins. For limitations, see Join Limitations and Cautions.

Parameters

\[in]	joinTableName	Name of the join table to be created, in \[schema\_name.]table\_name format, using standard name resolution rules and meeting table naming criteria.
\[in]	tableNames	The list of table names composing the join, each in \[schema\_name.]table\_name format, using standard name resolution rules. Corresponds to a SQL statement FROM clause.
\[in]	columnNames	List of member table columns or column expressions to be included in the join. Columns can be prefixed with 'table\_id.column\_name', where 'table\_id' is the table name or alias. Columns can be aliased via the syntax 'column\_name as alias'. Wild cards '' can be used to include all columns across member tables or 'table\_id.' for all of a single table's columns. Columns and column expressions composing the join must be uniquely named or aliased–therefore, the '\*' wild card cannot be used if column names aren't unique across all tables.
\[in]	expressions	An optional list of expressions to combine and filter the joined tables. Corresponds to a SQL statement WHERE clause. For details see: expressions. The default value is an empty vector.
\[in]	options	Optional parameters. create\_join\_table\_create\_temp\_table: If true, a unique temporary table name will be generated in the sys\_temp schema and used in place of joinTableName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned in qualified\_join\_table\_name. Supported values: create\_join\_table\_true create\_join\_table\_false The default value is create\_join\_table\_false. create\_join\_table\_collection\_name: \[DEPRECATED–please specify the containing schema for the join as part of joinTableName and use createSchema to create the schema if non-existent] Name of a schema for the join. If the schema is non-existent, it will be automatically created. The default value is ''. create\_join\_table\_max\_query\_dimensions: No longer used. create\_join\_table\_strategy\_definition: The tier strategy for the table and its columns. create\_join\_table\_ttl: Sets the TTL of the join table specified in joinTableName. create\_join\_table\_view\_id: View this projection is part of. The default value is ''. create\_join\_table\_no\_count: Return a count of 0 for the join table for logging and for showTable; optimization needed for large overlapped equi-join stencils. The default value is 'false'. create\_join\_table\_chunk\_size: Maximum number of records per joined-chunk for this table. Defaults to the gpudb.conf file chunk size. create\_join\_table\_enable\_virtual\_chunking: Collect chunks with accumulated size less than chunk\_size into a single chunk. The default value is 'false'. create\_join\_table\_max\_virtual\_chunk\_size: Maximum number of records per virtual-chunk. When set, enables virtual chunking. Defaults to chunk\_size if virtual chunking otherwise enabled. create\_join\_table\_min\_virtual\_chunk\_size: Minimum number of records per virtual-chunk. When set, enables virtual chunking. Defaults to chunk\_size if virtual chunking otherwise enabled. create\_join\_table\_enable\_sparse\_virtual\_chunking: Materialize virtual chunks with only non-deleted values. The default value is 'false'. create\_join\_table\_enable\_equi\_join\_lazy\_result\_store: Allow using the lazy result store to cache computation of one side of a multichunk equi-join. Reduces computation but also reduces parallelism to the number of chunks on the other side of the equi-join. create\_join\_table\_enable\_predicate\_equi\_join\_lazy\_result\_store: Allow using the lazy result store to cache computation of one side of a multichunk predicate-equi-join. Reduces computation but also reduces parallelism to the number of chunks on the other side of the equi-join. create\_join\_table\_enable\_pk\_equi\_join: Use equi-join to do primary key joins rather than using primary key index. The default value is an empty map.
\[out]	response\_	Response object containing the results of the operation.

Returns

Response object containing the result of the operation (initially passed in by reference).