Create Analytics Objects

Create analytics objects to define the structure of the data that you write to or read from your external data sources. You can use these analytics objects to store data that you received from a device, or to store data that you want to write to a data source.

1. Go to your IoT application, select Analytics and then select Analytics Objects.
2. If this is your first analytics object, then click Create Analytics Object. Otherwise, click Create next to the Search field.
3. Enter a name to identify your analytics object.
   You must use Java naming conventions to choose a name for you analytics object. If the application is complex and requires a large number of analytics objects, then you can use a Java package hierarchical naming convention.
   The name must contain only alphanumeric characters and must not contain spaces.
4. (Optional) Enter a brief description.
5. Click Create.
   The Analytics Object page appears. This page lists all the existing analytics objects with a Search field that you can use to find a specific object or to filter the list using a partial name. The main section of this page shows the definition of the selected analytics object.
6. From the Type list, select a type.
   Available types are:
   • Int
   • Long
   • Float
   • Double
   • Boolean
   • String
   • Object
   If you’re defining a data structure for a link, then select Object as the type for your analytics objects. You can select any of the other types to define an alias for a simple type.
7. If you selected the type Object:
   1. Enter the fully qualified name that you want to use for the Java class that will be generated for this analytics object.
      In your analytics processor, import this class to use this analytics object. When you generate the source template for the analytics processor, the import is automatically added. See Understand the Source Template of an Analytics Processor.
   2. Define the structure of your analytics object in one of the following ways:

      • Create new fields.

        See Add Fields to an Analytics Object

      • Import a schema file with the field definition.

        See Use Schemas to Define the Fields of Analytics Objects.

      Note:

      If you use this analytics object for an Oracle Database as a Service link:

      • The name of the fields in the analytics objects must be all uppercase letters.

      • The fields that correspond to columns formatted as numbers must be of type double.

      Otherwise the analytics object that you read from the link won’t be initialized.
8. Click Save.

After you save your analytics object, it appears on the list. You can use your analytics object in your links and analytics processors.

You can filter the list of analytics objects by entering a full or partial name in the Search field.

To delete an analytics object, click Delete for the analytics object that you want to delete.

Before deleting an analytics object, verify that you aren’t using it from your analytics processor.

If you delete an analytics object that’s currently used in an analytics processor, then you get a a compilation error when trying to deploy the affected analytics processor.