Adding catalog assets to a project

You can add a catalog asset to a project from within the project or from within the catalog.

Requirements

  1. Restrict collaborators to members of the same IBM Cloud account or company as the owner of the catalog. See Creating a project.

  2. You must have the following roles and permissions to copy a catalog asset to a project:

    • The Admin, Editor, or Viewer catalog collaborator role.
    • The Add catalog assets to projects user permission.

Restrictions

  1. You can't add an asset in these situations:

    • If the asset is blocked by data protection rules.
    • If the asset requires a private connection asset that you're not a member of.
    • If the asset requires a service instance, but you don't have permission to access or create one. You can ask a project admin for help.

  2. For relational data assets, if any of the columns are masked when you view the asset in the catalog, those columns are also masked when you add the asset to a project. All project collaborators see the asset the way it looks to the person who adds it from the catalog.

  3. Asset profile information is copied to the catalog. Data quality information is not copied.

If you add assets from a catalog in another account, profiles of structured data assets are not copied because the set of available data classes might be different. You must manually create a new profile.

Adding assets from a project to a project

  1. From your project, click Assets > Import assets > Catalog asset.

  2. Choose a catalog, then select the assets that you want to import.

  3. Click Import.

    If the assets require connections, the connection assets are automatically added to the project, including connections to IBM Cloud Object Storage for uploaded files.

The assets are added from the source project to the target project.

Adding assets from a catalog to a project

To add assets to a project from a catalog:

  1. From the catalog Browse page, search for the assets you want to add and select them.

  2. Click Add to project.
    The maximum number of catalog assets that you can add to project at a time is 50.

    • If you don't want to add a connection, you can remove it. All assets that require the removed connection are removed from the list of assets to add.
    • If any of the assets require a connection, those connections are listed and they get added to the project as connection assets, including connections to IBM Cloud Object Storage for uploaded files.

    Projects and spaces are archived after 90 days of inactivity to preserve resources. To work with archived projects or spaces again, unarchive them by opening them on the project or space page. Depending on the size of the project or space, unarchiving might take a varied amount of time.

    When you're inside of a governed catalog and click Add to project, information about new data protection rule enforcement protocol appears. You must acknowledge it to continue. The data protection rules apply only to deeply enforced assets (data sources that are integrated with deep enforcement solutions, such as IBM Data Virtualization or IBM watsonx.data). These rules don't apply to local assets. As a result, local assets, such as CSV files are unmasked in the catalog view.

  3. Choose the project name.

  4. If prompted, choose or create a required service instance.

  5. Click Add.

    The assets are added to the project.

Watch these short videos to see how to use catalog assets in a project.

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

Next steps