Chapter 3. Using data connections
3.1. Adding a data connection to your data science project
You can enhance your data science project by adding a connection to a data source. When you want to work with a very large data sets, you can store your data in an S3-compatible object storage bucket, so that you do not fill up your local storage. You also have the option of associating the data connection with an existing workbench that does not already have a connection.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project that you can add a data connection to.
- You have access to S3-compatible object storage.
- If you intend to add the data connection to an existing workbench, you have saved any data in the workbench to avoid losing work.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project that you want to add a data connection to.
A project details page opens.
- Click the Data connections tab.
Click Add data connection.
The Add data connection dialog opens.
- Enter a name for the data connection.
- In the Access key field, enter the access key ID for your S3-compatible object storage provider.
- In the Secret key field, enter the secret access key for the S3-compatible object storage account you specified.
- In the Endpoint field, enter the endpoint of your S3-compatible object storage bucket.
- In the Region field, enter the default region of your S3-compatible object storage account.
- In the Bucket field, enter the name of your S3-compatible object storage bucket.
- Optional: From the Connected workbench list, select a workbench to connect.
- Click Add data connection.
Verification
- The data connection that you added appears on the Data connections tab for the project.
- If you selected a workbench, the workbench is visible in the Connected workbenches column on the Data connections tab for the project.
3.2. Deleting a data connection
You can delete data connections from your data science projects to help you remove connections that are no longer relevant to your work.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project with a data connection.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project that you want to delete the data connection from.
A project details page opens.
- Click the Data connections tab.
Click the action menu (⋮) beside the data connection that you want to delete and then click Delete data connection.
The Delete data connection dialog opens.
- Enter the name of the data connection in the text field to confirm that you intend to delete it.
- Click Delete data connection.
Verification
- The data connection that you deleted is no longer displayed on the Data connections tab for the project.
3.3. Updating a connected data source
To use an existing data source with a different workbench, you can change the data source that is connected to your project’s workbench.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project, created a workbench, and you have defined a data connection.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project whose data source you want to change.
A project details page opens.
- Click the Data connections tab.
Click the action menu (⋮) beside the data source that you want to change and then click Edit data connection.
The Edit data connection dialog opens.
- In the Connected workbench section, select an existing workbench from the list.
- Click Update data connection.
Verification
- The updated data connection is displayed on the Data connections tab for the project.
- You can access your S3 data source using environment variables in the connected workbench.
