# 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 OpenAI SaaS 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>).

The connector uses datasets to schedule aggregation of the following resource types:

| Dataset | Resource Type | Associated Resource |
| --- | --- | --- |
| OpenAI API Keys | Credential | [OpenAI API Key](<#openai-api-key>) |
| OpenAI Certificates | Credential | [OpenAI Certificate](<#openai-certificate>) |

## Supported Resources

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.

The OpenAI datasets include the following resources, which the connector aggregates as machine identities:

| Resource Name | Resource Type | Resource ID |
| --- | --- | --- |
| [OpenAI API Key](<#openai-api-key>) | Credential | `openai:api-key` |
| [OpenAI Certificate](<#openai-certificate>) | Credential | `openai:certificate` |

## OpenAI API Key

| Property | Value |
| --- | --- |
| Resource ID | `openai:api-key` |
| Resource type | `std:credential` |
| Identity attribute | `id` |
| Display attribute | `name` |

The following table lists schema attributes for the OpenAI API Key resource:

| Attribute | Description | Type | Entitlement | Multi-valued |
| --- | --- | --- | --- | --- |
| id | The unique identifier of the OpenAI API key. | String | No | No |
| name | The display name of the API key. | String | No | No |
| keyScope | The scope of the key. The value is `organization` or `project`. | String | No | No |
| objectType | The source object type returned by OpenAI. | String | No | No |
| createdAt | The time the API key was created. | String | No | No |
| expiresAt | The time the API key expires. | String | No | No |
| lastUsedAt | The last time the API key was used. | String | No | No |
| ownerType | The category of the API key owner. | String | No | No |
| ownerId | The identifier of the API key owner. | String | No | No |
| ownerName | The display name of the API key owner. | String | No | No |
| ownerRole | The role of the API key owner. | String | No | No |
| ownerCreatedAt | The time the API key owner identity was created. | String | No | No |
| redactedValue | The redacted API key value returned by OpenAI. | String | No | No |
| adminApiKey | Indicates whether the key is an organization admin API key (`true` or `false`). | Boolean | No | No |
| projectName | The display name of the project for a project-scoped API key. | String | No | No |
| spBusinessApplication | The business application label used for governance correlation. | String | No | No |
| spStatus | The governance lifecycle status of the API key. | String | No | No |
| spDescription | The governance description of the API key. | String | No | No |

## OpenAI Certificate

| Property | Value |
| --- | --- |
| Resource ID | `openai:certificate` |
| Resource type | `std:credential` |
| Identity attribute | `certificateId` |
| Display attribute | `name` |

The following table lists schema attributes for the OpenAI Certificate resource:

| Attribute | Description | Type | Entitlement | Multi-valued |
| --- | --- | --- | --- | --- |
| certificateId | The unique identifier of the OpenAI certificate. | String | No | No |
| name | The display name of the OpenAI certificate. | String | No | No |
| objectType | The source object type returned by OpenAI. | String | No | No |
| createdAt | The time the certificate was uploaded. | String | No | No |
| validAt | The time the certificate becomes valid. | String | No | No |
| expiresAt | The time the certificate expires. | String | No | No |
| active | Indicates whether the certificate is active at the aggregated scope (`true` or `false`). | Boolean | No | No |
| spBusinessApplication | The business application label used for governance correlation. | String | No | No |
| spStatus | The governance lifecycle status of the certificate. | String | No | No |
| spDescription | The governance description of the certificate. | String | No | No |
