Using Data Assets in a Capsule

Attaching Data Assets to a Capsule

A single Data Asset can simultaneously be used by multiple users across many Capsules or Pipelines. This is possible because Data Assets are independent cloud storage.

From the IDE

1. Go to the data folder and click Manage Data Assets.

2. Attach/Detach Data side panel will appear. Click on the plus sign to attach the Data Asset.

If a Data Asset has been set as default in the App Builder, replace the Data Asset from the App Panel by clicking the replace button.

From a Cloud Workstation (e.g., RStudio, Terminal, or Jupyter)

1. Click Manage Data in the header of the Cloud Workstation.

2. Attach/Detach Data side panel will appear. Click on the plus sign to attach the Data Asset.

When attaching an external Data Asset, the following points should be considered:

1. To link to an external Data Asset, you need to have an appropriate secret or Assumed Role in your Code Ocean account which grants access to the AWS S3 location. Code Ocean will automatically use the appropriate credentials to access the data without needing to explicitly add the secret or Assumed role to the Capsule environment.

2. Due to AWS S3 behavior, it takes time to reach files.

Viewing the Detail of the Data Asset when attaching

From the Attach/Detach Data page, metadata can be viewed without leaving the Cloud Workstation page.

To retrieve this information:

1. Hover over the data asset, which does not have to be attached

2. Click Data Details

While in the Cloud Workstation, the same Data information will display as on the Data dashboard.

After the Data Asset has been attached to the Capsule or Pipeline, you can find the Data details in the drop-down menu.

Renaming the Mounting Point (Folder)

After you have attached a Data Asset to your Capsule, you can change the name of the mounting point (that is, the folder name) in the Code Ocean IDE.

1. Hover over the attached dataset under the /data folder.

2. Click on the down arrow.

3. Select Rename.