/show/datasource

URL: http://<db.host>:<db.port>/show/datasource

Shows information about a specified data source or all data sources.

Input Parameter Description

Name Type Description
name string Name of the data source for which to retrieve information. The name must refer to a currently existing data source. If '*' is specified, information about all data sources will be returned.
options map of string to strings Optional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

Name Type Description
status String 'OK' or 'ERROR'
message String Empty if success or an error message
data_type String 'show_datasource_response' or 'none' in case of an error
data String Empty string
data_str JSON or String

This embedded JSON represents the result of the /show/datasource endpoint:

Name Type Description
datasource_names array of strings The data source names.
storage_provider_types array of strings

The storage provider type of the data sources named in output parameter datasource_names.

Possible List Entries Description
hdfs Apache Hadoop Distributed File System
s3 Amazon S3 bucket
additional_info array of maps of string to strings

Additional information about the respective data sources in output parameter datasource_names.

Possible List Entries Description
map of string to strings

The default value is an empty map ( {} ).

Possible Parameters (keys) Parameter Description
location Location of the remote storage in 'storage_provider_type://[storage_path[:storage_port]]' format
s3_bucket_name Name of the Amazon S3 bucket used as the data source
s3_region Name of the Amazon S3 region where the bucket is located
hdfs_kerberos_keytab Kerberos key for the given HDFS user
user_name Name of the remote system user
info map of string to strings Additional information.

Empty string in case of an error.