parthp2107 a07bc411dc
updated json schema and schema docs (#3219)
* updated json schema and schema docs

* added glossay to readme
2022-03-08 09:23:53 +05:30

83 lines
2.8 KiB
Markdown

# Messaging Service
This schema defines the Messaging Service entity, such as Kafka and Pulsar.
**$id:**[**https://open-metadata.org/schema/entity/services/messagingService.json**](https://open-metadata.org/schema/entity/services/messagingService.json)
Type: `object`
This schema <u>does not</u> accept additional properties.
## Properties
- **id** `required`
- Unique identifier of this messaging service instance.
- $ref: [../../type/basic.json#/definitions/uuid](../types/basic.md#uuid)
- **name** `required`
- Name that identifies this messaging service.
- Type: `string`
- The value must match this pattern: `^[^.]*$`
- Length: between 1 and 128
- **serviceType** `required`
- Type of messaging service such as Kafka or Pulsar...
- $ref: [#/definitions/messagingServiceType](#messagingservicetype)
- **description**
- Description of a messaging service instance.
- Type: `string`
- **displayName**
- Display Name that identifies this messaging service. It could be title or label from the source services.
- Type: `string`
- **version**
- Metadata version of the entity.
- $ref: [../../type/entityHistory.json#/definitions/entityVersion](../types/entityhistory.md#entityversion)
- **updatedAt**
- Last update time corresponding to the new version of the entity in Unix epoch time milliseconds.
- $ref: [../../type/basic.json#/definitions/timestamp](../types/basic.md#timestamp)
- **updatedBy**
- User who made the update.
- Type: `string`
- **brokers** `required`
- Multiple bootstrap addresses for Kafka. Single proxy address for Pulsar.
- $ref: [#/definitions/brokers](#brokers)
- **schemaRegistry**
- Schema registry URL.
- Type: `string`
- String format must be a "uri"
- **ingestionSchedule**
- Schedule for running metadata ingestion jobs.
- $ref: [../../type/schedule.json](../types/schedule.md)
- **owner**
- Owner of this messaging service.
- $ref: [../../type/entityReference.json](../types/entityreference.md)
- **href**
- Link to the resource corresponding to this messaging service.
- $ref: [../../type/basic.json#/definitions/href](../types/basic.md#href)
- **changeDescription**
- Change that lead to this version of the entity.
- $ref: [../../type/entityHistory.json#/definitions/changeDescription](../types/entityhistory.md#changedescription)
- **deleted**
- When `true` indicates the entity has been soft deleted.
- Type: `boolean`
- Default: _false_
## Type definitions in this schema
### messagingServiceType
- Type of messaging service - Kafka or Pulsar.
- Type: `string`
- The value is restricted to the following:
1. _"Kafka"_
2. _"Pulsar"_
### brokers
- Multiple bootstrap addresses for Kafka. Single proxy address for Pulsar.
- Type: `array`
- **Items**
- Type: `string`
_This document was updated on: Monday, March 7, 2022_