Kafka schema examples

Kafka schema examples, one with an inline example and another with an authoritativeDefinitions reference to an external Kafka schema registry.

Signed-off-by: Dirk Van de Poel <dirk.vandepoel@klarrio.com>

Author: dirkvandepoel

docs/examples/schema/kafka-schema.odcs.yaml

@@ -0,0 +1,33 @@
+apiVersion: v3.0.0
+kind: DataContract
+id: orders
+status: development
+name: Orders Event Stream
+version: 0.0.1
+schema:
+- name: Orders
+  physicalName: orders
+  logicalType: object
+  physicalType: topic
+  description: Orders Kafka topic
+  properties:
+    - name: cust_id
+      businessName: Customer ID
+      logicalType: string
+      physicalType: string
+      required: true
+    - name: prod_id
+      businessName: Product ID
+      logicalType: string
+      physicalType: string
+      required: true      
+    - name: qty
+      businessName: Quantity
+      logicalType: integer
+      physicalType: int
+      required: true        
+servers:
+- server: my-kafka
+  type: kafka
+  format: avro
+  host: kafkabroker1:9092

docs/examples/schema/kafka-schemaregistry.odcs.yaml

@@ -0,0 +1,20 @@
+apiVersion: v3.0.0
+kind: DataContract
+id: orders
+status: production
+name: Orders Event Stream
+version: 0.0.1
+schema:
+- name: Orders
+  physicalName: orders
+  logicalType: object
+  physicalType: topic
+  description: Orders Kafka topic
+  authoritativeDefinitions:
+    - url: https://schema-registry:8081
+      type: implementation
+servers:
+- server: my-kafka
+  type: kafka
+  format: avro
+  host: kafkabroker1:9092