Volumes

Use volumes to store data in its original form. Volumes can can store semi-structured or unstructured data.

You can load new data into your volume or reference data in an existing location. You can define access control permissions on a volume by creating volume permissions. For more information, see Volume Permissions.

Volumes can either be managed or external.

Managed volumes

A managed volume creates a location in OCI Object Storage for storing the data. Oracle AI Data Platform manages both the metadata and data of the volume.

When you delete a managed volume, the volume definition and the volume data are deleted.

External volumes

An external volume refers to an existing location in OCI Object Storage. When users create an external volume, AI Data Platform manages only the metadata of the volume, the data life cycle is managed by the external data owner.

When you delete an external volume, only the volume definition is deleted. The data referenced by the external volume isn't deleted.

Ensure your users have the following IAM policies required to create external volumes:

allow group <GroupName> to read buckets in compartment id <external-data-CompartmentId>
allow group <GroupName> to inspect objects in compartment id <external-data-CompartmentId>

Limitations

You can't define an external volume on a bucket and its directory if they're already used for another external table or external volume.

Create a Managed Volume

You can create a managed volume to store semi-structured or unstructured data for schema you manage.

1. Open the Create volume dialog.
   • From the left navigation pane:
     1. Click Create and select Volume.
     2. In the Select volume location dialog, select the catalog and schema you want to create the volume for, and click Select.
   • From Master catalog:
     1. In the Master catalog tree or the Catalogs tab, click the catalog you want to create the volume for to open it.
     2. In the Schemas tab, click the schema you want to create the volume for to open it.
     3. Click Add to schema and select Volume.
   
   

   

   
   
2. Enter a Volume name and Description.
3. Under Volume, select the Managed option.
4. Click Create.

Create an External Volume

You can create an external volume for schema you manage to access semi-structured or unstructured data without moving the data to or duplicating the data in Oracle AI Data Platform.

1. Open the Create volume dialog.
   • From the left navigation pane:
     1. Click Create and select Volume.
     2. In the Select volume location dialog, select the catalog and schema you want to create the volume for, and click Select.
   • From Master catalog:
     1. In the Master catalog tree or the Catalogs tab, click the catalog you want to create the volume for to open it.
     2. In the Schemas tab, click the schema you want to create the volume for to open it.
     3. Click Add to schema and select Volume.
2. Enter a Volume name and Description.
3. Under Volume, select the External option.
   
   

   

   
   
4. Browse for and select the Compartment, Bucket, and Folder (Optional) for your external volume. The objects you can select are based on the logged in user's IAM permissions.
5. Click Create.

View Volume Details

You can view the details of a volume to view its configuration and metadata.

The Details tab for a volume displays the volume key and type, along with when and by whom the volume was created and last updated.

1. In the left navigation pane, click Master catalog.
2. In the Master catalog tree, expand the catalog and schema that contain the volume you want to view, then click Volumes.
3. In the Volumes tab, locate your volume and click Actions, then click View.
4. Click Details.

Rename a Volume

You can rename a volume that you manage if its contents or purpose has changed.

1. In the left navigation pane, click Master catalog.
2. In the Master catalog tree, expand the catalog and schema that contain the volume you want to edit, then click Volumes.
3. In the Volumes tab, locate your volume and click Actions, then click Rename.
4. Edit the volume name and press Enter.

Edit a Volume Description

You can modify the description of a volume you manage if its contents or purpose has changed.

Note:

Edits to external volumes in Oracle AI Data Platform aren't pushed to the remote catalog in OCI Object Storage.

1. In the left navigation pane, click Master catalog.
2. In the Master catalog tree, expand the catalog and schema that contain the volume you want to edit, then click Volumes.
3. In the Volumes tab, locate your volume and click Actions, then click Edit description.
4. Edit the table description and click Save.

Delete a Volume

You can delete a volume from a schema you manage when it's no longer needed.

Note:

The data in OCI Object Storage referenced by an external volume isn't deleted.

1. In the left navigation pane, click Master catalog.
2. In the Master catalog tree, expand the catalog and schema that contain the volume you want to delete, then click Volumes.
3. In the Volumes tab, locate your volume and click Actions, then click Delete.
4. Click Delete.