Export and Import of Objects


The objects that you can export from and import to a Oracle Cloud Infrastructure Data Integration workspace include projects and folders, tasks, data flows, pipelines, and user-defined functions and functions libraries.

Objects are exported to a zip file that's created and saved in an Oracle Cloud Infrastructure Object Storage bucket.

Objects to be imported must be an export zip file that's saved in an Object Storage bucket.

The Data Integration workspace and the Object Storage bucket that's used for export and import can be in the same tenancy or in different tenancies.

Data Integration needs specific policies to access resources in Object Storage for export and import. See Required Policies for Object Storage.

After setting up required policies, see the following pages for the type of object that you want to export or import:

Exporting Objects
Exporting a Project
Exporting a Folder, Task, Data Flow, or Pipeline
Exporting a User-Defined Functions Library or User-Defined Function
Exporting an Application
Importing Objects
Importing a Project
Importing a Folder, Task, Data Flow, or Pipeline
Importing a User-Defined Functions Library or User-Defined Function
Importing an Application
Monitoring Export and Import Requests
Viewing the Details of an Export Request
Viewing the Details of an Import Request
Stopping an Export or Import Request

Required Policies for Object Storage

Create policies that allow Data Integration to access Object Storage resources such as objects and buckets.

For the Object Storage bucket that is to be used for export and import, ensure that you have the required read, write, and list permissions to access the bucket or be part of the group that has the required access.

The following are policy examples that you can use.

If the Data Integration workspace and the Object Storage bucket are in the same tenancy, create these policies:

Copy
allow group <group-name> to <read or manage> objectstorage-namespaces in tenancy
Copy
allow group <group-name> to <read or use> buckets in tenancy
Copy
allow group <group-name> to manage objects in tenancy

If the Data Integration workspace and the Object Storage bucket are in different tenancies, create the relevant policies in the workspace tenancy and the Object Storage tenancy:

In the workspace tenancy:

Copy
Define tenancy <tenancy-name> as <Object-Storage-tenancy-OCID>
Copy
Endorse group <group-name> to inspect compartments in tenancy <tenancy-name>
Copy
Endorse group <group-name> to use object-family in tenancy <tenancy-name>

In the Object Storage tenancy:

Copy
Define tenancy <tenancy-name> as <workspace-tenancy-OCID>
Copy
Define group <workspace-tenancy-group-name> as <workspace-tenancy-group-OCID>
Copy
Admit group <group-name> of tenancy <tenancy-name> to inspect compartments in tenancy
Copy
Admit group <group-name> of tenancy <tenancy-name> to <use or manage> object-family in compartment <compartment-name>
 Note



There are different types of policies for using Object Storage: Resource Principal and On Behalf Of. The policies required also depend on whether you want to restrict access at the compartment level or tenancy level. Review more Policy Examples to Enable Access to OCI Object Storage and this blog to identify the right policies for your needs.