Volumes

Volumes are containers to store data in its original form and 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.

Volumes can either be external or managed.

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 customer.

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

Managed volumes

A managed volume creates a location in OCI Object Storage for storing the data. 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 is deleted.

Limitations

You cannot define an external volume on a bucket and its directory if they are already used for another external table or external volume.

Create a Managed Volume

You can create managed volumes for schema you manage.

  1. Navigate to the schema you want to create a volume for.
  2. Select the Volumes tab.
  3. Click Create volume icon Create Volume.
  4. Provide a volume name and description.
  5. Select the Managed option.

    Create volume page open with Managed option selected

  6. Click Create.

Create an External Volume

You can create external volumes for schema you manage.

  1. Navigate to the schema you want to create a volume for.
  2. Select the Volumes tab.
  3. Click Create volume iconCreate Volume.
  4. Select the External option.

    Create volume page open with the External volume type selected

  5. Select the compartment, bucket, and folder for your external volume. The objects you can select are based on the logged in user's IAM permissions.
  6. Click Create.

Edit a Volume

You can modify details of volumes you manage.

  1. Navigate to your schema.
  2. Select the Volumes tab.
  3. Next to the volume you want to edit click Actions three dot icon Actions.
    • Click Rename to change your volume's name. Enter a new name and press Enter.
    • Click Edit Description to change your volume's description. Provide the new description and click Save.

View Volume Details

You can view the details of volumes in schema.

  1. Navigate to your schema. Click the Volumes tab.
  2. Click the name of the volume you want to view details for. You can also click Actions three dot icon Actions next to the volume then click View.
  3. Click the Details tab.

Delete a Volume

You can delete volumes from schema you manage.

  1. Navigate to the schema you want to delete your volume from.
  2. Click the Volumes tab.
  3. Next to the volume you want to delete, click Actions three dot icon Actions and click Delete.
  4. Click Delete.