ibm-research/WatsonxDocsQARetrieval huggingface dataset:
# IBM Db2 on Cloud connection #

To access your data in IBM Db2 on Cloud, you must create a connection asset for it\.

Db2 on Cloud is an SQL database that is managed by IBM Cloud and is provisioned for you in the cloud\.

## Create a connection to Db2 on Cloud ##

To create the connection asset, you need the following connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Username and password

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Db2 on Cloud connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  Notebooks\. Click **Read data** on the **Code snippets** pane to get the connection credentials and load the data into a data structure\. See [Load data from data source connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/load-and-access-data.html#conns)\.
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Db2 on Cloud setup ##

[Getting started with Db2 on Cloud](https://cloud.ibm.com/docs/Db2onCloud?topic=Db2onCloud-getting-started)

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [ Structured Query Language (SQL)](https://www.ibm.com/docs/SSFMBX/com.ibm.swg.im.dashdb.sql.ref.doc/doc/c0004100.html) topic in the Db2 on Cloud documentation for the correct syntax\.

## Learn more ##

<!-- <ul> -->

 *  [Db2 on Cloud documentation](https://cloud.ibm.com/docs/Db2onCloud?topic=Db2onCloud-about)
 *  [SSL connectivity](https://cloud.ibm.com/docs/Db2onCloud?topic=Db2onCloud-ssl_support)

<!-- </ul> -->

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Apache Derby connection #

To access your data in Apache Derby, create a connection asset for it\.

Apache Derby is a relational database management system developed by the Apache Software Foundation\.

## Create a connection to Apache Derby ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Apache Derby connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Apache Derby setup ##

[Apache Derby installation](https://db.apache.org/derby/papers/DerbyTut/install_software.html#derby_download)

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [Apache Derby documentation](https://db.apache.org/derby/docs/10.8/ref/index.html) for the correct syntax\.

## Learn more ##

[Apache Derby documentation](https://db.apache.org/derby/papers/DerbyTut/install_software.html#derby)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Dropbox connection #

To access your data in Dropbox, create a connection asset for it\.

Dropbox is a cloud storage service that lets you host and synchronize files on your devices\.

## Create a connection to Dropbox ##

To create the connection asset, you need an Access token\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Dropbox connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator (Synthetic Data Generator service)

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Dropbox setup ##

[Dropbox plans](https://www.dropbox.com/plans)

## Supported file types ##

The Dropbox connection supports these file types: Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, and XML\.

## Learn more ##

[Dropbox quick start guides](https://help.dropbox.com/guide)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Elasticsearch connection #

To access your data in Elasticsearch, create a connection asset for it\.

Elasticsearch is a distributed, open source search and analytics engine\. Use the Elasticsearch connection to access JSON documents in Elasticsearch indexes\.

## Supported versions ##

Elasticsearch version 6\.0 or later

## Create a connection to Elasticsearch ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Username and password  
    (Optional) Anonymous access
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Elasticsearch connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Elasticsearch setup ##

[Set up Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html)

## Restrictions ##

<!-- <ul> -->

 *  For Elasticsearch versions earlier than version 7, read is limited to 10,000 rows\.
 *  For Data Refinery, the only supported action on the target file is to append all the rows of the Data Refinery flow output to the existing data set\.

<!-- </ul> -->

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [Elasticsearch Guide for SQL](https://www.elastic.co/guide/en/elasticsearch/reference/current/xpack-sql.html) for the correct syntax\.

## Learn more ##

<!-- <ul> -->

 *  [Elasticsearch](https://www.elastic.co/elasticsearch/)
 *  [Elastic Docs](https://www.elastic.co/guide/en/elastic-stack/current/overview.html)

<!-- </ul> -->

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Generic S3 connection #

To access your data from a storage service that is compatible with the Amazon S3 API, create a connection asset for it\.

## Create a Generic S3 connection ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  **Endpoint URL**: The endpoint URL to access to S3
 *  **Bucket**(optional): The name of the bucket that contains the files
 *  **Region** (optional): S3 region\. Specify a region that matches the regional endpoint\.
 *  **Access key**: The access key (username) that authorizes access to S3
 *  **Secret key**: The password associated with the Access key ID that authorizes access to S3
 *  The SSL certificate of the trusted host\. The certificate is required when the host certificate is not signed by a known certificate authority\.
 *  **Disable chunked encoding**: Select if the storage does not support chunked encoding\.
 *  **Enable global bucket access**: Consult the documentation for your S3 data source for whether to select this property\.
 *  **Enable path style access**: Consult the documentation for your S3 data source for whether to select this property\.

<!-- </ul> -->

### Choose the method for creating a connection based on where you are in the platform ###

**In a project**  
Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space**  
Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use the Generic S3 connection in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Generic S3 connection setup ##

For setup information, consult the documentation of the S3\-compatible data source that you are connecting to\.

## Supported file types ##

The Generic S3 connection supports these file types: Avro, CSV, delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, and XML\.

**Related connection**: [Amazon S3 connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-amazon-s3.html)

**Parent topic**: [Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Greenplum connection #

To access your data in Greenplum, you must create a connection asset for it\.

Greenplum is a massively parallel processing (MPP) database server that supports next generation data warehousing and large\-scale analytics processing\.

## Supported versions ##

Greenplum 3\.2\+

## Create a connection to Greenplum ##

To create the connection asset, you need the following connection details:

<!-- <ul> -->

 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Greenplum connections in the following workspaces and tools:

<!-- <ul> -->

 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Greenplum setup ##

[Greenplum Database Installation Guide](https://docs.vmware.com/en/VMware-Greenplum/5/greenplum-database/install_guide-install_guide.html)

## Restriction ##

For SPSS Modeler, you can use this connection only to import data\. You cannot export data to this connection or to a Greenplum connected data asset\.

## Learn more ##

<!-- <ul> -->

 *  [Greenplum database](https://greenplum.org/)
 *  [Greenplum documentation](https://docs.Greenplum.org/6-8/common/gpdb-features.html)

<!-- </ul> -->

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Apache HDFS connection #

To access your data in Apache HDFS, create a connection asset for it\.

Apache Hadoop Distributed File System (HDFS) is a distributed file system that is designed to run on commodity hardware\. Apache HDFS was formerly Hortonworks HDFS\.

## Create a connection to Apache HDFS ##

To create the connection asset, you need these connection details\. The WebHDFS URL is required\.  
The available properties in the connection form depend on whether you select **Connect to Apache Hive** so that you can write tables to the Hive data source\.

<!-- <ul> -->

 *  WebHDFS URL to access HDFS\.
 *  Hive host: Hostname or IP address of the Apache Hive server\.
 *  Hive database: The database in Apache Hive\.
 *  Hive port number: The port number of the Apache Hive server\. The default value is `10000`\.
 *  Hive HTTP path: The path of the endpoint such as gateway/default/hive when the server is configured for HTTP transport mode\.
 *  SSL certificate (if required by the Apache Hive server)\.

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Apache HDFS connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Apache HDFS setup ##

[Install and set up a Hadoop cluster](https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#Prerequisites)

## Supported file types ##

The Apache HDFS connection supports these file types: Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, and XML\.

## Learn more ##

[Apache HDFS Users Guide](https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Apache Hive connection #

To access your data in Apache Hive, you must create a connection asset for it\.

Apache Hive is a data warehouse software project that provides data query and analysis and is built on top of Apache Hadoop\.

## Supported versions ##

Apache Hive 1\.0\.x, 1\.1\.x, 1\.2\.x\. 2\.0\.x, 2\.1\.x, 3\.0\.x, 3\.1\.x\.

## Create a connection to Apache Hive ##

To create the connection asset, you need the following connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  HTTP path (Optional): The path of the endpoint such as the gateway, default, or hive if the server is configured for the HTTP transport mode\.
 *  If required by the database server, the SSL certificate

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use the Apache Hive connection in the following workspaces and tools:

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Apache Hive setup ##

[Apache Hive installation and configuration](https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-InstallationandConfiguration)

## Restriction ##

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [SQL Operations](https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-SQLOperations) in the Apache Hive documentation for the correct syntax\.

## Learn more ##

[Apache Hive documentation](https://cwiki.apache.org/confluence/display/Hive/GettingStarted)

**Parent topic**: [Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# HTTP connection #

To access your data from a URL, create an HTTP connection asset for it\.

## Supported file ##

Use the full path in the URL to the file that you want to read\. You cannot browse for files\.

## Certificates ##

Enter the SSL certificate of the host to be trusted\. The SSL certificate is needed only when the host certificate is not signed by a known certificate authority\.

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use HTTP connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Notebooks\. Click **Read data** on the **Code snippets** pane to get the connection credentials and load the data into a data structure\. See [Load data from data source connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/load-and-access-data.html#conns)\.
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Restriction ##

You can use this connection only for source data\. You cannot write to data or export data with this connection\.

## Supported file types ##

The HTTP connection supports these file types: Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, and XML\.

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Looker connection #

To access your data in Looker, create a connection asset for it\.

Looker is a business intelligence software and big data analytics platform that helps you explore, analyze and share real\-time business analytics\.

## Create a connection to Looker ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Hostname or IP address
 *  Port number of the Looker server
 *  Client ID and Client secret

<!-- </ul> -->

Before you configure the connection, set up API3 credentials for your Looker instance\. For details, see [Looker API Authentication](https://www.ibm.com/links?url=https%3A%2F%2Fdocs.looker.com%2Freference%2Fapi-and-integration%2Fapi-auth)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Looker connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Looker setup ##

[Set up and administer Looker](https://docs.looker.com/admin-options)

## Restriction ##

You can use this connection only for source data\. You cannot write to data or export data with this connection\.

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the Looker documentation, [Using SQL Runner](https://docs.looker.com/data-modeling/learning-lookml/sql-runner-create-queries), for the correct syntax\.

## Supported file types ##

The Looker connection supports these file types: CSV, Delimited text, Excel, JSON\.

## Learn more ##

[Looker documentation](https://docs.looker.com/)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# MariaDB connection #

To access your data in MariaDB, create a connection asset for it\.

MariaDB is an open source relational database\. You can use the MariaDB connection to connect to either a MariaDB server or to a Microsoft Azure Database for MariaDB service in the cloud\.

## Supported versions ##

<!-- <ul> -->

 *  MariaDB server: 10\.5\.5
 *  Microsoft Azure Database for MariaDB: 10\.3

<!-- </ul> -->

## Create a connection to MariaDB ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use MariaDB connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## MariaDB setup ##

Setup depends on whether you are connecting from a local MariaDB server or a Microsoft Azure Database for MariaDB database service in the cloud\.

<!-- <ul> -->

 *  MariaDB server: [MariaDB Administration](https://mariadb.com/kb/en/mariadb-administration/)
 *  Microsoft Azure Database for MariaDB: [Quickstart: Create an Azure Database for MariaDB server by using the Azure portal](https://docs.microsoft.com/en-us/azure/mariadb/quickstart-create-mariadb-server-database-using-azure-portal)

<!-- </ul> -->

## Learn more ##

<!-- <ul> -->

 *  [MariaDB Foundation](https://mariadb.org/)
 *  [Microsoft Azure Database for MariaDB](https://azure.microsoft.com/en-us/services/mariadb/)

<!-- </ul> -->

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# IBM Cloud Databases for MongoDB connection #

To access your data in IBM Cloud Databases for MongoDB, create a connection asset for it\.

IBM Cloud Databases for MongoDB is a MongoDB database that is managed by IBM Cloud\. It uses a JSON document store with a rich query and aggregation framework\.  

## Supported editions ##

<!-- <ul> -->

 *  MongoDB Community Edition
 *  MongoDB Enterprise Edition

<!-- </ul> -->

## Create a connection to IBM Cloud Databases for MongoDB ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Authentication database: The name of the database in which the user was created\.
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use IBM Cloud Databases for MongoDB connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## IBM Cloud Databases for MongoDB setup ##

[Getting Started Tutorial](https://cloud.ibm.com/docs/databases-for-mongodb?topic=databases-for-mongodb-getting-started-tutorial)

## Restrictions ##

<!-- <ul> -->

 *  You can only use this connection for source data\. You cannot write to data or export data with this connection\.
 *  MongoDB Query Language (MQL) is not supported\.

<!-- </ul> -->

**Related connection**: [MongoDB connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-mongo.html)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# MySQL connection #

To access your data in MySQL, create a connection asset for it\.

MySQL is an open\-source relational database management system\.

## Supported versions ##

<!-- <ul> -->

 *  MySQL Enterprise Edition 5\.0\+
 *  MySQL Community Edition 4\.1, 5\.0, 5\.1, 5\.5, 5\.6, 5\.7

<!-- </ul> -->

## Create a connection to MySQL ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP Address
 *  Port number
 *  Character Encoding
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use MySQL connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Decision Optimization
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [MySQL documentation](https://dev.mysql.com/doc/) for the correct syntax\.

## MySQL setup ##

[MySQL Installation ](https://dev.mysql.com/doc/mysql-getting-started/en/)

## Learn more ##

[MySQL documentation](https://dev.mysql.com/doc/)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# OData connection #

To access your data in OData, create a connection asset for it\.

The OData (Open Data) protocol is a REST\-based data access protocol\. The OData connection reads data from a data source that uses the OData protocol\.

## Supported versions ##

The OData connection is supported on OData protocol version 2 or version 4\.

## Create a connection to OData ##

To create the connection asset, you need these connection details:

Credentials type:

<!-- <ul> -->

 *  API Key
 *  Basic
 *  None

<!-- </ul> -->

Encryption:  
SSL certificate (if required by the database server)

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use the OData connection in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## OData setup ##

To set up the OData service, see [How to Use Web API OData to Build an OData V4 Service without Entity Framework](https://www.odata.org/blog/how-to-use-web-api-odata-to-build-an-odata-v4-service-without-entity-framework/)\.

## Restrictions ##

<!-- <ul> -->

 *  For Data Refinery, you can use this connection only as a source\. You cannot use this connection as a target connection or as a target connected data asset\.
 *  For SPSS Modeler, you cannot create new entity sets\.

<!-- </ul> -->

## Learn more ##

[www\.odata\.org](https://www.odata.org/)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# PostgreSQL connection #

To access your data in PostgreSQL, you must create a connection asset for it\.

PostgreSQL is an open source and customizable object\-relational database\.

## Supported versions ##

<!-- <ul> -->

 *  PostgreSQL 15\.0 and later
 *  PostgreSQL 14\.0 and later
 *  PostgreSQL 13\.0 and later
 *  PostgreSQL 12\.0 and later
 *  PostgreSQL 11\.0 and later
 *  PostgreSQL 10\.1 and later
 *  PostgreSQL 9\.6 and later

<!-- </ul> -->

## Create a connection to PostgreSQL ##

To create the connection asset, you need the following connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

For **Private connectivity**, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a [secure connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use PostgreSQL connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## PostgreSQL setup ##

[PostgreSQL installation](https://www.pgadmin.org/docs/pgadmin4/latest/getting_started.html)

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [SQL Syntax](https://www.postgresql.org/docs/current/sql-syntax.html) in the PostgreSQL documentation\.

## Learn more ##

[PostgreSQL documentation](https://www.postgresql.org/docs/)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Presto connection #

To access your data in Presto, create a connection asset for it\.

Presto is a fast and reliable SQL engine for Data Analytics and the Open Lakehouse\.

## Supported versions ##

<!-- <ul> -->

 *  Version 0\.279 and earlier

<!-- </ul> -->

## Create a connection to Presto ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Hostname or IP address
 *  Port
 *  Username
 *  Password (required if you connect to Presto with SSL enabled)
 *  SSL certificate (if required by the Presto server)

<!-- </ul> -->

### Connecting to Presto within IBM watsonx\.data ###

To connect to a Presto server within watsonx\.data on IBM Cloud, use these connection details:

<!-- <ul> -->

 *  Username: `ibmlhapikey`
 *  Password (for SSL\-enabled, which is the default): An IBM Cloud API key\. For more information, see [Connecting to Presto server](https://cloud.ibm.com/docs/watsonxdata?topic=watsonxdata-con-presto-serv)\.

<!-- </ul> -->

To connect to a Presto server within watsonx\.data on Cloud Pak for Data or stand\-alone watsonx\.data, use the username and password that you use for the watsonx\.data console\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project**  
Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space**  
Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.  

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use the Presto connection in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Presto setup ##

To set up Presto, see [Presto installation](https://prestodb.io/docs/current/installation.html)\.

## Restriction ##

You can use this connection only for source data\. You cannot write to data or export data with this connection\.

## Limitation ##

The Presto connection does not support the Apache Cassandra Time data type\.

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [SQL Statement Syntax](https://prestodb.io/docs/current/sql.html) for the correct syntax\.

## Learn more ##

[Presto documentation](https://prestodb.io/docs/current/index.html)

**Parent topic**: [Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->
# Amazon Redshift connection #

To access your data in Amazon Redshift, create a connection asset for it\.

Amazon Redshift is a data warehouse product that forms part of the larger cloud\-computing platform Amazon Web Services (AWS)\.

## Create a connection to Amazon Redshift ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Username and password
 *  SSL certificate (if required by the database server)

<!-- </ul> -->

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Amazon Redshift connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Amazon Redshift setup ##

See [Amazon Redshift setup prerequisites](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-prereq.html) for setup information\.

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [ Amazon Redshift documentation](https://docs.aws.amazon.com/redshift/latest/dg/cm_chap_SQLCommandRef.html) for the correct syntax\.

## Learn more ##

[Amazon Redshift documentation](https://docs.aws.amazon.com/redshift/index.html)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->