Use Datasets and Snapshots

When a Dataset that already exists in Domino is shared with you, you can mount it in your Project, access the contents of the Dataset, and use it in your code.

Mount a Dataset in a Project

From the navigation pane, click Data > Datasets.
On the Domino Datasets page, click the Mount Shared Dataset button.
In the pop-up window, under Dataset Name, choose the Dataset that you want to mount in this Project from the dropdown, then click the Mount Dataset button.
The Dataset that you selected should now appear in the Shared Datasets list. Under Name, the path for the Dataset points to a directory where you will find the mounted Dataset in your project’s executions.

Note	To mount a Dataset to a Project, you must have the appropriate Dataset role and you must be an owner or contributor on the Project to which you want to mount the Dataset.

Unmount a shared Dataset from a Project

In Domino Dataset, look for the Dataset that you want to unmount.
At the end of its row, click the three vertical dots and click Unmount.

Note	Unmounting a shared Dataset will not remove it from existing executions until the execution completes. However, the Dataset will not be available for new executions in this Project.

Find a Dataset path to access it in your code

In order to access a Dataset or a snapshot in your code, you need to know its path.

There are several ways to find the path to a Dataset or any of its Snapshots in Domino.

In a Workspace:
- When launching a Workspace, click Additional Details.
- In a running Workspace, click Settings > Edit Settings > Additional Details.
In a Job:
- When launching a Job, click Additional Details.
- In a running Job, click Details > Data.

Understand Dataset paths

Domino executions (workspaces, jobs, apps, and launchers) automatically make Datasets and their associated Snapshots from a Project available.

The following configuration demonstrates the conventions followed by a predefined path:

Dataset called clapton (local to the project)
- Snapshot 1 (tagged with tag1)
- Snapshot 2 (not tagged)
Dataset called mingus (local to project)
- Snapshot 1 (tagged with tag2)
- Snapshot 2 (not tagged)
Dataset called ella (shared from another project)
- Snapshot 1 (tagged with tag3)
- Snapshot 2 (not tagged)
Dataset called davis (shared from another project)
- Snapshot 1 (tagged with tag4)
- Snapshot 2 (not tagged)

Dataset paths in DFS projects

For a Domino File System (DFS) project, Datasets and Snapshots are available in the following hierarchy:

/domino
   |--/datasets
      |--/local               <== Local Datasets and Snapshots
         |--/clapton          <== Read-write Dataset for owner and editor, read-only for reader
         |--/mingus           <== Read-write Dataset for owner and editor, read-only for reader
         |--/snapshots        <== Snapshot folder organized by Dataset
            |--/clapton       <== Read-write for owner and editor, read-only for reader
               |--/tag1          <== Mounted under latest tag
               |--/1             <== Always mounted under the Snapshot number
               |--/2
            |--/mingus
               |--/tag2
               |--/1
               |--/2
      |--/ella                <== Read-write shared Dataset for owner and editor, Read-only for reader
      |--/davis               <== Read-write shared Dataset for owner and editor, Read-only for reader
      |--/snapshots           <== Shared Datasets Snapshots organized by Dataset
         |--/ella             <== Read-write for owner and editor, read-only for reader
            |--/tag3          <== Mounted under latest tag
            |--/1             <== Always mounted under the Snapshot number
            |--/2
         |--/davis
            |--/tag4
            |--/1
            |--/2

Dataset paths in Git-based projects

For Git-based Projects, the Datasets and Snapshots are available in the following hierarchy:

/mnt
   |--/data                  <== Local Datasets and Snapshots
     |--/clapton             <== Read-write Dataset for owner and editor, read-only for reader
     |--/mingus              <== Read-write Dataset for owner and editor, read-only for reader
     |--/snapshots           <== Snapshot folder organized by Dataset
        |--/clapton          <== Read-write for owner and editor, read-only for reader
           |--/tag1          <== Mounted under latest tag
           |--/1             <== Always mounted under the Snapshot number
           |--/2
        |--/mingus
           |--/tag2
           |--/1
           |--/2
   |--/imported
     |--/data
        |--/ella             <== Read-write shared Dataset for owner and editor, read-only for reader
        |--/davis            <== Read-write shared Dataset for owner and editor, read-only for reader
        |--/snapshots        <== Shared Dataset Snapshots organized by Dataset
           |--/ella          <== Read-write for owner and editor, read-only for reader
              |--/tag3       <== Mounted under latest tag
              |--/1          <== Always mounted under the Snapshot number
              |--/2
           |--/davis
              |--/tag4
              |--/1
              |--/2

Next steps

Create and manage Dataset Snapshots for data reproducibility.
Learn about Dataset best practices.