Creating an Oracle Object Storage destination

The first step in setting up an export of data to Oracle Object Storage is to create a destination. This will configure how the Oracle Unity data will be exported to Object Storage.

To create the Oracle Object Storage destination:

  1. Click the Oracle icon Image of the application navigation button. Use it to access the different parts of Oracle Unity. in the bottom-right corner to open the navigation menu.
  2. Select Destinations.
  3. In the top-right corner, click Create destination.

Step 1: Define destination details

The job details section allows you to define the type of destination and how it will display in Oracle Unity.

Enter the information for the destination.

An image of the destination details

  • Type: Use the drop-down list to select Oracle Object Storage.
  • Name: Enter a name. The name must be 1 or more characters, up to a maximum of 50. Use only letters (a–z and A–Z), numbers (0–9), underscores (_), hyphens (-), and spaces. The first character cannot be a space.

  • Destination ID: The unique system identifier that is auto-populated from the destination name you enter. You can't change this value after you create the destination.

  • Description: Enter a description. This field is optional, but it is highly recommended to add descriptions for any entity created. This helps all other users get additional context when using and navigating Oracle Unity. The description can have a maximum of 512 characters with no restrictions on characters used. You can use characters from all languages supported in the language settings.

Step 2: Configure authentication settings

Enter the information to allow Oracle Unityto access the required data from Object Storage.

An image of the authentication section

  • Path: Enter the path of the folder on Object Storage that will store the exported data files in this format: s3a://[bucket name]/[path].
    • You can find your bucket name in your Oracle Object Storage under Object Storage > Buckets.

      • Important: The bucket name can't have an underscore (_) character.

      An image of the Buckets section in Oracle Object Store

    • Find the folder path where files will be exported. For example "unity_data".

      • An image of the path name for Oracle Object Storage

  • Storage End Point: Enter the Object Storage namespace and endpoint in this format: [name_space].compat.objectstorage.[your_oss_endpoint].oraclecloud.com.

    • Your Oracle Object Storage' namespace is found within in your bucket details.

      • An image showing the namespace for Oracle Object Storage

    • You can find your endpoint region under Infrastructure Regions (for example, "ap-hyderabad-1", "eu-frankfurt-1", "ca-toronto-1", and so on).

      • An image showing endpoint regions

  • Storage Key: Enter the Object Storage key.

    • Your Store Key is located in Oracle Object Storage under Identity & Security > Users > Customer Secret Keys.

      • An image of the Customer Secret Keys section

    • If you don't already have a key, create a new user account.

  • Storage Secret: Enter the Object Storage secret.

    • Your Store Secret was displayed when you generated a Secret Key.

      • An image of the Generate Secret Key window

Once you enter all the details, click Verify connection to ensure that Oracle Unity can access the server. If there are connection issues, confirm the server path and authentication settings entered are correct.

Step 3: Configure files

The files details section defines the format of the destination files.

An image of the files section

  • File name: Enter the file name and extension to use for the exported files. A timestamp and file number will be added as a suffix identifying when the file was created. The timestamp will be in the format yyyy-MM-dd-HH-mm-ss-SSS. You can use characters from all languages supported in the language settings.

    • Example: If you enter the file name as Export_file_01, a timestamp will be added as a suffix and the file will be named Export_file_01_2021-05-12-12-56-12-926_0.csv. The timestamp is 2021-05-12-12-56-12-926. The "0" indicates it is the first exported file with the same timestamp.

  • Format: The format of the exported file must be in CSV format. Fields in the exported file will be separated by commas.
  • Date format: The date format of the exported file must be yyyy-MM-dd-hh-mm-ss-SSS. A timestamp with this format will be added as a suffix to the exported file.
  • Compression format: The compression format must be gzip .

Step 4: Save and publish the new destination

When finished defining the destination, scroll to the top of the page and click Save or Save and close.

Once you create the destination, you will need to publish the changes.

Exporting a data object or segment

After creating and publishing the Object Storage destination, you can continue following the steps for exporting a data object or segment.

Learn more

Creating destinations

Creating export jobs

Creating campaigns

integrate, integration, object store, how to integrate, object storage