Provisioning a Collection

  1. Within the OCI Console, navigate to a Model to create a collection for.
  2. From the resource menu, select ‘Collections’, and then select ‘Create Collection’. The ‘Create Collection’ panel is displayed.
  3. Although not required, it is recommended to provide a display name for the Collection to help you identify it later.
  4. Add a source name space to help track the source of the Collection. This is useful for identifying where the data originated from. Ensure that this name is unique in a DNS Zone. It is helpful to think of source name spaces as urls or bundle ids, such as com.utility.electric. One or more Data Exchanges can have the same DNS Zone. Collections in either Data Exchange can build off this DNS Zone:

    • com.utility.electric
    • com.utility.electric/2023
    • com.utility.electric/2023/january
    • com.utility.electric/2023$january However two Collections in that DNS Zone cannot share the same source name space, for example:
    • com.utility.electric/2023/january
    • com.utility.electric/2023/january That configuration results in an error on Collection creation.
  5. Select a schema name prefix. This appends to your Collection schemas like so:
    • WATT#MAP
    • WATT#MODEL It is worth noting that you cannot have an Asset with the same schema name prefix as a Collection. For example, if you have an Asset with the schema name prefix of ‘WATT’, you cannot create a Collection with the same prefix.
  6. Select the Asset to build the Collection off of. This is the source of the data for the Collection. This value is automatically assigned if you’re creating it from an Asset detail page.
  7. Select the Model to use for the Collection. This determines the structure of the data in the Collection and is automatically assigned if you are creating from a Model detail page.