Skip to main content

Pair Datasets

Pairing datasets allows you to send the data within your datasets to an admin at another Koverse workspace. A connection is also created between your dataset and the dataset at the other Koverse workspace, allowing updates made on either end to occur on both sides. All ABAC security you have applied to your data will apply to both sides, with an admin on the other side of the connection needing to apply attributes to their users in order for additional users to see sensitive data.

How to pair a dataset

From the dataset settings menu select 'Send and Pair Dataset'.

Send And Pair Dataset

On 'Send and Pair Dataset' modal select 'GENERATE KEY'

Send And Pair Dataset Modal

Press Copy and Save the Key

This is the only time the key will be available to copy.
It will not be available again, and the modal cannot be reopened after closing.

Copy Key

How to create a new paired dataset with the copied key

From the left navigation menu

Select the '+' button on 'Datasets' menu option

Create New Dataset

'Create a New Dataset' modal will open

Select 'Create Paired Dataset From Provided Key'

Create New Dataset Dropdown Options

Paste the copied key into the 'Enter the key' field.
Select the 'Create' button to create the new paired dataset.

Create and Copy Key

After the datasets are paired, the origin dataset will indicate it is paired in the left navigation menu.

Paired Origin Dataset in Left Nav

Viewing the origin dataset, it will indicate that it is paired with 1 other workspace.

Paired Origin Dataset View

View of the newly created paired dataset in destination workspace

The replica dataset will now appear in the left navigation menu
It will also indicate that it is an actively paired dataset.

Paired Replica Dataset in Left Nav

Viewing the replica dataset will indicate the dataset is a 'paired dataset replica'

Paired Replica Dataset View

Managing dataset pairs

Revoking a pending dataset key

A pending dataset pair will be listed on the 'Manage Dataset Pairs'

Dataset Pair Management

Revoke Key action will launch 'Revoke Key' modal

Revoke Key Option

Revoke button will cancel the pending dataset pair
The unused key will have its ability to create a dataset pair revoked. Attempts to use a revoked key will result in an unauthorized error.

Revoke Key Modal

Cancelling an active dataset pair

Active dataset pairs will be listed on the 'Manage Dataset Pairs'

Dataset Pair Management

'Cancel Pairing' row action will launch 'Cancel Pairing' modal

Dataset Pair Management

Confirm the connection termination by entering the dataset name in the form field.
When the dataset name is provided the 'Terminate' button will activate.
Selecting the 'Terminate' button will result in the pairing between the datasets being canceled.

The request will cancel the pairing on both sides of the connection.

Both the origin and replica dataset will continue to exist in both workspaces.
The datasets will no longer be paired for sharing data or deletes.

Dataset Pair Management

The pair will now show as cancelled

Dataset Pair Management