# Dataset Management

Dataset Management lets you review the object types a source collects and control how the source aggregates those objects into SailPoint. Use Dataset Management to view and manage resource attributes, datasets and their resources, enable dataset aggregation schedules, perform manual aggregation, and view aggregation history.

> [!NOTE]
>
> Datasets are also available in SailPoint Agentic Fabric. Contact your Customer Success team and refer to [SailPoint Agentic Fabric](<https://documentation.sailpoint.com/saas/help/agentic_fabric/index.html>) for more information.

For more information, refer to [Managing Datasets and Resources](<https://documentation.sailpoint.com/saas/help/sources/datasets.html>) for datasets, resources, owner correlation, and aggregation.

## Datasets

A *dataset* is a named group of one or more related resources that the source aggregates together.

When aggregation runs for a dataset, the source collects all resources in that dataset from the managed system in one aggregation job. Activate or deactivate aggregation at the dataset level, not for individual resources.

> [!NOTE]
>
> Each resource belongs to exactly one dataset for that source. The source defines which resources belong to each dataset. You can enable aggregation and review associated resources, but you cannot create or delete datasets or move resources between them.

### Dataset Aggregation

Configure aggregation on the **Dataset Aggregations** tab for each dataset. Configure each dataset separately. During aggregation, your owner correlation rules are automatically applied to link machine identities to their human owners. For more information, refer to [Configuring Dataset Aggregations](<https://documentation.sailpoint.com/saas/help/sources/datasets.html#configuring-dataset-aggregations>).

## Resources

A resource defines an object type from the managed system. It specifies the kind of object, the attributes the source collects, and how the source identifies and displays each object. Resources form the building blocks of the data model.

In the UI, each resource appears under **Dataset Management** \> **Resources** with its schema. A resource does not run aggregation by itself. The dataset that owns the resource collects it during aggregation.

For more information, refer to [Managing Resources](<https://documentation.sailpoint.com/saas/help/sources/datasets.html#managing-resources>).

### Owner Correlation

Configure owner correlation on each resource to link aggregated objects to human owners. If you do not configure owner correlation, or if the mapping produces no match, an owner is not assigned. For more information, refer to [Configuring Owner Correlation](<https://documentation.sailpoint.com/saas/help/sources/datasets.html#configuring-owner-correlation>).

## Supported Datasets

Go to **Dataset Management \> Datasets** on your Bitbucket Cloud source to view the datasets the connector aggregates. Select a dataset to review its associated resources and configure aggregation.

> [!NOTE]
>
> Configure aggregation for each dataset separately. For more information, refer to [Dataset Aggregation](<https://documentation.sailpoint.com/saas/help/sources/datasets.html#configuring-dataset-aggregations>).

| Dataset name | Dataset ID | Associated resources |
| --- | --- | --- |
| Bitbucket Credentials | `bitbucket:credential` | Bitbucket Project Deploy Key, Bitbucket Repository Deploy Key, Bitbucket Pipeline Variable |

## Supported Resources

Bitbucket Cloud resources represent non-human identities: project deploy keys, repository deploy keys, and pipeline variables.

Go to **Dataset Management \> Resources** on your Bitbucket Cloud source to view each non-human identity resource that the connector aggregates. Select a resource to review its schema on the **Schema** page.

For more information, refer to [Managing Resources](<https://documentation.sailpoint.com/saas/help/sources/datasets.html#managing-resources>).

> [!NOTE]
>
> When you enable dataset aggregation for a selected dataset, all resources in that dataset are collected at once. Activate or deactivate aggregation at the dataset level, not for individual resources.

> [!NOTE]
>
> **Workspace Filter** applies to these resource aggregations.

| Resource name | Resource type | Resource ID |
| --- | --- | --- |
| [Bitbucket Project Deploy Key](<#bitbucket-project-deploy-key>) | Credential | `bitbucket:project-deploy-key` |
| [Bitbucket Repository Deploy Key](<#bitbucket-repository-deploy-key>) | Credential | `bitbucket:repository-deploy-key` |
| [Bitbucket Pipeline Variable](<#bitbucket-pipeline-variable>) | Credential | `bitbucket:pipeline-variable` |

## Bitbucket Project Deploy Key

| Property | Value |
| --- | --- |
| Resource ID | `bitbucket:project-deploy-key` |
| Dataset ID | `bitbucket:credential` |
| Resource type | Credential (`std:credential`) |
| Identity attribute | `id` |
| Display attribute | `label` |

### Attributes

| Attribute | Type | Description |
| --- | --- | --- |
| `id` | integer | Unique project deploy key identifier. |
| `type` | string | Resource type that identifies the object as a project deploy key. |
| `label` | string | Display label assigned to the deploy key. |
| `comment` | string | Additional description associated with the deploy key. |
| `created_on` | string | Date and time when the deploy key was created. |
| `last_used` | string | Date and time when the deploy key was last used, when available. |
| `workspace_slug` | string | Owning workspace slug. |
| `project_key` | string | Key of the associated project. |
| `project_name` | string | Display name of the associated project. |

## Bitbucket Repository Deploy Key

| Property | Value |
| --- | --- |
| Resource ID | `bitbucket:repository-deploy-key` |
| Dataset ID | `bitbucket:credential` |
| Resource type | Credential (`std:credential`) |
| Identity attribute | `id` |
| Display attribute | `label` |

### Attributes

| Attribute | Type | Description |
| --- | --- | --- |
| `id` | integer | Unique repository deploy key identifier. |
| `type` | string | Resource type that identifies the object as a repository deploy key. |
| `label` | string | Display label assigned to the deploy key. |
| `comment` | string | Additional description associated with the deploy key. |
| `created_on` | string | Date and time when the deploy key was created. |
| `last_used` | string | Date and time when the deploy key was last used, when available. |
| `workspace_slug` | string | Owning workspace slug. |
| `repository_full_name` | string | Workspace-qualified name of the associated repository. |

## Bitbucket Pipeline Variable

| Property | Value |
| --- | --- |
| Resource ID | `bitbucket:pipeline-variable` |
| Dataset ID | `bitbucket:credential` |
| Resource type | Credential (`std:credential`) |
| Identity attribute | `variable_uuid` |
| Display attribute | `variable_name` |

### Attributes

| Attribute | Type | Description |
| --- | --- | --- |
| `type` | string | Resource type that identifies the object as a pipeline variable. |
| `variable_uuid` | string | Unique variable identifier and resource ID. |
| `variable_name` | string | Variable name or key. |
| `secured` | boolean | Whether Bitbucket marks the variable as secured. |
| `system` | boolean | Indicates whether Bitbucket manages the variable as a system variable. |
| `scope` | string | Scope that the API reports, such as `ACCOUNT` or `REPOSITORY`. |
| `variable_scope` | string | Normalized connector scope: `workspace`, `repository`, or `environment`. |
| `workspace_slug` | string | Owning workspace slug. |
| `repo_slug` | string | Repository slug for repository-scoped or environment-scoped variables. |
| `repository_full_name` | string | Workspace-qualified repository name for a repository-scoped or environment-scoped variable. |
| `deployment_environment` | string | Environment UUID for an environment-scoped variable. |
| `deployment_environment_name` | string | Environment name for an environment-scoped variable. |
