ibm-research/WatsonxDocsQARetrieval huggingface dataset:
# Enterprise security #

An enterprise is a hierarchy of IBM Cloud accounts that contains a parent account at the highest level with child account groups as the middle level and optional individual accounts that you can add at the lowest level\. To provide security between the levels of accounts, enterprises isolate user and access management between the enterprise account and its child accounts\.

The users and their assigned access in the enterprise account are entirely separate from users in the child accounts, and no access is inherited between the two types of accounts\. User and access management in each enterprise and each account is entirely separate and must be managed by the account owner or a user given the Administrator role in the specific account\.

Resources and services within an enterprise function the same as in stand\-alone accounts\. Each account in an enterprise can contain resource groups that manage access to multiple resources\. For account security and how to use resource groups, see [IBM Cloud account security](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/security-account.html)\.

## Use cases ##

The user lists for each account are only visible to the users who are invited to that account\. Just because a user is invited and given access to manage the entire enterprise, it doesn't mean that they can view the users who are invited to each child account\.

Both user management and access management are entirely separate in each account and in the enterprise itself\. This separation means that users who manage your enterprise can't access account resources within the child accounts unless you specifically enable them to\. For example, your financial officer can have the Administrator role on the Billing account management service within the enterprise account\. The financial officer must be invited to a child account with the appropriate access rights to view offers or update spending limits for the child account\.

![Role inheritance for enterprises](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/enterprise_role_hierarchy.svg)

## Learn more ##

For an overview of enterprise accounts, see [IBM Cloud docs: What is an enterprise?](https://cloud.ibm.com/docs/account?topic=account-what-is-enterprise)

For step\-by\-step instructions for setting up an enterprise hierarchy of accounts, see [IBM Cloud docs: Setting up an enterprise](https://cloud.ibm.com/docs/account?topic=account-enterprise-tutorial)

For tips for setting up an enterprise, see [IBM Cloud docs: Best practices for setting up an enterprise](https://cloud.ibm.com/docs/account?topic=account-enterprise-best-practices)

**Parent topic:**[Security](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/security-overview.html)

<!-- </article "role="article" "> -->
# Managing users and access #

As the account owner or administrator, you add the people in your organization to the IBM Cloud account and then assign them access permissions using roles that provide access to the services that they need\.

## User management on IBM Cloud ##

People who work in IBM watsonx must have a valid IBMid and be a member of the IBM Cloud account\. Alternately, they must have a valid ID in a supported user registry\. User management includes adding users to the account and then assigning appropriate roles to provide access to the services and actions that they need\. See [Adding users to the account](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/setup-addl-users.html)\.

## Access management using IBM Cloud Identity and Access Management (IAM) ##

You control the actions that a user can perform for a specific service by assigning permissions with IBM Cloud IAM\. You create user access groups containing roles to provide permissions for users\. You can also assign roles and permissions to individual users\. If necessary, you can create custom roles to satisfy your business requirements\.

## Learn more ##

<!-- <ul> -->

 *  [Signing up for your organization's watsonx account](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/signup-wx.html#orgacct)
 *  [Logging in to watsonx\.ai through IBM Cloud App ID (beta)](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/signup-wx.html#appid)
 *  [IBM Cloud docs: Assigning access to resources by using access groups](https://cloud.ibm.com/docs/account?topic=account-access-getstarted)
 *  [IBM Cloud docs: Creating custom roles](https://cloud.ibm.com/docs/account?topic=account-custom-roles)
 *  [IBM Cloud docs: IAM access](https://cloud.ibm.com/docs/account?topic=account-userroles)
 *  [IBM Cloud docs: What is IBM Cloud Identity and Access Management](https://cloud.ibm.com/docs/account?topic=account-iamoverview)
 *  [IBM Cloud docs: Setting up access groups](https://cloud.ibm.com/docs/account?topic=account-groups)
 *  [IBM Cloud docs: Best practices for organizing resources and assigning access](https://cloud.ibm.com/docs/account?topic=account-account_setup&interface=ui)

<!-- </ul> -->

**Parent topic:**[Setting up the platform](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/setup-platform.html)

<!-- </article "role="article" "> -->
# Video library #

Watch short videos for data scientists, data engineers, and data stewards to learn about watsonx\. The videos and accompanying tutorials are task\-focused and provide hands\-on experience by using the tools in watsonx\.

Note: These videos provides a visual method to learn the concepts and tasks in this documentation\. If you are having difficulty viewing any of the videos on this page, visit the **[Video playlists](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/videos-wx-docs.html)** page\.

#### First watch the  IBM watsonx\.ai overview video\. ####

![Watch Video](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/images/lc-video.png) Select any video from the lists below to watch here\.

## Quick start ##

IBM watsonx\.ai overview

<!-- <ul> -->

 *   Classify text
 *   Summarize large, complex documents
 *   Generate content
 *   Extract text from complex documents

<!-- </ul> -->

Get started

<!-- <ul> -->

 *   Create a project
 *   Collaborate in projects
 *   Tour the samples collection
 *   Load and analyze public data sets

<!-- </ul> -->

Work with data

<!-- <ul> -->

 *   Prepare data with Data Refinery  
    
 *   Generate synthetic tabular data  
    
 *   Analyze data in a Jupyter notebook  
    
<!-- </ul> -->

IBM watsonx\.governance

<!-- <ul> -->

 *   Track a model in an AI use case  
    
 *   Evaluate a prompt template  
    
 *   Track a prompt template  
    
<!-- </ul> -->

Work with foundation models

<!-- <ul> -->

 *   Prompt a foundation model using Prompt Lab
 *   Prompt tips: Get started prompting foundation models
 *   Introduction to the retrieval\-augmented generation pattern
 *   Tune a foundation model

<!-- </ul> -->

Build models

<!-- <ul> -->

 *   Build and deploy a model with AutoAI  
    
 *   Build and deploy a model in a Jupyter notebook  
    
 *   Build and deploy a model with SPSS Modeler
 *   Build and deploy a Decision Optimization model
 *   Create a pipeline to automate the lifecycle for a model

<!-- </ul> -->

<!-- </article "role="article" "> -->
# Visualizations of assets #

In your project, you can create visualizations of data assets to further explore and discover insights\. To create and view visualizations, open a data asset and go to the **Visualization** tab\.

## Requirements and restrictions ##

You can view the visualization of assets under the following circumstances\.

<!-- <ul> -->

 *  **Required permissions**  
    To view this page, you can have any role in a project. To edit or update information on this page, you must have the **Editor** or **Admin** role.
 *  **Workspaces**  
    You can view the asset visualization in projects.
 *  **Types of assets**  
    These types of assets create a visualization:
    
    <!-- <ul> -->
    
     *  Data asset from file: Avro, CSV, JSON, Parquet, TSV, SAV, Microsoft Excel .xls and .xlsx files, SAS, delimited text files
     *  Connected data assets
    
    <!-- </ul> -->
    
<!-- </ul> -->

<!-- <ul> -->

 *  **Collaboration**  
    Visualization assets created by a user can be viewed or edited by other collaborators of the same project, depending on the assigned permissions.

<!-- </ul> -->

## Learn more ##

<!-- <ul> -->

 *  [Visualizing your data](https://dataplatform.cloud.ibm.com/docs/content/dataview/idh_idc_cg_help_main.html)

<!-- </ul> -->

**Parent topic:**[Asset types and properties](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/assets.html)

<!-- </article "role="article" "> -->
# IBM watsonx APIs #

You can perform many of the tasks for watsonx with APIs\.

## APIs for managing assets ##

You can use a collection of REST APIs to manage data\-related assets and the people who need to use these assets\. See [Watson Data API](http://ibm.biz/wdp-api)\.

## Connections in the Watson Data API ##

Use the Watson Data API to create a connection in a catalog or project\. See [Connections in the Watson Data API](https://cloud.ibm.com/apidocs/watson-data-api#connections)\.

## Python library for foundation models ##

For the full library reference, see [Foundation models Python library](https://ibm.github.io/watson-machine-learning-sdk/foundation_models.html)\.

For examples of how to use the foundation models Python library, see [Foundation models Python library](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/fm-python-lib.html)\.

## APIs for machine learning ##

Watson Machine Learning allows for managing spaces, deployments, and assets programmatically by using:

<!-- <ul> -->

 *  [REST API](https://cloud.ibm.com/apidocs/machine-learning)
 *  [Python client library](https://ibm.github.io/watson-machine-learning-sdk/)

<!-- </ul> -->

For links to sample Jupyter Notebooks that demonstrate how to manage spaces, deployments, and assets programmatically, see [Machine Learning Python client samples and examples](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-samples-overview.html)\.

## APIs for factsheets ##

AI Factsheets allows managing settings, model entries, and report templates programmatically by using:

<!-- <ul> -->

 *  [REST API](https://cloud.ibm.com/apidocs/factsheets)
 *  [Python client library](https://s3.us.cloud-object-storage.appdomain.cloud/factsheets-client/index.html#factsheet-asset-elements)

<!-- </ul> -->

## Learn more ##

<!-- <ul> -->

 *  [Watson Data API](https://cloud.ibm.com/apidocs/watson-data-api)
 *  [Watson Machine Learning API docs](https://cloud.ibm.com/apidocs/machine-learning)
 *  [AI Factsheets API docs](https://cloud.ibm.com/apidocs/factsheets)

<!-- </ul> -->

<!-- </article "role="article" "> -->
# Administering a project #

If you have the **Admin** role in a project, you can perform administrative tasks for the project\.

<!-- <ul> -->

 *  [Manage collaborators](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/collaborate.html)
 *  [Mark data assets in project as sensitive](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/mark-sensitive.html)
 *  [Stop all active runtimes](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/manage-envs-new.html#stop-active-runtimes)
 *  [Export a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/export-project.html)
 *  [Manage project access tokens](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/token.html)
 *  [Remove assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-assets.html#remove-asset)
 *  [Edit a locked asset](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-assets.html#editassets)
 *  [Delete the project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/admin-project.html?context=cdpaas&locale=en#delete-project)
 *  [Copy a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/admin-project.html?context=cdpaas&locale=en#copy-project)
 *  [Switch the platform for a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/switch-platform.html)

<!-- </ul> -->

Note: In the activity log, the user ID for some activities might display `icp4d-dev` instead of `admin`\.

## Delete a project ##

If you have the **Admin** role in a project, you can delete it\. All project assets, associated files in the project's storage, and the associated storage for the project are also deleted\. Data in a remote data source that is accessed through a connection is not affected\.

To delete a project, choose **Project > View All Projects** and then choose **Delete** from the **ACTIONS** menu next to the project name\.

## Copy a project ##

You can copy an existing project by [exporting it](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/export-project.html), and then [importing it](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/import-project.html) with a different name\.

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

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

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

Amazon RDS for MySQL is a MySQL relational database that runs on the Amazon Relational Database Service (RDS)\.

## Supported versions ##

MySQL database versions 5\.6 through 8\.0

## Create a connection to Amazon RDS for MySQL ##

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 RDS for MySQL 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)\.
 *  Decision Optimization
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Amazon RDS for MySQL setup ##

For setup instructions, see these topics:

<!-- <ul> -->

 *  [Creating an Amazon RDS DB Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html)
 *  [Connecting to a DB Instance Running the MySQL Database Engine](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ConnectToInstance.html)

<!-- </ul> -->

### Running SQL statements ###

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

## Learn more ##

[Amazon RDS for MySQL](https://aws.amazon.com/rds/mysql)

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

<!-- </article "role="article" "> -->
# Amazon RDS for Oracle connection #

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

Amazon RDS for Oracle is an Oracle relational database that runs on the Amazon Relational Database Service (RDS)\.

## Supported Oracle versions and editions ##

<!-- <ul> -->

 *  Oracle Database 19c (19\.0\.0\.0)
 *  Oracle Database 12c Release 2 (12\.2\.0\.1)
 *  Oracle Database 12c Release 1 (12\.1\.0\.2)

<!-- </ul> -->

## Create a connection to Amazon RDS for Oracle ##

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

<!-- <ul> -->

 *  Either the Oracle Service name or the Oracle System ID (SID) for the database\.
 *  Hostname or IP address of the database
 *  Port number of the database\. (Default is `1521`)
 *  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 ##

**Projects**

You can use Amazon RDS for Oracle connections in the following workspaces and tools:

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Amazon RDS for Oracle setup ##

To set up the Oracle database on Amazon, see these topics:

<!-- <ul> -->

 *  [Creating an Amazon RDS DB Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html)
 *  [Creating an Oracle DB instance and connecting to a database on an Oracle DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.Oracle.html)
 *  [Connecting to your Oracle DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ConnectToOracleInstance.html)

<!-- </ul> -->

## Learn more ##

[Amazon RDS for Oracle](https://aws.amazon.com/rds/oracle/)

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

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

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

Amazon RDS for PostgreSQL is a PostgreSQL relational database that runs on the Amazon Relational Database Service (RDS)\.

## Supported versions ##

PostgreSQL database versions 9\.4, 9\.5, 9\.6, 10, 11 and 12

## Create a connection to Amazon RDS for PostgreSQL ##

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 RDS for PostgreSQL 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> -->

## Amazon RDS for PostgreSQL setup ##

For setup instructions, see these topics:

<!-- <ul> -->

 *  [Creating an Amazon RDS DB Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html)
 *  [Connecting to a DB Instance Running the PostgreSQL Database Engine](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ConnectToPostgreSQLInstance.html)

<!-- </ul> -->

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [ Amazon RDS for PostgreSQL documentation](https://aws.amazon.com/rds/postgresql/) for the correct syntax\.

## Learn more ##

[Amazon RDS for PostgreSQL](https://aws.amazon.com/rds/postgresql/)

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

<!-- </article "role="article" "> -->
# Microsoft Azure SQL Database connection #

To access your data in a Microsoft Azure SQL Database, create a connection asset for it\.

Microsoft Azure SQL Database is a managed cloud database provided as part of Microsoft Azure\.

## Create a connection to Microsoft Azure SQL Database ##

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

<!-- <ul> -->

 *  Database name
 *  Hostname or IP address
 *  Port number
 *  Select **Use Active Directory** if the server has been set up to use Azure Active Directory authentication (Azure AD)\. Enter your Azure AD user and password\.
 *  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 Microsoft Azure SQL Database connections in the following workspaces and tools:

<!-- <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 [Azure SQL Database documentation](https://docs.microsoft.com/en-ca/azure/azure-sql/database/connect-query-content-reference-guide) for the correct syntax\.

## Microsoft Azure SQL Database setup ##

[Getting started with single databases in Azure SQL Database](https://docs.microsoft.com/en-ca/azure/azure-sql/database/quickstart-content-reference-guide)

## Learn more ##

[Azure SQL Database documentation](https://docs.microsoft.com/en-ca/azure/azure-sql/database/)

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

<!-- </article "role="article" "> -->
# Microsoft Azure Blob Storage connection #

To access your data in Microsoft Azure Blob Storage, create a connection asset for it\.

Azure Blob Storage is used for storing large amounts of data in the cloud\.

## Create a connection to Microsoft Azure Blob Storage ##

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

Connection string: Authentication is managed by the Azure portal access keys\.

### 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 Azure Blob Storage connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Azure Blob Storage connection string setup ##

Set up blob storage and access keys on the Microsoft Azure portal\. For instructions see:

<!-- <ul> -->

 *  [Quickstart: Upload, download, and list blobs with the Azure portal](https://docs.microsoft.com/en-us/azure/storage/blobs/storage-quickstart-blobs-portal)
 *  [Manage storage account access keys](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage)

<!-- </ul> -->

Example connection string, which you can find in the **ApiKeys** section of the container:

`DefaultEndpointsProtocol=https;AccountName=sampleaccount;AccountKey=samplekey;EndpointSuffix=core.windows.net`

## Supported file types ##

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

## Learn more ##

[Microsoft Azure](https://azure.microsoft.com)

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

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

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

Apache Cassandra is an open source, distributed, NoSQL database\.

## Supported versions ##

Apache Cassandra 2\.0 or later

## Create a connection to Apache Cassandra ##

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

<!-- <ul> -->

 *  Hostname or IP address
 *  Port number
 *  Keyspace
 *  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 Apache Cassandra connections in the following workspaces and tools:

<!-- <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> -->

## Apache Cassandra setup ##

<!-- <ul> -->

 *  [Installing Cassandra](https://cassandra.apache.org/doc/latest/getting_started/installing.html)
 *  [Configuring Cassandra](https://cassandra.apache.org/doc/latest/getting_started/configuring.html)
 *  [CREATE KEYSPACE](https://cassandra.apache.org/doc/latest/cql/ddl.html#create-keyspace)

<!-- </ul> -->

## Learn more ##

<!-- <ul> -->

 *  [cassandra\.apache\.org](https://cassandra.apache.org/)
 *  [Cassandra Documentation](https://cassandra.apache.org/doc/latest/architecture/overview.html)

<!-- </ul> -->

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

<!-- </article "role="article" "> -->
# Google Cloud Storage connection #

To access your data in Google Cloud Storage, create a connection asset for it\.

Google Cloud Storage is an online file storage web service for storing and accessing data on Google Cloud Platform Infrastructure\.

## Create a connection to Google Cloud Storage ##

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

<!-- <ul> -->

 *  Project ID
 *  Credentials: The contents of the Google service account key JSON file
 *  Client ID and Client secret
 *  Access token
 *  Refresh token

<!-- </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 Google Cloud Storage 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> -->

## Supported file types ##

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

## Learn more ##

[Google Cloud Storage documentation](https://cloud.google.com/storage/docs/introduction)

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

<!-- </article "role="article" "> -->
# IBM Cloudant connection #

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

Cloudant is a JSON document database available in IBM Cloud\.

## Create a connection to Cloudant ##

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

<!-- <ul> -->

 *  URL to the Cloudant database
 *  Database name
 *  Username and password

<!-- </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 Cloudant 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> -->

## Cloudant setup ##

To set up the Cloudant database on IBM Cloud, see [Getting started with IBM Cloudant](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-getting-started-with-cloudant)\.  
When you create your Cloudant service, for **Authentication method**, select **IAM and legacy credentials**\.

## Restriction ##

IBM Cloud Query (CQ) is not supported\.

## Learn more ##

[IBM Cloudant docs](https://cloud.ibm.com/docs/Cloudant)

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

<!-- </article "role="article" "> -->
# Cloudera Impala connection #

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

Cloudera Impala provides SQL queries directly on your Apache Hadoop data stored in HDFS or HBase\.

## Supported versions ##

Cloudera Impala 1\.3\+

## Create a connection to Cloudera Impala ##

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 Cloudera Impala connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Cloudera Impala setup ##

[Cloudera Impala installation](https://docs.cloudera.com/documentation/enterprise/5-14-x/topics/cm_ig_install_impala.html)

## 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 [Impala SQL Language Reference](https://docs.cloudera.com/documentation/enterprise/5-5-x/topics/impala_langref.html) for the correct syntax\.

## Learn more ##

[Cloudera Impala documentation](https://docs.cloudera.com/documentation/enterprise/5-5-x/topics/impala.html)

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

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

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

IBM Cloud Databases for MySQL extends the capabilities of MySQL by offering an auto\-scaling deployment system managed on IBM Cloud that delivers high availability, redundancy, and automated backups\. IBM Cloud Databases for MySQL was formerly known as *IBM Cloud Compose for MySQL*\.

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

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

<!-- <ul> -->

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

<!-- </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 MySQL connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## IBM Cloud Databases for MySQL setup ##

[IBM Cloud Databases for MySQL](https://cloud.ibm.com/catalog/services/compose-for-mysql)

## Restriction ##

For SPSS Modeler, you can use this connection only to import data\. You cannot export data to this connection or to an IBM Cloud Databases for MySQL connected data asset\.

## Learn more ##

[IBM Cloud Databases for MySQL Help](https://help.compose.com/docs/mysql-compose-for-mysql#section-compose-for-mysql-for-all)

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

<!-- </article "role="article" "> -->
# Microsoft Azure Cosmos DB connection #

To access your data in Microsoft Azure Cosmos DB, create a connection asset for it\.

Azure Cosmos DB is a fully managed NoSQL database service\.

## Create a connection to Microsoft Azure Cosmos DB ##

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

<!-- <ul> -->

 *  Hostname
 *  Port number
 *  Master key: The Azure Cosmos Database primary read\-write key

<!-- </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 Microsoft Azure Cosmos DB 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> -->

## Azure Cosmos DB setup ##

<!-- <ul> -->

 *  Set up Azure Cosmos DB: [Azure portal](https://docs.microsoft.com/en-us/azure/cosmos-db/create-cosmosdb-resources-portal)
 *  Secure access to data in Azure Cosmos DB: [Master keys](https://docs.microsoft.com/en-us/azure/cosmos-db/secure-access-to-data#master-keys)

<!-- </ul> -->

## Restrictions ##

Only the Core (SQL) API is supported\.

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [Azure Cosmos DB documentation](https://docs.microsoft.com/azure/cosmos-db/) for the correct syntax\.

## Learn more ##

[Azure Cosmos DB](https://azure.microsoft.com/en-us/services/cosmos-db/)

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

<!-- </article "role="article" "> -->
# IBM Data Virtualization Manager for z/OS connection #

To access your data in Data Virtualization Manager for z/OS, create a connection asset for it\.

Use the Data Virtualization Manager for z/OS connection to access data in your z/OS mainframe environment\.

## Supported versions ##

IBM Data Virtualization Manager for z/OS 1\.1\.0

## Create a connection to Data Virtualization Manager for z/OS ##

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

<!-- <ul> -->

 *  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 Data Virtualization Manager for z/OS connections in the following workspaces and tools:

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

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

<!-- </article "role="article" "> -->
# IBM Db2 Big SQL connection #

To access your data in IBM Db2 Big SQL, create a connection asset for it\.

IBM Db2 Big SQL is a high performance massively parallel processing (MPP) SQL engine for Hadoop that makes querying enterprise data from across the organization an easy and secure experience\.

## Supported versions ##

Db2 Big SQL for Version 4\.1\+

## Create a connection to IBM Db2 Big SQL ##

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 IBM Db2 Big SQL 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 Db2 Big SQL setup ##

[Installing IBM Db2 Big SQL](https://www.ibm.com/docs/SSCRJT_5.0.3/com.ibm.swg.im.bigsql.doc/doc/hdp_bigsql_versions.html)

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [ IBM Db2 Big SQL documentation](https://www.ibm.com/docs/SSCRJT_5.0.4/com.ibm.swg.im.bigsql.doc/doc/bi_sql_access.html) for the correct syntax\.

## Learn more ##

[Db2 Big SQL documentation](https://www.ibm.com/docs/en/db2-big-sql/5.0.3)

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

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