You can publish your schema to the Artifact Service and further associate the schema with your catalog layer. By default, all published schemas are private and available only for your personal use. You can share your schema with other platform users.
Before publishing the schema, check the values of the
version fields in the project POM file. These values identify your schema on the Platform. Note that the length of the
description field is limited to 1000 characters.
By default, the HERE platform runs a number of validations on the protobuf files to ensure their conformance to the platform style when you:
- Try to publish a nonvalidated schema to the platform, or
- Intend to install a nonvalidated schema in your local Maven repository.
You can disable protobuf validations but note that the HERE platform does not guarantee backward compatibility for any nonvalidated schemas. To ensure that your schema consumers do not experience backward compatibility issues due to breaking changes, please configure your schema project to utilize validation. Otherwise, follow the best practices for schema creation.
To publish a schema, enter the following command in your schema project folder:
To find a newly published schema in the HERE platform portal, select the Data tab and then click Browse schemas.
You can specify your published schema in the layer definition during layer creation. For more information, see the
catalog layer add or
catalog layer update command descriptions in the OLP Command Line Interface Developer Guide.
If the scoped token is used in your credential.properties file, then the schema will be added within the project the token belongs to.
If you don't want to publish your schema and intend to use it locally, you can install the schema in your local Maven repository. To do so, enter the following command in your schema project folder:
After publishing the schema, you can include it in your streaming or batch project as a Maven dependency. For Java bindings, use the artifact from the project with
_java in the title. For Scala bindings, use the artifact from the project with
_scala in the title.
You can include schema artifacts as dependencies in your project if the schema is:
- Installed locally
- Published to the platform by you
- Shared with you
- Defined in a layer of a catalog shared with you
To use a schema in your project, include the target schema artifact in the POM file as a dependency.
To include an existing schema shared with you, see the Artifact Service chapter in Dependency Management.
Schemas are held to the same privacy standards as data, which means that all schemas and data are private by default. Only the schema creator can access the schema until it is shared or used within the HERE platform to operate on data or visualize data on a map.
You can share your schemas with others either through the HERE platform portal or the OLP Command Line Interface (CLI).
To share a schema thourgh the HERE platform portal:
- Open the Data tab.
- Click Browse schemas.
- Find your schema.
- In the dropdown menu, select the version.
- Click the Sharing tab.
- Share your schema with others.
To share a schema via the OLP CLI, see the
schema grant and
schema revoke command descriptions in the Command Line Interface Developer Guide.