Adding a folder asset to a project

You can create a 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 folder asset. The files that you can view within the folder asset are not themselves data assets. For example, you can create a folder asset for a path that contains news feeds that are continuously updated.

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

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

Figure 1. Video iconCreate Folder Asset in a project
This video shows you how to add a folder asset in a project.

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

  1. 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 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.
  2. Click Add to project > Connected data.
  3. Select an existing connection asset as the source of the data.

  4. If necessary, enter your personal credentials for locked data connections that are marked with a key icon (the key symbol for connections with personal credentials). This is a one-time step that permanently unlocks the connection for you. After you have unlocked the connection, the key icon is no longer displayed. See Adding connections to projects.

  5. Select the folder you want and click Select.
  6. Add a name and description.
  7. Click Create. The folder asset appears on the project Assets page in the Data assets category.

Click the folder asset name to view the contents of the folder asset. Click the eye (eye icon) icon 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 files within a folder asset and then save the result as a data asset. While viewing the folder asset, select a file name and then click Refine.

You can download files from within the folder asset if the IBM Cloud Object Storage connection asset that’s associated with the 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