7 Share Data

This chapter provides details on managing data shares, assets, and recipients in your AI Data Platform.

Topics:

Data Sharing

Data Sharing in Oracle AI Data Platform enables secure and efficient real-time data sharing across and within the organization without data duplication.

Oracle AI Data Platform uses Delta Sharing protocol to securely share data. To share your data, you must complete these steps:
  1. Create a share.
  2. Add assets that you want to share. An asset can be a schema or table.
  3. Create and add recipients to a share. A share and recipient can be access controlled using permissions model.
  4. Activate the recipients.

From the Data Sharing page you can see all Shares in your AI Data Platform, all recipients of Shares in your AI Data Platform, your Shares, and Shares others have made you a recipient for.

From the Shares tab, you can see the details of Shares in your AI Data Platform, including the number of assets in a Share, number of recipients, and who owns the share. You can create a new Share by clicking Create share next to the search bar.

Clicking on a Share lets you see the shared assets, recipients, details, and RBAC permissions. From the Assets tab you can add assets to the share. From the Recipients tab you can manage the recipients for this specific share, create new recipients, or share with existing recipients. The Details tab provides the name, description and creation details of the Share. From the Permissions tab you can manage the RBAC permissions for that Share.

From the Recipients tab at the top level of Data Sharing, you can see details of the Share recipients in your AI Data Platform. You can create new recipients by clicking Create recipient next to the search bar.

Clicking on a recipients name shows Shares the recipient is added to, details for that recipient, and the RBAC permissions for that recipient.

Handling Token Expiry

Oracle AI Data Platform can regenerate bearer tokens for data sharing for active recipients. If the current bearer token has not expired, you can extend the duration of the bearer token by calling the updateSecretExpiry API using a curl command: 

curl
    --header 'Authorization: Bearer <token>’
    --header 'Content-Type: application/json'
    --data '{"existingTokenExpireInSeconds":"<duration>"}'
    --request POST ‘<delta_share_endpoint>/updateSecretExpiry'
Where:
  • <token> is the bearer token value in the share profile
  • <duration> is the duration of the new token in seconds
  • <delta_share_endpoint> is the Delta Share endpoint. You can get this value for a recipient by using sql("DESCRIBE recipient <<recipient_name>>") and checking the value of the recipient's delta_share_enpoint.

Limitations

  • You can send the activation token email using an email application or by copying the activation link and composing an email using their existing email service.
  • You cannot share volumes or workspace files (data, notebook, sql or python files) using data sharing.

Create a Share

You must create a Share as a container for managing shared assets as part of AI Data Platform data sharing.

  1. On the Home page, click Data Sharing.
  2. Click Create share icon Create Share.
  3. Enter a name and description for your Share.
  4. Click Create.

Modify a Share

You can update the name and description of your Shares after creation.

  1. On the Home page, click Data Sharing.
  2. Next to the share to modify, click Actions three dot icon Actions then click Edit.
  3. Enter a new name or description for your Share. Click Save.

Delete a Share

You can delete a Share that is no longer needed.

  1. On the Home page, click Data Sharing.
  2. Next to the share to delete, click Actions three dot icon Actions then click Delete.
  3. Click Delete.

View Share Details

  1. On the Home page, click Data Sharing.
  2. Click to the Shares tab.
  3. Click the share name and click the Details tab.

Add an Asset to a Share

After creating a Share, you can add assets to be shared with recipients.

  1. On the Home page, click Data Sharing.
  2. Click the name of the Share to add assets to.
  3. On the Assets tab, click Add asset icon Add asset.
  4. Select Workspace or Catalog as the asset source.
  5. Use the search bar or navigate to the asset you want to share. Select it and click Add.

Remove an Asset from a Share

You can remove assets you no longer want to be a part of a Share.

  1. On the Home page, click Data Sharing.
  2. Click the name of the Share to remove assets from.
  3. On the Assets tab, next to asset you want to remove click Actions three dot icon Actions then click Delete.
  4. Click Delete.

Add Recipients to Data Sharing

You must add recipients before you can include them in Shares.

  1. On the Home page, click Data Sharing.
  2. Click the Recipients tab.
  3. Click Create recipient icon Create recipient.
  4. Enter a name and description for the recipient.
  5. Optional: Enter the email address to send an activation link to for the recipient.
  6. Click Create.

Add an Existing Recipient to a Share

You can add recipients that already exist in your AI Data Platform to a Share.

  1. On the Home page, click Data Sharing.
  2. Click the name of a Share to add an existing recipient to.
  3. Click the Recipients tab.
  4. Click Share with existing recipients icon Share with existing recipients.
  5. Search for a user and select the box next to the recipient name.
  6. Click Share.

Manually Activate a Recipient

You can choose to manually activate recipients if there are issues preventing them from using the email activation links.

  1. On the Home page, click Data Sharing.
  2. Click to the Recipient tab.
  3. Click the recipient name and click the Details tab.
  4. Next to Activation status click Activate.
  5. Copy the activation link from the prompt and paste into a separate window.
  6. Verify the Activation status is now set to Active.

Resend Activation Link to a Recipient

If the activation link was lost, deleted, or otherwise not received by a recipient, you can resend the activation link to the provided email address.

The recipient must have an email address as part of their details to send them an activation link. If the email is incorrect or missing, you may need to create a new recipient.
  1. On the Home page, click Data Sharing.
  2. Click to the Recipient tab.
  3. Click the recipient name and click the Details tab.
  4. Next to Activation email link click Send activation link. Your configured email application opens.
  5. Review and send the email to the recipient.

Remove Recipient from a Share

You can remove a recipient from a Share, keeping the recipient but removing their access to assets in that Share.

  1. On the Home page, click Data Sharing.
  2. Click the share you want to remove recipients from.
  3. Click the Recipients tab.
  4. Next to the recipient you want to remove, click Actions three dot icon Actions then click Remove.

Modify a Recipient

You can update the name, description, and email address for a recipient after creation.

  1. On the Home page, click Data Sharing.
  2. Click to the Recipient tab.
  3. Next to the recipient to update, click Actions three dot icon Actions then click Edit.
  4. Enter a new name or description for your recipient. Click Save.

View Recipient Details

You can see information on a recipient, such as name, email address for activation link, active status, and creation details from the Details tab.

  1. On the Home page, click Data Sharing.
  2. Click to the Recipient tab.
  3. Click the recipient name and click the Details tab.

Delete a Recipient

You can delete recipients that are no longer needed in your AI Data Platform.

  1. On the Home page, click Data Sharing.
  2. Click the Recipients tab.
  3. Next to the recipient to delete, click Actions three dot icon Actions then click Delete.
  4. Click Delete.