mirror of
https://github.com/open-metadata/OpenMetadata.git
synced 2025-07-28 03:40:04 +00:00
e2578d6be3
* GitBook: [#177] Documentation Update - Airflow * GitBook: [#195] Removing Cron from databaseServices * GitBook: [#196] Added trino * GitBook: [#197] removed cron from config * GitBook: [#198] Added Redash Documentation * GitBook: [#199] Added Bigquery Usage Documentation * GitBook: [#200] Added page link for presto * GitBook: [#201] Added Local Docker documentation * GitBook: [#202] Added Documentation for Local Docker Setup * GitBook: [#203] Added Git Command to clone Openmetadata in docs * GitBook: [#207] links update * GitBook: [#208] Updating Airflow Documentation * GitBook: [#210] Adding Python installation package under Airflow Lineage config * GitBook: [#211] Change the links to 0.5..0 * GitBook: [#213] Move buried connectors page up * GitBook: [#214] Update to connectors page * GitBook: [#215] Removed sub-categories * GitBook: [#212] Adding Discovery tutorial * GitBook: [#220] Updated steps to H2s. * GitBook: [#230] Complex queries * GitBook: [#231] Add lineage to feature overview * GitBook: [#232] Make feature overview headers verbs instead of nouns * GitBook: [#233] Add data reliability to features overview * GitBook: [#234] Add complex data types to feature overview * GitBook: [#235] Simplify and further distinguish discovery feature headers * GitBook: [#236] Add data importance to feature overview * GitBook: [#237] Break Connectors into its own section * GitBook: [#238] Reorganize first section of docs. * GitBook: [#239] Add connectors to feature overview * GitBook: [#240] Organize layout of feature overview into feature categories as agreed with Harsha. * GitBook: [#242] Make overview paragraph more descriptive. * GitBook: [#243] Create a link to Connectors section from feature overview. * GitBook: [#244] Add "discover data through association" to feature overview. * GitBook: [#245] Update importance and owners gifs * GitBook: [#246] Include a little more descriptive documentation for key features. * GitBook: [#248] Small tweaks to intro paragraph. * GitBook: [#249] Clean up data profiler paragraph. * GitBook: [#250] Promote Complex Data Types to its own feature. * GitBook: [#251] Update to advanced search * GitBook: [#252] Update Roadmap * GitBook: [#254] Remove old features page (text and screenshot based). * GitBook: [#255] Remove references to removed page. * GitBook: [#256] Add Descriptions and Tags section to feature overview. * GitBook: [#257] Update title for "Know Your Data" Co-authored-by: Ayush Shah <ayush.shah@deuexsolutions.com> Co-authored-by: Suresh Srinivas <suresh@getcollate.io> Co-authored-by: Shannon Bradshaw <shannon.bradshaw@arrikto.com> Co-authored-by: OpenMetadata <github@harsha.io>
110 lines
3.7 KiB
Markdown
110 lines
3.7 KiB
Markdown
# Topic
|
|
|
|
This schema defines the Topic entity. A topic is a feed into which messages are published by publishers and read from by consumers in a messaging service.
|
|
|
|
**$id: **[**https://open-metadata.org/schema/entity/data/topic.json**](https://open-metadata.org/schema/entity/data/topic.json)
|
|
|
|
Type: `object`
|
|
|
|
## Properties
|
|
|
|
* **id** `required`
|
|
* Unique identifier that identifies this topic instance.
|
|
* $ref: [../../type/basic.json#/definitions/uuid](../types/basic.md#uuid)
|
|
* **name** `required`
|
|
* Name that identifies the topic.
|
|
* $ref: [#/definitions/topicName](topic.md#topicname)
|
|
* **fullyQualifiedName**
|
|
* Name that uniquely identifies a topic in the format 'messagingServiceName.topicName'.
|
|
* Type: `string`
|
|
* **displayName**
|
|
* Display Name that identifies this topic. It could be title or label from the source services.
|
|
* Type: `string`
|
|
* **description**
|
|
* Description of the topic instance.
|
|
* Type: `string`
|
|
* **version**
|
|
* Metadata version of the entity.
|
|
* $ref: [../../type/basic.json#/definitions/entityVersion](../types/basic.md#entityversion)
|
|
* **updatedAt**
|
|
* Last update time corresponding to the new version of the entity.
|
|
* $ref: [../../type/basic.json#/definitions/dateTime](../types/basic.md#datetime)
|
|
* **updatedBy**
|
|
* User who made the update.
|
|
* Type: `string`
|
|
* **service** `required`
|
|
* Link to the messaging cluster/service where this topic is hosted in.
|
|
* $ref: [../../type/entityReference.json](../types/entityreference.md)
|
|
* **partitions** `required`
|
|
* Number of partitions into which the topic is divided.
|
|
* Type: `integer`
|
|
* Range: ≥ 1
|
|
* **schemaText**
|
|
* Schema used for message serialization. Optional as some topics may not have associated schemas.
|
|
* Type: `string`
|
|
* **schemaType**
|
|
* Schema used for message serialization.
|
|
* $ref: [#/definitions/schemaType](topic.md#schematype)
|
|
* **cleanupPolicies**
|
|
* Topic clean up policies. For Kafka - `cleanup.policy` configuration.
|
|
* Type: `array`
|
|
* **Items**
|
|
* $ref: [#/definitions/cleanupPolicy](topic.md#cleanuppolicy)
|
|
* **retentionTime**
|
|
* Retention time in milliseconds. For Kafka - `retention.ms` configuration.
|
|
* Type: `number`
|
|
* **replicationFactor**
|
|
* Replication Factor in integer (more than 1).
|
|
* Type: `integer`
|
|
* **maximumMessageSize**
|
|
* Maximum message size in bytes. For Kafka - `max.message.bytes` configuration.
|
|
* Type: `integer`
|
|
* **minimumInSyncReplicas**
|
|
* Minimum number replicas in sync to control durability. For Kafka - `min.insync.replicas` configuration.
|
|
* Type: `integer`
|
|
* **retentionSize**
|
|
* Maximum size of a partition in bytes before old data is discarded. For Kafka - `retention.bytes` configuration.
|
|
* Type: `number`
|
|
* Default: _"-1"_
|
|
* **owner**
|
|
* Owner of this topic.
|
|
* $ref: [../../type/entityReference.json](../types/entityreference.md)
|
|
* **followers**
|
|
* Followers of this table.
|
|
* $ref: [../../type/entityReference.json#/definitions/entityReferenceList](../types/entityreference.md#entityreferencelist)
|
|
* **tags**
|
|
* Tags for this table.
|
|
* Type: `array`
|
|
* **Items**
|
|
* $ref: [../../type/tagLabel.json](../types/taglabel.md)
|
|
* **href**
|
|
* Link to the resource corresponding to this entity.
|
|
* $ref: [../../type/basic.json#/definitions/href](../types/basic.md#href)
|
|
|
|
## Type definitions in this schema
|
|
|
|
### topicName
|
|
|
|
* Name that identifies a topic.
|
|
* Type: `string`
|
|
* The value must match this pattern: `^[^.]*$`
|
|
* Length: between 1 and 64
|
|
|
|
### schemaType
|
|
|
|
* Schema type used for the message.
|
|
* The value is restricted to the following:
|
|
1. _"Avro"_
|
|
2. _"Protobuf"_
|
|
3. _"JSON"_
|
|
4. _"Other"_
|
|
|
|
### cleanupPolicy
|
|
|
|
* Topic clean up policy. For Kafka - `cleanup.policy` configuration.
|
|
* The value is restricted to the following:
|
|
1. _"delete"_
|
|
2. _"compact"_
|
|
|
|
_This document was updated on: Monday, October 18, 2021_
|