Chapter 3. Using connections
Chapter 3. Using connections 3.1. Adding a connection to your data science project You can enhance your data science project by adding a connection that contains the configuration parameters needed to connect to a data source or sink. When you want to work with a very large data sets, you can store your data in an S3-compatible object storage bucket or a URI-based repository, so that you do not fill up your local storage. You also have the option of associating the 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 OpenShift AI groups, you are part of the user group or admin group (for example, rhoai-users or rhoai-admins ) in OpenShift. You have created a data science project that you can add a connection to. You have access to S3-compatible object storage or a URI-based repository. If you intend to add the 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 connection to. A project details page opens. Click the Connections tab. Click Add connection . In the Add connection modal, select a Connection type . The S3 compatible object storage and URI options are pre-installed connection types. Additional options might be available if your OpenShift AI administrator added them. The Add connection form opens with fields specific to the connection type that you selected. Enter a unique name for the connection. A resource name is generated based on the name of the connection. A resource name is the label for the underlying resource in OpenShift. Optional: Edit the default resource name. Note that you cannot change the resource name after you create the connection. Optional: Provide a description of the connection. Complete the form depending on the connection type that you selected. For example: If you selected S3 compatible object storage as the connection type, configure the connection details: In the Access key field, enter the access key ID for the S3-compatible object storage provider. In the Secret key field, enter the secret access key for the S3-compatible object storage account that you specified. In the Endpoint field, enter the endpoint of your S3-compatible object storage bucket. Note Make sure to use the appropriate endpoint format. Improper formatting might cause connection errors or restrict access to storage resources. For more information about how to format object storage endpoints, see Overview of object storage endpoints . 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. Click Create . If you selected URI in the preceding step, in the URI field, enter the Uniform Resource Identifier (URI). Click Add connection . Verification The connection that you added appears on the Connections tab for the project. 3.2. Updating a connection You can edit the configuration of an existing connection as described in this procedure. Note Any changes that you make to a connection are not applied to dependent resources (for example, a workbench) until those resources are restarted, redeployed, or otherwise regenerated. Prerequisites You have logged in to Red Hat OpenShift AI. If you are using OpenShift AI groups, you are part of the user group or admin group (for example, rhoai-users or rhoai-admins ) in OpenShift. You have created a data science project, created a workbench, and you have defined a connection. Procedure From the OpenShift AI dashboard, click Data Science Projects . The Data Science Projects page opens. Click the name of the project that contains the connection that you want to change. A project details page opens. Click the Connections tab. Click the action menu ( ... ) beside the connection that you want to change and then click Edit . The Edit connection form opens. Make your changes. Click Save . Verification The updated connection is displayed on the Connections tab for the project. 3.3. Deleting a connection You can delete connections that are no longer relevant to your data science project. Prerequisites You have logged in to Red Hat OpenShift AI. If you are using OpenShift AI groups, you are part of the user group or admin group (for example, rhoai-users or rhoai-admins ) in OpenShift. You have created a data science project with a 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 connection from. A project details page opens. Click the Connections tab. Click the action menu ( ... ) beside the connection that you want to delete and then click Delete connection . The Delete connection dialog opens. Enter the name of the connection in the text field to confirm that you intend to delete it. Click Delete connection . Verification The connection that you deleted is no longer displayed on the Connections page for the project.