Importing a project
You can create a project that is preloaded with assets by importing the project.
Use one of these methods:
Watch the following video to see how to create a project from a ZIP file and from a GitHub repository.
This video provides a visual method to learn the concepts and tasks in this documentation.
Importing a project from a local file or sample
You can import a project that you previously exported.
If you created a project from file, you can create it from a project ZIP file on your local system. The compressed file that you select must be an exported ZIP file of a project from the same experience and the same or earlier software version than you are using. You can't export and import a project between on-premises software and as a service. You can't export and import a project between experiences, such as, watsonx and Data Fabric.
If the imported project contains metadata import assets that were imported to a catalog in the source Cloud Pak for Data instance, such metadata import assets are not imported to the new project on the target Cloud Pak for Data instance. These assets are not imported because the target catalog that was selected on the source system does not exist on the target system. After you import the project, you can duplicate metadata import assets and add them to a catalog that exists on the target system. For more information, see Duplicating a metadata import asset.
If you import a project with metadata enrichment assets from a different instance of the product, the contained assets might show assigned business terms that do not exist in the target instance. If ML-based term assignment for these assets was trained by using a catalog from the source instance, update the project settings to use a catalog that exists in the target instance.
If you import a project with connections that require personal credentials, you must unlock those connections after you import the project.
To create a project from a local file:
- From the navigation menu, choose Projects > All projects.
- Select Local file.
- Upload the project ZIP file or select a sample project.
- If the exported file that you select to import was encrypted, you must enter the password that was used for encryption to enable decrypting sensitive connection properties. If you enter an incorrect password, the project file imports successfully, but sensitive connection properties are falsely decrypted.
- You can optionally select these project configurations:
- Mark the project as sensitive. The project has a sensitive tag and project collaborators can't move data assets out of the project. You cannot change this setting after the project is created.
- Log project activity. Detailed project activity is tracked in a full activities log that you can download. You can enable or disable this option at any time on the project Settings page.
- Click Create.
Importing a project from a Git repository
You can import a project from a Git repository by using default Git integration or deprecated Git integration.
Before you begin
- Before you create a project with Git integration, you must understand the options that you have and the implications of choosing either option:
- Configure access to a Git repository to work in a local clone of a branch from the project’s remote repository. See Configure access to a Git repository.
Creating a project with a Git repository
To create a project with a Git repository:
- From the navigation menu, choose Projects > All projects.
- Click New project.
- Select Git integrated.
- Select the integration type:
- Default Git integration for true Git-based version control when working on files.
- Deprecated Git integration for Git integration with locking. Although you can still create and use projects with this integration type, this project creation option is deprecated.
You have these project configuration options:
- Either create a new empty project or import an existing project from a Git repository.
- Mark the project as sensitive. You cannot change this setting after the project is created.
- Log project activity. You can enable or disable this option at any time on the project Settings page.
- Type a name for the project.
- Select your token and Git repository.
- Click Create.
- After the project import is complete, view the project import summary to check that all the assets were successfully imported.
- Before you begin working with the imported assets in your new project, check for missing credentials, for example in notebooks and data connections, to enable successful relinking between project assets.
- Add collaborators by clicking the Access Control tab in your project, then click Add collaborators or Add user groups. All users need to create access tokens for collaboration.
The status of a project import is also tracked on the project's Overview page.