Adding a connected folder asset to a project

Last updated: Jun 21, 2024

You can create a connected folder asset based on a path within an IBM Cloud Object Storage system that is accessed through a connection. You can view the files and subfolders that share the path with the connected folder asset. The files that you can view within the connected folder asset are not themselves data assets. For example, you can create a connected folder asset for a path that contains news feeds that are continuously updated.

Required permissions: You must have the Admin or Editor role in the project to add a connected folder asset.

Watch this video to see how to add a connected folder asset in a project, then follow the steps below the video.

This video provides a visual method to learn the concepts and tasks in this documentation.

To add a connected folder asset from a connection to a project:

If necessary, create a connection asset. Include an Access Key and a Secret Key to your IBM Cloud Object Storage connection to enable the downloading of files within the connected folder asset. If you're using an existing IBM Cloud Object Storage connection asset that doesn't have an Access Key and Secret Key, edit the connection asset and add them.
Click Import assets > Connected data.
Select an existing connection asset as the source of the data.
Select the folder you want and click Import.
Type a name and description.
Click Create. The connected folder asset appears on the project Assets page in the Data assets category.

Click the connected folder asset name to view the contents of the connected folder asset. Click the Eye icon Eye next to a file name to view the contents of the files within the folder that have these formats:

CSV
JSON
Parquet

You can refine the files within a connected folder asset and then save the result as a data asset. While viewing the connected folder asset, select a file and then click Prepare data.

You can view the files within the connected folder asset if the IBM Cloud Object Storage connection asset that's associated with the connected folder asset has an Access Key and a Secret Key (also known as HMAC credentials). For more information about HMAC credentials, see IBM Cloud Object Storage Service credentials.

Next steps

Parent topic: Adding data to a project