◆ createDatasource() \[1/4]

CreateDatasourceResponse gpudb::GPUdb::createDatasource

(

request\_

)

const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters

\[in]

request\_

Request object containing the parameters for the operation.

Returns

Response object containing the result of the operation.

◆ createDatasource() \[2/4]

CreateDatasourceResponse & gpudb::GPUdb::createDatasource	(	const CreateDatasourceRequest &	request\_,
		CreateDatasourceResponse &	response\_ ) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

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).

◆ createDatasource() \[3/4]

CreateDatasourceResponse gpudb::GPUdb::createDatasource	(	const std::string &	name,
		const std::string &	location,
		const std::string &	userName,
		const std::string &	password,
		const std::map\< std::string, std::string > &	options ) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters

\[in]	name	Name of the data source to be created.
\[in]	location	Location of the remote storage in 'storage\_provider\_type://\[storage\_path\[:storage\_port]]' format. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'jdbc', 'kafka', 'confluent', and 's3'.
\[in]	userName	Name of the remote system user; may be an empty string.
\[in]	password	Password for the remote system user; may be an empty string.
\[in]	options	Optional parameters. create\_datasource\_skip\_validation: Bypass validation of connection to remote source. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_connection\_timeout: Timeout in seconds for connecting to this storage provider. create\_datasource\_wait\_timeout: Timeout in seconds for reading from this storage provider. create\_datasource\_credential: Name of the credential object to be used in data source. create\_datasource\_s3\_bucket\_name: Name of the Amazon S3 bucket to use as the data source. create\_datasource\_s3\_region: Name of the Amazon S3 region where the given bucket is located. create\_datasource\_s3\_verify\_ssl: Whether to verify SSL connections. Supported values: create\_datasource\_true: Connect with SSL verification. create\_datasource\_false: Connect without verifying the SSL connection; for testing purposes, bypassing TLS errors, self-signed certificates, etc. The default value is create\_datasource\_true. create\_datasource\_s3\_use\_virtual\_addressing: Whether to use virtual addressing when referencing the Amazon S3 source. Supported values: create\_datasource\_true: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. create\_datasource\_false: Use path-style URI for requests. The default value is create\_datasource\_true. create\_datasource\_s3\_aws\_role\_arn: Amazon IAM Role ARN which has required S3 permissions that can be assumed for the given S3 IAM user. create\_datasource\_s3\_encryption\_customer\_algorithm: Customer encryption algorithm used encrypting data. create\_datasource\_s3\_encryption\_customer\_key: Customer encryption key to encrypt or decrypt data. create\_datasource\_hdfs\_kerberos\_keytab: Kerberos keytab file location for the given HDFS user. This may be a KIFS file. create\_datasource\_hdfs\_delegation\_token: Delegation token for the given HDFS user. create\_datasource\_hdfs\_use\_kerberos: Use kerberos authentication for the given HDFS cluster. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_azure\_storage\_account\_name: Name of the Azure storage account to use as the data source, this is valid only if tenant\_id is specified. create\_datasource\_azure\_container\_name: Name of the Azure storage container to use as the data source. create\_datasource\_azure\_tenant\_id: Active Directory tenant ID (or directory ID). create\_datasource\_azure\_sas\_token: Shared access signature token for Azure storage account to use as the data source. create\_datasource\_azure\_oauth\_token: OAuth token to access given storage container. create\_datasource\_azure\_use\_virtual\_addressing: Whether to use virtual addressing when referencing the Azure source. Supported values: create\_datasource\_true: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. create\_datasource\_false: Use path-style URI for requests. The default value is create\_datasource\_true. create\_datasource\_gcs\_bucket\_name: Name of the Google Cloud Storage bucket to use as the data source. create\_datasource\_gcs\_project\_id: Name of the Google Cloud project to use as the data source. create\_datasource\_gcs\_service\_account\_keys: Google Cloud service account keys to use for authenticating the data source. create\_datasource\_is\_stream: To load from Azure/GCS/S3 as a stream continuously. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_kafka\_topic\_name: Name of the Kafka topic to use as the data source. create\_datasource\_jdbc\_driver\_jar\_path: JDBC driver jar file location. This may be a KIFS file. create\_datasource\_jdbc\_driver\_class\_name: Name of the JDBC driver class. create\_datasource\_anonymous: Use anonymous connection to storage provider–DEPRECATED: this is now the default. Specify use\_managed\_credentials for non-anonymous connection. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_true. create\_datasource\_use\_managed\_credentials: When no credentials are supplied, we use anonymous access by default. If this is set, we will use cloud provider user settings. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_use\_https: Use HTTPS to connect to datasource if true, otherwise use HTTP. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_true. create\_datasource\_schema\_registry\_location: Location of Confluent Schema Registry in '\[storage\_path\[:storage\_port]]' format. create\_datasource\_schema\_registry\_credential: Confluent Schema Registry credential object name. create\_datasource\_schema\_registry\_port: Confluent Schema Registry port (optional). create\_datasource\_schema\_registry\_connection\_retries: Confluent Schema registry connection timeout (in secs). create\_datasource\_schema\_registry\_connection\_timeout: Confluent Schema registry connection timeout (in secs). The default value is an empty map.

Returns

Response object containing the result of the operation.

◆ createDatasource() \[4/4]

CreateDatasourceResponse & gpudb::GPUdb::createDatasource	(	const std::string &	name,
		const std::string &	location,
		const std::string &	userName,
		const std::string &	password,
		const std::map\< std::string, std::string > &	options,
		CreateDatasourceResponse &	response\_ ) const

Creates a data source, which contains the location and connection information for a data store that is external to the database.

Parameters

\[in]	name	Name of the data source to be created.
\[in]	location	Location of the remote storage in 'storage\_provider\_type://\[storage\_path\[:storage\_port]]' format. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'jdbc', 'kafka', 'confluent', and 's3'.
\[in]	userName	Name of the remote system user; may be an empty string.
\[in]	password	Password for the remote system user; may be an empty string.
\[in]	options	Optional parameters. create\_datasource\_skip\_validation: Bypass validation of connection to remote source. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_connection\_timeout: Timeout in seconds for connecting to this storage provider. create\_datasource\_wait\_timeout: Timeout in seconds for reading from this storage provider. create\_datasource\_credential: Name of the credential object to be used in data source. create\_datasource\_s3\_bucket\_name: Name of the Amazon S3 bucket to use as the data source. create\_datasource\_s3\_region: Name of the Amazon S3 region where the given bucket is located. create\_datasource\_s3\_verify\_ssl: Whether to verify SSL connections. Supported values: create\_datasource\_true: Connect with SSL verification. create\_datasource\_false: Connect without verifying the SSL connection; for testing purposes, bypassing TLS errors, self-signed certificates, etc. The default value is create\_datasource\_true. create\_datasource\_s3\_use\_virtual\_addressing: Whether to use virtual addressing when referencing the Amazon S3 source. Supported values: create\_datasource\_true: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. create\_datasource\_false: Use path-style URI for requests. The default value is create\_datasource\_true. create\_datasource\_s3\_aws\_role\_arn: Amazon IAM Role ARN which has required S3 permissions that can be assumed for the given S3 IAM user. create\_datasource\_s3\_encryption\_customer\_algorithm: Customer encryption algorithm used encrypting data. create\_datasource\_s3\_encryption\_customer\_key: Customer encryption key to encrypt or decrypt data. create\_datasource\_hdfs\_kerberos\_keytab: Kerberos keytab file location for the given HDFS user. This may be a KIFS file. create\_datasource\_hdfs\_delegation\_token: Delegation token for the given HDFS user. create\_datasource\_hdfs\_use\_kerberos: Use kerberos authentication for the given HDFS cluster. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_azure\_storage\_account\_name: Name of the Azure storage account to use as the data source, this is valid only if tenant\_id is specified. create\_datasource\_azure\_container\_name: Name of the Azure storage container to use as the data source. create\_datasource\_azure\_tenant\_id: Active Directory tenant ID (or directory ID). create\_datasource\_azure\_sas\_token: Shared access signature token for Azure storage account to use as the data source. create\_datasource\_azure\_oauth\_token: OAuth token to access given storage container. create\_datasource\_azure\_use\_virtual\_addressing: Whether to use virtual addressing when referencing the Azure source. Supported values: create\_datasource\_true: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. create\_datasource\_false: Use path-style URI for requests. The default value is create\_datasource\_true. create\_datasource\_gcs\_bucket\_name: Name of the Google Cloud Storage bucket to use as the data source. create\_datasource\_gcs\_project\_id: Name of the Google Cloud project to use as the data source. create\_datasource\_gcs\_service\_account\_keys: Google Cloud service account keys to use for authenticating the data source. create\_datasource\_is\_stream: To load from Azure/GCS/S3 as a stream continuously. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_kafka\_topic\_name: Name of the Kafka topic to use as the data source. create\_datasource\_jdbc\_driver\_jar\_path: JDBC driver jar file location. This may be a KIFS file. create\_datasource\_jdbc\_driver\_class\_name: Name of the JDBC driver class. create\_datasource\_anonymous: Use anonymous connection to storage provider–DEPRECATED: this is now the default. Specify use\_managed\_credentials for non-anonymous connection. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_true. create\_datasource\_use\_managed\_credentials: When no credentials are supplied, we use anonymous access by default. If this is set, we will use cloud provider user settings. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_false. create\_datasource\_use\_https: Use HTTPS to connect to datasource if true, otherwise use HTTP. Supported values: create\_datasource\_true create\_datasource\_false The default value is create\_datasource\_true. create\_datasource\_schema\_registry\_location: Location of Confluent Schema Registry in '\[storage\_path\[:storage\_port]]' format. create\_datasource\_schema\_registry\_credential: Confluent Schema Registry credential object name. create\_datasource\_schema\_registry\_port: Confluent Schema Registry port (optional). create\_datasource\_schema\_registry\_connection\_retries: Confluent Schema registry connection timeout (in secs). create\_datasource\_schema\_registry\_connection\_timeout: Confluent Schema registry connection timeout (in secs). 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).