drill-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From paul-rogers <...@git.apache.org>
Subject [GitHub] drill pull request #1027: DRILL-4779 : Kafka storage plugin
Date Fri, 17 Nov 2017 02:10:53 GMT
Github user paul-rogers commented on a diff in the pull request:

    --- Diff: contrib/storage-kafka/README.md ---
    @@ -0,0 +1,230 @@
    +# Drill Kafka Plugin
    +Drill kafka storage plugin allows you to perform interactive analysis using SQL against
Apache Kafka.
    +<h4 id="Supported kafka versions">Supported Kafka Version</h4>
    +Kafka-0.10 and above </p>
    +<h4 id="Supported Message Formats">Message Formats</h4>
    +Currently this plugin supports reading only Kafka messages of type <strong>JSON</strong>.
    +<h4>Message Readers</h4>
    +<p>Message Readers are used for reading messages from Kafka. Type of the MessageReaders
supported as of now are</p>
    +<table style="width:100%">
    +  <tr>
    +    <th>MessageReader</th>
    +    <th>Description</th>
    +    <th>Key DeSerializer</th> 
    +    <th>Value DeSerializer</th>
    +  </tr>
    +  <tr>
    +    <td>JsonMessageReader</td>
    +    <td>To read Json messages</td>
    +    <td>org.apache.kafka.common.serialization.ByteArrayDeserializer</td>

    +    <td>org.apache.kafka.common.serialization.ByteArrayDeserializer</td>
    +  </tr>
    +<h4 id="Plugin Configurations">Plugin Configurations</h4>
    +Drill Kafka plugin supports following properties
    +   <li><strong>kafkaConsumerProps</strong>: These are typical <a
href="https://kafka.apache.org/documentation/#consumerconfigs">Kafka consumer properties</a>.</li>
    +<li><strong>drillKafkaProps</strong>: These are Drill Kafka plugin
properties. As of now, it supports the following properties
    +	<ul>
    +<li><strong>drill.kafka.message.reader</strong>: Message Reader implementation
to use while reading messages from Kafka. Message reader implementaion should be configured
based on message format. Type of message readers
    + <ul>
    + <li>org.apache.drill.exec.store.kafka.decoders.JsonMessageReader</li>
    + </ul>
    +<li><strong>drill.kafka.poll.timeout</strong>: Polling timeout used
by Kafka client while fetching messages from Kafka cluster.</li>
    +<h4 id="Plugin Registration">Plugin Registration</h4>
    +To register the kafka plugin, open the drill web interface. To open the drill web interface,
enter <strong>http://drillbit:8047/storage</strong> in your browser.
    +<p>The following is an example plugin registration configuration</p>
    +  "type": "kafka",
    +  "kafkaConsumerProps": {
    +    "key.deserializer": "org.apache.kafka.common.serialization.ByteArrayDeserializer",
    +    "auto.offset.reset": "earliest",
    +    "bootstrap.servers": "localhost:9092",
    +    "enable.auto.commit": "true",
    +    "group.id": "drill-query-consumer-1",
    +    "value.deserializer": "org.apache.kafka.common.serialization.ByteArrayDeserializer",
    +    "session.timeout.ms": "30000"
    +  },
    +  "drillKafkaProps": {
    +    "drill.kafka.message.reader": "org.apache.drill.exec.store.kafka.decoders.JsonMessageReader",
    +    "drill.kafka.poll.timeout": "2000"
    +  },
    +  "enabled": true
    +<h4 id="Abstraction"> Abstraction </h4>
    +<p>In Drill, each Kafka topic is mapped to a SQL table and when a query is issued
on a table, it scans all the messages from the earliest offset to the latest offset of that
topic at that point of time. This plugin automatically discovers all the topics (tables),
to allow you perform analysis without executing DDL statements.
    --- End diff --
    Sure, no problem.


View raw message