A Demo using docker containers

Lets use a real world example to see how hudi works end to end. For this purpose, a self contained data infrastructure is brought up in a local docker cluster within your computer.

The steps have been tested on a Mac laptop

Prerequisites

  • Docker Setup : For Mac, Please follow the steps as defined in [https://docs.docker.com/v17.12/docker-for-mac/install/]. For running Spark-SQL queries, please ensure atleast 6 GB and 4 CPUs are allocated to Docker (See Docker -> Preferences -> Advanced). Otherwise, spark-SQL queries could be killed because of memory issues.
  • kafkacat : A command-line utility to publish/consume from kafka topics. Use brew install kafkacat to install kafkacat
  • /etc/hosts : The demo references many services running in container by the hostname. Add the following settings to /etc/hosts
  1.    127.0.0.1 adhoc-1
  2.    127.0.0.1 adhoc-2
  3.    127.0.0.1 namenode
  4.    127.0.0.1 datanode1
  5.    127.0.0.1 hiveserver
  6.    127.0.0.1 hivemetastore
  7.    127.0.0.1 kafkabroker
  8.    127.0.0.1 sparkmaster
  9.    127.0.0.1 zookeeper

Also, this has not been tested on some environments like Docker on Windows.

Setting up Docker Cluster

Build Hudi

The first step is to build hudi

  1. cd <HUDI_WORKSPACE>
  2. mvn package -DskipTests

Bringing up Demo Cluster

The next step is to run the docker compose script and setup configs for bringing up the cluster. This should pull the docker images from docker hub and setup docker cluster.

  1. cd docker
  2. ./setup_demo.sh
  3. ....
  4. ....
  5. ....
  6. Stopping spark-worker-1            ... done
  7. Stopping hiveserver                ... done
  8. Stopping hivemetastore             ... done
  9. Stopping historyserver             ... done
  10. .......
  11. ......
  12. Creating network "hudi_demo" with the default driver
  13. Creating hive-metastore-postgresql ... done
  14. Creating namenode                  ... done
  15. Creating zookeeper                 ... done
  16. Creating kafkabroker               ... done
  17. Creating hivemetastore             ... done
  18. Creating historyserver             ... done
  19. Creating hiveserver                ... done
  20. Creating datanode1                 ... done
  21. Creating sparkmaster               ... done
  22. Creating adhoc-1                   ... done
  23. Creating adhoc-2                   ... done
  24. Creating spark-worker-1            ... done
  25. Copying spark default config and setting up configs
  26. Copying spark default config and setting up configs
  27. Copying spark default config and setting up configs
  28. varadarb-C02SG7Q3G8WP:docker varadarb$ docker ps

At this point, the docker cluster will be up and running. The demo cluster brings up the following services

  • HDFS Services (NameNode, DataNode)
  • Spark Master and Worker
  • Hive Services (Metastore, HiveServer2 along with PostgresDB)
  • Kafka Broker and a Zookeeper Node (Kakfa will be used as upstream source for the demo)
  • Adhoc containers to run Hudi/Hive CLI commands

Demo

Stock Tracker data will be used to showcase both different Hudi Views and the effects of Compaction.

Take a look at the directory docker/demo/data. There are 2 batches of stock data - each at 1 minute granularity. The first batch contains stocker tracker data for some stock symbols during the first hour of trading window (9:30 a.m to 10:30 a.m). The second batch contains tracker data for next 30 mins (10:30 - 11 a.m). Hudi will be used to ingest these batches to a dataset which will contain the latest stock tracker data at hour level granularity. The batches are windowed intentionally so that the second batch contains updates to some of the rows in the first batch.

Step 1 : Publish the first batch to Kafka

Upload the first batch to Kafka topic ‘stock ticks’

  1. cat docker/demo/data/batch_1.json | kafkacat -b kafkabroker -t stock_ticks -P
  3. To check if the new topic shows up, use
  4. kafkacat -b kafkabroker -L -J | jq .
  5. {
  6.   "originating_broker": {
  7.     "id": 1001,
  8.     "name": "kafkabroker:9092/1001"
  9.   },
  10.   "query": {
  11.     "topic": "*"
  12.   },
  13.   "brokers": [
  14.     {
  15.       "id": 1001,
  16.       "name": "kafkabroker:9092"
  17.     }
  18.   ],
  19.   "topics": [
  20.     {
  21.       "topic": "stock_ticks",
  22.       "partitions": [
  23.         {
  24.           "partition": 0,
  25.           "leader": 1001,
  26.           "replicas": [
  27.             {
  28.               "id": 1001
  29.             }
  30.           ],
  31.           "isrs": [
  32.             {
  33.               "id": 1001
  34.             }
  35.           ]
  36.         }
  37.       ]
  38.     }
  39.   ]
  40. }

Step 2: Incrementally ingest data from Kafka topic

Hudi comes with a tool named DeltaStreamer. This tool can connect to variety of data sources (including Kafka) to pull changes and apply to Hudi dataset using upsert/insert primitives. Here, we will use the tool to download json data from kafka topic and ingest to both COW and MOR tables we initialized in the previous step. This tool automatically initializes the datasets in the file-system if they do not exist yet.

  1. docker exec -it adhoc-2 /bin/bash
  3. # Run the following spark-submit command to execute the delta-streamer and ingest to stock_ticks_cow dataset in HDFS
  4. spark-submit --class org.apache.hudi.utilities.deltastreamer.HoodieDeltaStreamer $HUDI_UTILITIES_BUNDLE --storage-type COPY_ON_WRITE --source-class org.apache.hudi.utilities.sources.JsonKafkaSource --source-ordering-field ts  --target-base-path /user/hive/warehouse/stock_ticks_cow --target-table stock_ticks_cow --props /var/demo/config/kafka-source.properties --schemaprovider-class org.apache.hudi.utilities.schema.FilebasedSchemaProvider
  5. ....
  6. ....
  7. 2018-09-24 22:20:00 INFO  OutputCommitCoordinator$OutputCommitCoordinatorEndpoint:54 - OutputCommitCoordinator stopped!
  8. 2018-09-24 22:20:00 INFO  SparkContext:54 - Successfully stopped SparkContext
  12. # Run the following spark-submit command to execute the delta-streamer and ingest to stock_ticks_mor dataset in HDFS
  13. spark-submit --class org.apache.hudi.utilities.deltastreamer.HoodieDeltaStreamer $HUDI_UTILITIES_BUNDLE --storage-type MERGE_ON_READ --source-class org.apache.hudi.utilities.sources.JsonKafkaSource --source-ordering-field ts  --target-base-path /user/hive/warehouse/stock_ticks_mor --target-table stock_ticks_mor --props /var/demo/config/kafka-source.properties --schemaprovider-class org.apache.hudi.utilities.schema.FilebasedSchemaProvider --disable-compaction
  14. ....
  15. 2018-09-24 22:22:01 INFO  OutputCommitCoordinator$OutputCommitCoordinatorEndpoint:54 - OutputCommitCoordinator stopped!
  16. 2018-09-24 22:22:01 INFO  SparkContext:54 - Successfully stopped SparkContext
  17. ....
  19. # As part of the setup (Look at setup_demo.sh), the configs needed for DeltaStreamer is uploaded to HDFS. The configs
  20. # contain mostly Kafa connectivity settings, the avro-schema to be used for ingesting along with key and partitioning fields.
  22. exit

You can use HDFS web-browser to look at the datasets http://namenode:50070/explorer.html#/user/hive/warehouse/stock_ticks_cow.

You can explore the new partition folder created in the dataset along with a “deltacommit” file under .hoodie which signals a successful commit.

There will be a similar setup when you browse the MOR dataset http://namenode:50070/explorer.html#/user/hive/warehouse/stock_ticks_mor

Step 3: Sync with Hive

At this step, the datasets are available in HDFS. We need to sync with Hive to create new Hive tables and add partitions inorder to run Hive queries against those datasets.

  1. docker exec -it adhoc-2 /bin/bash
  3. # THis command takes in HIveServer URL and COW Hudi Dataset location in HDFS and sync the HDFS state to Hive
  4. /var/hoodie/ws/hudi-hive/run_sync_tool.sh  --jdbc-url jdbc:hive2://hiveserver:10000 --user hive --pass hive --partitioned-by dt --base-path /user/hive/warehouse/stock_ticks_cow --database default --table stock_ticks_cow
  5. .....
  6. 2018-09-24 22:22:45,568 INFO  [main] hive.HiveSyncTool (HiveSyncTool.java:syncHoodieTable(112)) - Sync complete for stock_ticks_cow
  7. .....
  9. # Now run hive-sync for the second data-set in HDFS using Merge-On-Read (MOR storage)
  10. /var/hoodie/ws/hudi-hive/run_sync_tool.sh  --jdbc-url jdbc:hive2://hiveserver:10000 --user hive --pass hive --partitioned-by dt --base-path /user/hive/warehouse/stock_ticks_mor --database default --table stock_ticks_mor
  11. ...
  12. 2018-09-24 22:23:09,171 INFO  [main] hive.HiveSyncTool (HiveSyncTool.java:syncHoodieTable(112)) - Sync complete for stock_ticks_mor
  13. ...
  14. 2018-09-24 22:23:09,559 INFO  [main] hive.HiveSyncTool (HiveSyncTool.java:syncHoodieTable(112)) - Sync complete for stock_ticks_mor_rt
  15. ....
  16. exit

After executing the above command, you will notice

  1. A hive table named stock_ticks_cow created which provides Read-Optimized view for the Copy On Write dataset.
  2. Two new tables stock_ticks_mor and stock_ticks_mor_rt created for the Merge On Read dataset. The former provides the ReadOptimized view for the Hudi dataset and the later provides the realtime-view for the dataset.

Step 4 (a): Run Hive Queries

Run a hive query to find the latest timestamp ingested for stock symbol ‘GOOG’. You will notice that both read-optimized (for both COW and MOR dataset)and realtime views (for MOR dataset)give the same value “10:29 a.m” as Hudi create a parquet file for the first batch of data.

  1. docker exec -it adhoc-2 /bin/bash
  2. beeline -u jdbc:hive2://hiveserver:10000 --hiveconf hive.input.format=org.apache.hadoop.hive.ql.io.HiveInputFormat --hiveconf hive.stats.autogather=false
  3. # List Tables
  4. 0: jdbc:hive2://hiveserver:10000> show tables;
  5. +---------------------+--+
  6. |      tab_name       |
  7. +---------------------+--+
  8. | stock_ticks_cow     |
  9. | stock_ticks_mor     |
  10. | stock_ticks_mor_rt  |
  11. +---------------------+--+
  12. 2 rows selected (0.801 seconds)
  13. 0: jdbc:hive2://hiveserver:10000>
  16. # Look at partitions that were added
  17. 0: jdbc:hive2://hiveserver:10000> show partitions stock_ticks_mor_rt;
  18. +----------------+--+
  19. |   partition    |
  20. +----------------+--+
  21. | dt=2018-08-31  |
  22. +----------------+--+
  23. 1 row selected (0.24 seconds)
  26. # COPY-ON-WRITE Queries:
  27. =========================
  30. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_cow group by symbol HAVING symbol = 'GOOG';
  31. +---------+----------------------+--+
  32. | symbol  |         _c1          |
  33. +---------+----------------------+--+
  34. | GOOG    | 2018-08-31 10:29:00  |
  35. +---------+----------------------+--+
  37. Now, run a projection query:
  39. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG';
  40. +----------------------+---------+----------------------+---------+------------+-----------+--+
  41. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  42. +----------------------+---------+----------------------+---------+------------+-----------+--+
  43. | 20180924221953       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  44. | 20180924221953       | GOOG    | 2018-08-31 10:29:00  | 3391    | 1230.1899  | 1230.085  |
  45. +----------------------+---------+----------------------+---------+------------+-----------+--+
  48. # Merge-On-Read Queries:
  49. ==========================
  51. Lets run similar queries against M-O-R dataset. Lets look at both
  52. ReadOptimized and Realtime views supported by M-O-R dataset
  54. # Run against ReadOptimized View. Notice that the latest timestamp is 10:29
  55. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG';
  56. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  57. +---------+----------------------+--+
  58. | symbol  |         _c1          |
  59. +---------+----------------------+--+
  60. | GOOG    | 2018-08-31 10:29:00  |
  61. +---------+----------------------+--+
  62. 1 row selected (6.326 seconds)
  65. # Run against Realtime View. Notice that the latest timestamp is again 10:29
  67. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG';
  68. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  69. +---------+----------------------+--+
  70. | symbol  |         _c1          |
  71. +---------+----------------------+--+
  72. | GOOG    | 2018-08-31 10:29:00  |
  73. +---------+----------------------+--+
  74. 1 row selected (1.606 seconds)
  77. # Run projection query against Read Optimized and Realtime tables
  79. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG';
  80. +----------------------+---------+----------------------+---------+------------+-----------+--+
  81. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  82. +----------------------+---------+----------------------+---------+------------+-----------+--+
  83. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  84. | 20180924222155       | GOOG    | 2018-08-31 10:29:00  | 3391    | 1230.1899  | 1230.085  |
  85. +----------------------+---------+----------------------+---------+------------+-----------+--+
  87. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG';
  88. +----------------------+---------+----------------------+---------+------------+-----------+--+
  89. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  90. +----------------------+---------+----------------------+---------+------------+-----------+--+
  91. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  92. | 20180924222155       | GOOG    | 2018-08-31 10:29:00  | 3391    | 1230.1899  | 1230.085  |
  93. +----------------------+---------+----------------------+---------+------------+-----------+--+
  95. exit
  96. exit

Step 4 (b): Run Spark-SQL Queries

Hudi support Spark as query processor just like Hive. Here are the same hive queries running in spark-sql

  1. docker exec -it adhoc-1 /bin/bash
  2. $SPARK_INSTALL/bin/spark-shell --jars $HUDI_SPARK_BUNDLE --master local[2] --driver-class-path $HADOOP_CONF_DIR --conf spark.sql.hive.convertMetastoreParquet=false --deploy-mode client  --driver-memory 1G --executor-memory 3G --num-executors 1  --packages com.databricks:spark-avro_2.11:4.0.0
  3. ...
  5. Welcome to
  6.       ____              __
  7.      / __/__  ___ _____/ /__
  8.     _\ \/ _ \/ _ `/ __/  '_/
  9.    /___/ .__/\_,_/_/ /_/\_\   version 2.3.1
  10.       /_/
  12. Using Scala version 2.11.8 (Java HotSpot(TM) 64-Bit Server VM, Java 1.8.0_181)
  13. Type in expressions to have them evaluated.
  14. Type :help for more information.
  16. scala>
  17. scala> spark.sql("show tables").show(100, false)
  18. +--------+------------------+-----------+
  19. |database|tableName         |isTemporary|
  20. +--------+------------------+-----------+
  21. |default |stock_ticks_cow   |false      |
  22. |default |stock_ticks_mor   |false      |
  23. |default |stock_ticks_mor_rt|false      |
  24. +--------+------------------+-----------+
  26. # Copy-On-Write Table
  28. ## Run max timestamp query against COW table
  30. scala> spark.sql("select symbol, max(ts) from stock_ticks_cow group by symbol HAVING symbol = 'GOOG'").show(100, false)
  31. [Stage 0:>                                                          (0 + 1) / 1]SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
  32. SLF4J: Defaulting to no-operation (NOP) logger implementation
  33. SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
  34. +------+-------------------+
  35. |symbol|max(ts)            |
  36. +------+-------------------+
  37. |GOOG  |2018-08-31 10:29:00|
  38. +------+-------------------+
  40. ## Projection Query
  42. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG'").show(100, false)
  43. +-------------------+------+-------------------+------+---------+--------+
  44. |_hoodie_commit_time|symbol|ts                 |volume|open     |close   |
  45. +-------------------+------+-------------------+------+---------+--------+
  46. |20180924221953     |GOOG  |2018-08-31 09:59:00|6330  |1230.5   |1230.02 |
  47. |20180924221953     |GOOG  |2018-08-31 10:29:00|3391  |1230.1899|1230.085|
  48. +-------------------+------+-------------------+------+---------+--------+
  50. # Merge-On-Read Queries:
  51. ==========================
  53. Lets run similar queries against M-O-R dataset. Lets look at both
  54. ReadOptimized and Realtime views supported by M-O-R dataset
  56. # Run against ReadOptimized View. Notice that the latest timestamp is 10:29
  57. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG'").show(100, false)
  58. +------+-------------------+
  59. |symbol|max(ts)            |
  60. +------+-------------------+
  61. |GOOG  |2018-08-31 10:29:00|
  62. +------+-------------------+
  65. # Run against Realtime View. Notice that the latest timestamp is again 10:29
  67. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG'").show(100, false)
  68. +------+-------------------+
  69. |symbol|max(ts)            |
  70. +------+-------------------+
  71. |GOOG  |2018-08-31 10:29:00|
  72. +------+-------------------+
  74. # Run projection query against Read Optimized and Realtime tables
  76. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG'").show(100, false)
  77. +-------------------+------+-------------------+------+---------+--------+
  78. |_hoodie_commit_time|symbol|ts                 |volume|open     |close   |
  79. +-------------------+------+-------------------+------+---------+--------+
  80. |20180924222155     |GOOG  |2018-08-31 09:59:00|6330  |1230.5   |1230.02 |
  81. |20180924222155     |GOOG  |2018-08-31 10:29:00|3391  |1230.1899|1230.085|
  82. +-------------------+------+-------------------+------+---------+--------+
  84. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG'").show(100, false)
  85. +-------------------+------+-------------------+------+---------+--------+
  86. |_hoodie_commit_time|symbol|ts                 |volume|open     |close   |
  87. +-------------------+------+-------------------+------+---------+--------+
  88. |20180924222155     |GOOG  |2018-08-31 09:59:00|6330  |1230.5   |1230.02 |
  89. |20180924222155     |GOOG  |2018-08-31 10:29:00|3391  |1230.1899|1230.085|
  90. +-------------------+------+-------------------+------+---------+--------+

Step 5: Upload second batch to Kafka and run DeltaStreamer to ingest

Upload the second batch of data and ingest this batch using delta-streamer. As this batch does not bring in any new partitions, there is no need to run hive-sync

  1. cat docker/demo/data/batch_2.json | kafkacat -b kafkabroker -t stock_ticks -P
  3. # Within Docker container, run the ingestion command
  4. docker exec -it adhoc-2 /bin/bash
  6. # Run the following spark-submit command to execute the delta-streamer and ingest to stock_ticks_cow dataset in HDFS
  7. spark-submit --class org.apache.hudi.utilities.deltastreamer.HoodieDeltaStreamer $HUDI_UTILITIES_BUNDLE --storage-type COPY_ON_WRITE --source-class org.apache.hudi.utilities.sources.JsonKafkaSource --source-ordering-field ts  --target-base-path /user/hive/warehouse/stock_ticks_cow --target-table stock_ticks_cow --props /var/demo/config/kafka-source.properties --schemaprovider-class org.apache.hudi.utilities.schema.FilebasedSchemaProvider
  10. # Run the following spark-submit command to execute the delta-streamer and ingest to stock_ticks_mor dataset in HDFS
  11. spark-submit --class org.apache.hudi.utilities.deltastreamer.HoodieDeltaStreamer $HUDI_UTILITIES_BUNDLE --storage-type MERGE_ON_READ --source-class org.apache.hudi.utilities.sources.JsonKafkaSource --source-ordering-field ts  --target-base-path /user/hive/warehouse/stock_ticks_mor --target-table stock_ticks_mor --props /var/demo/config/kafka-source.properties --schemaprovider-class org.apache.hudi.utilities.schema.FilebasedSchemaProvider --disable-compaction
  13. exit

With Copy-On-Write table, the second ingestion by DeltaStreamer resulted in a new version of Parquet file getting created. See http://namenode:50070/explorer.html#/user/hive/warehouse/stock_ticks_cow/2018/08/31

With Merge-On-Read table, the second ingestion merely appended the batch to an unmerged delta (log) file. Take a look at the HDFS filesystem to get an idea: http://namenode:50070/explorer.html#/user/hive/warehouse/stock_ticks_mor/2018/08/31

Step 6(a): Run Hive Queries

With Copy-On-Write table, the read-optimized view immediately sees the changes as part of second batch once the batch got committed as each ingestion creates newer versions of parquet files.

With Merge-On-Read table, the second ingestion merely appended the batch to an unmerged delta (log) file. This is the time, when ReadOptimized and Realtime views will provide different results. ReadOptimized view will still return “10:29 am” as it will only read from the Parquet file. Realtime View will do on-the-fly merge and return latest committed data which is “10:59 a.m”.

  1. docker exec -it adhoc-2 /bin/bash
  2. beeline -u jdbc:hive2://hiveserver:10000 --hiveconf hive.input.format=org.apache.hadoop.hive.ql.io.HiveInputFormat --hiveconf hive.stats.autogather=false
  4. # Copy On Write Table:
  6. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_cow group by symbol HAVING symbol = 'GOOG';
  7. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  8. +---------+----------------------+--+
  9. | symbol  |         _c1          |
  10. +---------+----------------------+--+
  11. | GOOG    | 2018-08-31 10:59:00  |
  12. +---------+----------------------+--+
  13. 1 row selected (1.932 seconds)
  15. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG';
  16. +----------------------+---------+----------------------+---------+------------+-----------+--+
  17. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  18. +----------------------+---------+----------------------+---------+------------+-----------+--+
  19. | 20180924221953       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  20. | 20180924224524       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  21. +----------------------+---------+----------------------+---------+------------+-----------+--+
  23. As you can notice, the above queries now reflect the changes that came as part of ingesting second batch.
  26. # Merge On Read Table:
  28. # Read Optimized View
  29. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG';
  30. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  31. +---------+----------------------+--+
  32. | symbol  |         _c1          |
  33. +---------+----------------------+--+
  34. | GOOG    | 2018-08-31 10:29:00  |
  35. +---------+----------------------+--+
  36. 1 row selected (1.6 seconds)
  38. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG';
  39. +----------------------+---------+----------------------+---------+------------+-----------+--+
  40. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  41. +----------------------+---------+----------------------+---------+------------+-----------+--+
  42. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  43. | 20180924222155       | GOOG    | 2018-08-31 10:29:00  | 3391    | 1230.1899  | 1230.085  |
  44. +----------------------+---------+----------------------+---------+------------+-----------+--+
  46. # Realtime View
  47. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG';
  48. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  49. +---------+----------------------+--+
  50. | symbol  |         _c1          |
  51. +---------+----------------------+--+
  52. | GOOG    | 2018-08-31 10:59:00  |
  53. +---------+----------------------+--+
  55. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG';
  56. +----------------------+---------+----------------------+---------+------------+-----------+--+
  57. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  58. +----------------------+---------+----------------------+---------+------------+-----------+--+
  59. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  60. | 20180924224537       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  61. +----------------------+---------+----------------------+---------+------------+-----------+--+
  63. exit
  64. exit

Step 6(b): Run Spark SQL Queries

Running the same queries in Spark-SQL:

  1. docker exec -it adhoc-1 /bin/bash
  2. bash-4.4# $SPARK_INSTALL/bin/spark-shell --jars $HUDI_SPARK_BUNDLE --driver-class-path $HADOOP_CONF_DIR --conf spark.sql.hive.convertMetastoreParquet=false --deploy-mode client  --driver-memory 1G --master local[2] --executor-memory 3G --num-executors 1  --packages com.databricks:spark-avro_2.11:4.0.0
  4. # Copy On Write Table:
  6. scala> spark.sql("select symbol, max(ts) from stock_ticks_cow group by symbol HAVING symbol = 'GOOG'").show(100, false)
  7. +------+-------------------+
  8. |symbol|max(ts)            |
  9. +------+-------------------+
  10. |GOOG  |2018-08-31 10:59:00|
  11. +------+-------------------+
  13. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG'").show(100, false)
  15. +----------------------+---------+----------------------+---------+------------+-----------+--+
  16. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  17. +----------------------+---------+----------------------+---------+------------+-----------+--+
  18. | 20180924221953       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  19. | 20180924224524       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  20. +----------------------+---------+----------------------+---------+------------+-----------+--+
  22. As you can notice, the above queries now reflect the changes that came as part of ingesting second batch.
  25. # Merge On Read Table:
  27. # Read Optimized View
  28. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG'").show(100, false)
  29. +---------+----------------------+--+
  30. | symbol  |         _c1          |
  31. +---------+----------------------+--+
  32. | GOOG    | 2018-08-31 10:29:00  |
  33. +---------+----------------------+--+
  34. 1 row selected (1.6 seconds)
  36. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG'").show(100, false)
  37. +----------------------+---------+----------------------+---------+------------+-----------+--+
  38. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  39. +----------------------+---------+----------------------+---------+------------+-----------+--+
  40. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  41. | 20180924222155       | GOOG    | 2018-08-31 10:29:00  | 3391    | 1230.1899  | 1230.085  |
  42. +----------------------+---------+----------------------+---------+------------+-----------+--+
  44. # Realtime View
  45. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG'").show(100, false)
  46. +---------+----------------------+--+
  47. | symbol  |         _c1          |
  48. +---------+----------------------+--+
  49. | GOOG    | 2018-08-31 10:59:00  |
  50. +---------+----------------------+--+
  52. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG'").show(100, false)
  53. +----------------------+---------+----------------------+---------+------------+-----------+--+
  54. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  55. +----------------------+---------+----------------------+---------+------------+-----------+--+
  56. | 20180924222155       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  57. | 20180924224537       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  58. +----------------------+---------+----------------------+---------+------------+-----------+--+
  60. exit
  61. exit

Step 7 : Incremental Query for COPY-ON-WRITE Table

With 2 batches of data ingested, lets showcase the support for incremental queries in Hudi Copy-On-Write datasets

Lets take the same projection query example

  1. docker exec -it adhoc-2 /bin/bash
  2. beeline -u jdbc:hive2://hiveserver:10000 --hiveconf hive.input.format=org.apache.hadoop.hive.ql.io.HiveInputFormat --hiveconf hive.stats.autogather=false
  4. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG';
  5. +----------------------+---------+----------------------+---------+------------+-----------+--+
  6. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  7. +----------------------+---------+----------------------+---------+------------+-----------+--+
  8. | 20180924064621       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  9. | 20180924065039       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  10. +----------------------+---------+----------------------+---------+------------+-----------+--+

As you notice from the above queries, there are 2 commits - 20180924064621 and 20180924065039 in timeline order. When you follow the steps, you will be getting different timestamps for commits. Substitute them in place of the above timestamps.

To show the effects of incremental-query, let us assume that a reader has already seen the changes as part of ingesting first batch. Now, for the reader to see effect of the second batch, he/she has to keep the start timestamp to the commit time of the first batch (20180924064621) and run incremental query

Hudi incremental mode provides efficient scanning for incremental queries by filtering out files that do not have any candidate rows using hudi-managed metadata.

  1. docker exec -it adhoc-2 /bin/bash
  2. beeline -u jdbc:hive2://hiveserver:10000 --hiveconf hive.input.format=org.apache.hadoop.hive.ql.io.HiveInputFormat --hiveconf hive.stats.autogather=false
  3. 0: jdbc:hive2://hiveserver:10000> set hoodie.stock_ticks_cow.consume.mode=INCREMENTAL;
  4. No rows affected (0.009 seconds)
  5. 0: jdbc:hive2://hiveserver:10000>  set hoodie.stock_ticks_cow.consume.max.commits=3;
  6. No rows affected (0.009 seconds)
  7. 0: jdbc:hive2://hiveserver:10000> set hoodie.stock_ticks_cow.consume.start.timestamp=20180924064621;

With the above setting, file-ids that do not have any updates from the commit 20180924065039 is filtered out without scanning. Here is the incremental query :

  1. 0: jdbc:hive2://hiveserver:10000>
  2. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow where  symbol = 'GOOG' and `_hoodie_commit_time` > '20180924064621';
  3. +----------------------+---------+----------------------+---------+------------+-----------+--+
  4. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  5. +----------------------+---------+----------------------+---------+------------+-----------+--+
  6. | 20180924065039       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  7. +----------------------+---------+----------------------+---------+------------+-----------+--+
  8. 1 row selected (0.83 seconds)
  9. 0: jdbc:hive2://hiveserver:10000>
Incremental Query with Spark SQL:
  1. docker exec -it adhoc-1 /bin/bash
  2. bash-4.4# $SPARK_INSTALL/bin/spark-shell --jars $HUDI_SPARK_BUNDLE --driver-class-path $HADOOP_CONF_DIR --conf spark.sql.hive.convertMetastoreParquet=false --deploy-mode client  --driver-memory 1G --master local[2] --executor-memory 3G --num-executors 1  --packages com.databricks:spark-avro_2.11:4.0.0
  3. Welcome to
  4.       ____              __
  5.      / __/__  ___ _____/ /__
  6.     _\ \/ _ \/ _ `/ __/  '_/
  7.    /___/ .__/\_,_/_/ /_/\_\   version 2.3.1
  8.       /_/
  10. Using Scala version 2.11.8 (Java HotSpot(TM) 64-Bit Server VM, Java 1.8.0_181)
  11. Type in expressions to have them evaluated.
  12. Type :help for more information.
  14. scala> import org.apache.hudi.DataSourceReadOptions
  15. import org.apache.hudi.DataSourceReadOptions
  17. # In the below query, 20180925045257 is the first commit's timestamp
  18. scala> val hoodieIncViewDF =  spark.read.format("org.apache.hudi").option(DataSourceReadOptions.VIEW_TYPE_OPT_KEY, DataSourceReadOptions.VIEW_TYPE_INCREMENTAL_OPT_VAL).option(DataSourceReadOptions.BEGIN_INSTANTTIME_OPT_KEY, "20180924064621").load("/user/hive/warehouse/stock_ticks_cow")
  19. SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
  20. SLF4J: Defaulting to no-operation (NOP) logger implementation
  21. SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
  22. hoodieIncViewDF: org.apache.spark.sql.DataFrame = [_hoodie_commit_time: string, _hoodie_commit_seqno: string ... 15 more fields]
  24. scala> hoodieIncViewDF.registerTempTable("stock_ticks_cow_incr_tmp1")
  25. warning: there was one deprecation warning; re-run with -deprecation for details
  27. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_cow_incr_tmp1 where  symbol = 'GOOG'").show(100, false);
  28. +----------------------+---------+----------------------+---------+------------+-----------+--+
  29. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  30. +----------------------+---------+----------------------+---------+------------+-----------+--+
  31. | 20180924065039       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  32. +----------------------+---------+----------------------+---------+------------+-----------+--+

Step 8: Schedule and Run Compaction for Merge-On-Read dataset

Lets schedule and run a compaction to create a new version of columnar file so that read-optimized readers will see fresher data. Again, You can use Hudi CLI to manually schedule and run compaction

  1. docker exec -it adhoc-1 /bin/bash
  2. root@adhoc-1:/opt#   /var/hoodie/ws/hudi-cli/hudi-cli.sh
  3. ============================================
  4. *                                          *
  5. *     _    _           _   _               *
  6. *    | |  | |         | | (_)              *
  7. *    | |__| |       __| |  -               *
  8. *    |  __  ||   | / _` | ||               *
  9. *    | |  | ||   || (_| | ||               *
  10. *    |_|  |_|\___/ \____/ ||               *
  11. *                                          *
  12. ============================================
  14. Welcome to Hoodie CLI. Please type help if you are looking for help.
  15. hudi->connect --path /user/hive/warehouse/stock_ticks_mor
  16. 18/09/24 06:59:34 WARN util.NativeCodeLoader: Unable to load native-hadoop library for your platform... using builtin-java classes where applicable
  17. 18/09/24 06:59:35 INFO table.HoodieTableMetaClient: Loading HoodieTableMetaClient from /user/hive/warehouse/stock_ticks_mor
  18. 18/09/24 06:59:35 INFO util.FSUtils: Hadoop Configuration: fs.defaultFS: [hdfs://namenode:8020], Config:[Configuration: core-default.xml, core-site.xml, mapred-default.xml, mapred-site.xml, yarn-default.xml, yarn-site.xml, hdfs-default.xml, hdfs-site.xml], FileSystem: [DFS[DFSClient[clientName=DFSClient_NONMAPREDUCE_-1261652683_11, ugi=root (auth:SIMPLE)]]]
  19. 18/09/24 06:59:35 INFO table.HoodieTableConfig: Loading dataset properties from /user/hive/warehouse/stock_ticks_mor/.hoodie/hoodie.properties
  20. 18/09/24 06:59:36 INFO table.HoodieTableMetaClient: Finished Loading Table of type MERGE_ON_READ from /user/hive/warehouse/stock_ticks_mor
  21. Metadata for table stock_ticks_mor loaded
  23. # Ensure no compactions are present
  25. hoodie:stock_ticks_mor->compactions show all
  26. 18/09/24 06:59:54 INFO timeline.HoodieActiveTimeline: Loaded instants [[20180924064636__clean__COMPLETED], [20180924064636__deltacommit__COMPLETED], [20180924065057__clean__COMPLETED], [20180924065057__deltacommit__COMPLETED]]
  27.     ___________________________________________________________________
  28.     | Compaction Instant Time| State    | Total FileIds to be Compacted|
  29.     |==================================================================|
  34. # Schedule a compaction. This will use Spark Launcher to schedule compaction
  35. hoodie:stock_ticks_mor->compaction schedule
  36. ....
  37. Compaction successfully completed for 20180924070031
  39. # Now refresh and check again. You will see that there is a new compaction requested
  41. hoodie:stock_ticks->connect --path /user/hive/warehouse/stock_ticks_mor
  42. 18/09/24 07:01:16 INFO table.HoodieTableMetaClient: Loading HoodieTableMetaClient from /user/hive/warehouse/stock_ticks_mor
  43. 18/09/24 07:01:16 INFO util.FSUtils: Hadoop Configuration: fs.defaultFS: [hdfs://namenode:8020], Config:[Configuration: core-default.xml, core-site.xml, mapred-default.xml, mapred-site.xml, yarn-default.xml, yarn-site.xml, hdfs-default.xml, hdfs-site.xml], FileSystem: [DFS[DFSClient[clientName=DFSClient_NONMAPREDUCE_-1261652683_11, ugi=root (auth:SIMPLE)]]]
  44. 18/09/24 07:01:16 INFO table.HoodieTableConfig: Loading dataset properties from /user/hive/warehouse/stock_ticks_mor/.hoodie/hoodie.properties
  45. 18/09/24 07:01:16 INFO table.HoodieTableMetaClient: Finished Loading Table of type MERGE_ON_READ from /user/hive/warehouse/stock_ticks_mor
  46. Metadata for table stock_ticks_mor loaded
  50. hoodie:stock_ticks_mor->compactions show all
  51. 18/09/24 06:34:12 INFO timeline.HoodieActiveTimeline: Loaded instants [[20180924041125__clean__COMPLETED], [20180924041125__deltacommit__COMPLETED], [20180924042735__clean__COMPLETED], [20180924042735__deltacommit__COMPLETED], [==>20180924063245__compaction__REQUESTED]]
  52.     ___________________________________________________________________
  53.     | Compaction Instant Time| State    | Total FileIds to be Compacted|
  54.     |==================================================================|
  55.     | 20180924070031         | REQUESTED| 1                            |
  60. # Execute the compaction. The compaction instant value passed below must be the one displayed in the above "compactions show all" query
  61. hoodie:stock_ticks_mor->compaction run --compactionInstant  20180924070031 --parallelism 2 --sparkMemory 1G  --schemaFilePath /var/demo/config/schema.avsc --retry 1  
  62. ....
  63. Compaction successfully completed for 20180924070031
  66. ## Now check if compaction is completed
  68. hoodie:stock_ticks_mor->connect --path /user/hive/warehouse/stock_ticks_mor
  69. 18/09/24 07:03:00 INFO table.HoodieTableMetaClient: Loading HoodieTableMetaClient from /user/hive/warehouse/stock_ticks_mor
  70. 18/09/24 07:03:00 INFO util.FSUtils: Hadoop Configuration: fs.defaultFS: [hdfs://namenode:8020], Config:[Configuration: core-default.xml, core-site.xml, mapred-default.xml, mapred-site.xml, yarn-default.xml, yarn-site.xml, hdfs-default.xml, hdfs-site.xml], FileSystem: [DFS[DFSClient[clientName=DFSClient_NONMAPREDUCE_-1261652683_11, ugi=root (auth:SIMPLE)]]]
  71. 18/09/24 07:03:00 INFO table.HoodieTableConfig: Loading dataset properties from /user/hive/warehouse/stock_ticks_mor/.hoodie/hoodie.properties
  72. 18/09/24 07:03:00 INFO table.HoodieTableMetaClient: Finished Loading Table of type MERGE_ON_READ from /user/hive/warehouse/stock_ticks_mor
  73. Metadata for table stock_ticks_mor loaded
  77. hoodie:stock_ticks->compactions show all
  78. 18/09/24 07:03:15 INFO timeline.HoodieActiveTimeline: Loaded instants [[20180924064636__clean__COMPLETED], [20180924064636__deltacommit__COMPLETED], [20180924065057__clean__COMPLETED], [20180924065057__deltacommit__COMPLETED], [20180924070031__commit__COMPLETED]]
  79.     ___________________________________________________________________
  80.     | Compaction Instant Time| State    | Total FileIds to be Compacted|
  81.     |==================================================================|
  82.     | 20180924070031         | COMPLETED| 1                            |

Step 9: Run Hive Queries including incremental queries

You will see that both ReadOptimized and Realtime Views will show the latest committed data. Lets also run the incremental query for MOR table. From looking at the below query output, it will be clear that the fist commit time for the MOR table is 20180924064636 and the second commit time is 20180924070031

  1. docker exec -it adhoc-2 /bin/bash
  2. beeline -u jdbc:hive2://hiveserver:10000 --hiveconf hive.input.format=org.apache.hadoop.hive.ql.io.HiveInputFormat --hiveconf hive.stats.autogather=false
  4. # Read Optimized View
  5. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG';
  6. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  7. +---------+----------------------+--+
  8. | symbol  |         _c1          |
  9. +---------+----------------------+--+
  10. | GOOG    | 2018-08-31 10:59:00  |
  11. +---------+----------------------+--+
  12. 1 row selected (1.6 seconds)
  14. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG';
  15. +----------------------+---------+----------------------+---------+------------+-----------+--+
  16. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  17. +----------------------+---------+----------------------+---------+------------+-----------+--+
  18. | 20180924064636       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  19. | 20180924070031       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  20. +----------------------+---------+----------------------+---------+------------+-----------+--+
  22. # Realtime View
  23. 0: jdbc:hive2://hiveserver:10000> select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG';
  24. WARNING: Hive-on-MR is deprecated in Hive 2 and may not be available in the future versions. Consider using a different execution engine (i.e. spark, tez) or using Hive 1.X releases.
  25. +---------+----------------------+--+
  26. | symbol  |         _c1          |
  27. +---------+----------------------+--+
  28. | GOOG    | 2018-08-31 10:59:00  |
  29. +---------+----------------------+--+
  31. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG';
  32. +----------------------+---------+----------------------+---------+------------+-----------+--+
  33. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  34. +----------------------+---------+----------------------+---------+------------+-----------+--+
  35. | 20180924064636       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  36. | 20180924070031       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  37. +----------------------+---------+----------------------+---------+------------+-----------+--+
  39. # Incremental View:
  41. 0: jdbc:hive2://hiveserver:10000> set hoodie.stock_ticks_mor.consume.mode=INCREMENTAL;
  42. No rows affected (0.008 seconds)
  43. # Max-Commits covers both second batch and compaction commit
  44. 0: jdbc:hive2://hiveserver:10000> set hoodie.stock_ticks_mor.consume.max.commits=3;
  45. No rows affected (0.007 seconds)
  46. 0: jdbc:hive2://hiveserver:10000> set hoodie.stock_ticks_mor.consume.start.timestamp=20180924064636;
  47. No rows affected (0.013 seconds)
  48. # Query:
  49. 0: jdbc:hive2://hiveserver:10000> select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG' and `_hoodie_commit_time` > '20180924064636';
  50. +----------------------+---------+----------------------+---------+------------+-----------+--+
  51. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  52. +----------------------+---------+----------------------+---------+------------+-----------+--+
  53. | 20180924070031       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  54. +----------------------+---------+----------------------+---------+------------+-----------+--+
  55. exit
  56. exit
Read Optimized and Realtime Views for MOR with Spark-SQL after compaction
  1. docker exec -it adhoc-1 /bin/bash
  2. bash-4.4# $SPARK_INSTALL/bin/spark-shell --jars $HUDI_SPARK_BUNDLE --driver-class-path $HADOOP_CONF_DIR --conf spark.sql.hive.convertMetastoreParquet=false --deploy-mode client  --driver-memory 1G --master local[2] --executor-memory 3G --num-executors 1  --packages com.databricks:spark-avro_2.11:4.0.0
  4. # Read Optimized View
  5. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor group by symbol HAVING symbol = 'GOOG'").show(100, false)
  6. +---------+----------------------+--+
  7. | symbol  |         _c1          |
  8. +---------+----------------------+--+
  9. | GOOG    | 2018-08-31 10:59:00  |
  10. +---------+----------------------+--+
  11. 1 row selected (1.6 seconds)
  13. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor where  symbol = 'GOOG'").show(100, false)
  14. +----------------------+---------+----------------------+---------+------------+-----------+--+
  15. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  16. +----------------------+---------+----------------------+---------+------------+-----------+--+
  17. | 20180924064636       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  18. | 20180924070031       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  19. +----------------------+---------+----------------------+---------+------------+-----------+--+
  21. # Realtime View
  22. scala> spark.sql("select symbol, max(ts) from stock_ticks_mor_rt group by symbol HAVING symbol = 'GOOG'").show(100, false)
  23. +---------+----------------------+--+
  24. | symbol  |         _c1          |
  25. +---------+----------------------+--+
  26. | GOOG    | 2018-08-31 10:59:00  |
  27. +---------+----------------------+--+
  29. scala> spark.sql("select `_hoodie_commit_time`, symbol, ts, volume, open, close  from stock_ticks_mor_rt where  symbol = 'GOOG'").show(100, false)
  30. +----------------------+---------+----------------------+---------+------------+-----------+--+
  31. | _hoodie_commit_time  | symbol  |          ts          | volume  |    open    |   close   |
  32. +----------------------+---------+----------------------+---------+------------+-----------+--+
  33. | 20180924064636       | GOOG    | 2018-08-31 09:59:00  | 6330    | 1230.5     | 1230.02   |
  34. | 20180924070031       | GOOG    | 2018-08-31 10:59:00  | 9021    | 1227.1993  | 1227.215  |
  35. +----------------------+---------+----------------------+---------+------------+-----------+--+

This brings the demo to an end.

Testing Hudi in Local Docker environment

You can bring up a hadoop docker environment containing Hadoop, Hive and Spark services with support for hudi.

  1. $ mvn pre-integration-test -DskipTests

The above command builds docker images for all the services with current Hudi source installed at /var/hoodie/ws and also brings up the services using a compose file. We currently use Hadoop (v2.8.4), Hive (v2.3.3) and Spark (v2.3.1) in docker images.

To bring down the containers

  1. $ cd hudi-integ-test
  2. $ mvn docker-compose:down

If you want to bring up the docker containers, use

  1. $ cd hudi-integ-test
  2. $  mvn docker-compose:up -DdetachedMode=true

Hudi is a library that is operated in a broader data analytics/ingestion environment involving Hadoop, Hive and Spark. Interoperability with all these systems is a key objective for us. We are actively adding integration-tests under hudi-integ-test/src/test/java that makes use of this docker environment (See hudi-integ-test/src/test/java/org/apache/hudi/integ/ITTestHoodieSanity.java )

Building Local Docker Containers:

The docker images required for demo and running integration test are already in docker-hub. The docker images and compose scripts are carefully implemented so that they serve dual-purpose

  1. The docker images have inbuilt hudi jar files with environment variable pointing to those jars (HUDI_HADOOP_BUNDLE, …)
  2. For running integration-tests, we need the jars generated locally to be used for running services within docker. The docker-compose scripts (see docker/compose/docker-compose_hadoop284_hive233_spark231.yml) ensures local jars override inbuilt jars by mounting local HUDI workspace over the docker location

This helps avoid maintaining separate docker images and avoids the costly step of building HUDI docker images locally. But if users want to test hudi from locations with lower network bandwidth, they can still build local images run the script docker/build_local_docker_images.sh to build local docker images before running docker/setup_demo.sh

Here are the commands:

  1. cd docker
  2. ./build_local_docker_images.sh
  3. .....
  5. [INFO] Reactor Summary:
  6. [INFO]
  7. [INFO] hoodie ............................................. SUCCESS [  1.709 s]
  8. [INFO] hudi-common ...................................... SUCCESS [  9.015 s]
  9. [INFO] hudi-hadoop-mr ................................... SUCCESS [  1.108 s]
  10. [INFO] hudi-client ...................................... SUCCESS [  4.409 s]
  11. [INFO] hudi-hive ........................................ SUCCESS [  0.976 s]
  12. [INFO] hudi-spark ....................................... SUCCESS [ 26.522 s]
  13. [INFO] hudi-utilities ................................... SUCCESS [ 16.256 s]
  14. [INFO] hudi-cli ......................................... SUCCESS [ 11.341 s]
  15. [INFO] hudi-hadoop-mr-bundle ............................ SUCCESS [  1.893 s]
  16. [INFO] hudi-hive-bundle ................................. SUCCESS [ 14.099 s]
  17. [INFO] hudi-spark-bundle ................................ SUCCESS [ 58.252 s]
  18. [INFO] hudi-hadoop-docker ............................... SUCCESS [  0.612 s]
  19. [INFO] hudi-hadoop-base-docker .......................... SUCCESS [04:04 min]
  20. [INFO] hudi-hadoop-namenode-docker ...................... SUCCESS [  6.142 s]
  21. [INFO] hudi-hadoop-datanode-docker ...................... SUCCESS [  7.763 s]
  22. [INFO] hudi-hadoop-history-docker ....................... SUCCESS [  5.922 s]
  23. [INFO] hudi-hadoop-hive-docker .......................... SUCCESS [ 56.152 s]
  24. [INFO] hudi-hadoop-sparkbase-docker ..................... SUCCESS [01:18 min]
  25. [INFO] hudi-hadoop-sparkmaster-docker ................... SUCCESS [  2.964 s]
  26. [INFO] hudi-hadoop-sparkworker-docker ................... SUCCESS [  3.032 s]
  27. [INFO] hudi-hadoop-sparkadhoc-docker .................... SUCCESS [  2.764 s]
  28. [INFO] hudi-integ-test .................................. SUCCESS [  1.785 s]
  29. [INFO] ------------------------------------------------------------------------
  30. [INFO] BUILD SUCCESS
  31. [INFO] ------------------------------------------------------------------------
  32. [INFO] Total time: 09:15 min
  33. [INFO] Finished at: 2018-09-10T17:47:37-07:00
  34. [INFO] Final Memory: 236M/1848M
  35. [INFO] ------------------------------------------------------------------------