Flink SQL hopping windows tutorial (#1630)

* feat: add Flink SQL hopping windows tutorial

* chore: wording tweaks and typos fixes

These are largely copy/paste issues noticed during hopping windows tutorial dev.

* add note about readings affecting multiple hopping windows

Author: davetroiano

.semaphore/semaphore.yml

@@ -502,6 +502,9 @@ blocks:
     - name: Flink SQL tumbling windows tests
       commands:
       - make -C _includes/tutorials/tumbling-windows/flinksql/code tutorial
+    - name: Flink SQL hopping windows tests
+      commands:
+      - make -C _includes/tutorials/hopping-windows/flinksql/code tutorial
     - name: Flink SQL test for deduplication
       commands:
       - make -C _includes/tutorials/finding-distinct/flinksql/code tutorial

_data/harnesses/aggregating-count/flinksql.yml

@@ -13,7 +13,7 @@ dev:
           render:
             file: tutorials/aggregating-count/flinksql/markup/dev/init.adoc
 
-    - title: Get Confluent Platform
+    - title: Get Confluent Platform and Apache Flink®
       content:
         - action: make_file
           file: docker-compose.yml

_data/harnesses/aggregating-minmax/flinksql.yml

@@ -13,7 +13,7 @@ dev:
           render:
             file: tutorials/aggregating-minmax/flinksql/markup/dev/init.adoc
 
-    - title: Get Confluent Platform
+    - title: Get Confluent Platform and Apache Flink®
       content:
         - action: make_file
           file: docker-compose.yml

_data/harnesses/filtering/flinksql.yml

@@ -13,7 +13,7 @@ dev:
           render:
             file: tutorials/filtering/flinksql/markup/dev/init.adoc
 
-    - title: Get Confluent Platform
+    - title: Get Confluent Platform and Apache Flink®
       content:
         - action: make_file
           file: docker-compose.yml

_data/harnesses/finding-distinct/flinksql.yml

@@ -13,7 +13,7 @@ dev:
       render:
         file: tutorials/finding-distinct/flinksql/markup/dev/init.adoc
 
-  - title: Get Confluent Platform
+  - title: Get Confluent Platform and Apache Flink®
     content:
     - action: make_file
       file: docker-compose.yml

_data/harnesses/hopping-windows/flinksql.yml

@@ -0,0 +1,152 @@
+dev:
+  steps:
+    - title: Prerequisites
+      content:
+        - action: skip
+          render:
+            file: shared/markup/dev/docker-prerequisite.adoc
+
+    - title: Initialize the project
+      content:
+        - action: execute
+          file: tutorial-steps/dev/init.sh
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/dev/init.adoc
+
+    - title: Get Confluent Platform and Apache Flink®
+      content:
+        - action: make_file
+          file: docker-compose.yml
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/dev/make-docker-compose.adoc
+
+        - action: execute_async
+          file: tutorial-steps/dev/docker-compose-up.sh
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/dev/start-compose.adoc
+
+        - action: execute
+          file: tutorial-steps/dev/wait-for-containers.sh
+          render:
+            skip: true
+
+    - title: Write the program interactively using the CLI
+      content:
+        - action: docker_flinksql_cli_session
+          container: flink-sql-client
+          docker_bootup_file: tutorial-steps/dev/start-cli.sh
+          column_width: 20
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/dev/start-cli.adoc
+          stdin:
+            - file: tutorial-steps/dev/create-temperature-readings.sql
+              render:
+                file: tutorials/hopping-windows/flinksql/markup/dev/create-temperature-readings.adoc
+
+            - file: tutorial-steps/dev/populate-temperature-readings.sql
+              render:
+                file: tutorials/hopping-windows/flinksql/markup/dev/populate-temperature-readings.adoc
+
+            - file: tutorial-steps/dev/transient-query-temperature-by-10min-window.sql
+              render:
+                file: tutorials/hopping-windows/flinksql/markup/dev/transient-query-temperature-by-10min-window.adoc
+
+            - file: tutorial-steps/dev/create-temperature-by-10min-window.sql
+              render:
+                file: tutorials/hopping-windows/flinksql/markup/dev/create-temperature-by-10min-window.adoc
+
+          stdout:
+            directory: tutorial-steps/dev/outputs
+
+        - name: wait for table execution to complete
+          action: sleep
+          ms: 10000
+          render:
+             skip: true
+
+    - title: Validate output
+      content:
+        - action: execute
+          file: tutorial-steps/dev/validate-temperature-by-10min-window.sh
+          stdout: tutorial-steps/dev/outputs/validate-temperature-by-10min-window.log
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/dev/validate-temperature-by-10min-window.adoc
+
+test:
+  steps:
+    - title: Decide what testing tools to use
+      content:
+        - action: skip
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/test-architecture.adoc
+
+    - title: Create the test skeleton
+      content:
+        - action: execute
+          file: tutorial-steps/test/make-test-dirs.sh
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/make-test-dirs.adoc
+
+        - action: make_file
+          file: build.gradle
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/make-build-gradle.adoc
+
+        - action: execute
+          file: tutorial-steps/test/gradle-wrapper.sh
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/make-gradle-wrapper.adoc
+
+    - title: Create SQL resources
+      content:
+        - action: make_file
+          file: src/test/resources/create-temperature-readings.sql.template
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/create-resource-create-temperature-readings.sql.template.adoc
+
+        - action: make_file
+          file: src/test/resources/populate-temperature-readings.sql
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/create-resource-populate-temperature-readings.sql.adoc
+
+        - action: make_file
+          file: src/test/resources/create-temperature-by-10min-window.sql.template
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/create-resource-create-temperature-by-10min-window.sql.template.adoc
+
+        - action: make_file
+          file: src/test/resources/query-temperature-by-10min-window.sql
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/create-resource-query-temperature-by-10min-window.sql.adoc
+
+        - action: make_file
+          file: src/test/resources/expected-temperature-by-10min-window.txt
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/create-resource-expected-temperature-by-10min-window.txt.adoc
+
+    - title: Write a test
+      content:
+        - action: make_file
+          file: src/test/java/io/confluent/developer/AbstractFlinkKafkaTest.java
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/make-test-base.adoc
+
+        - action: make_file
+          file: src/test/java/io/confluent/developer/FlinkSqlHoppingWindowTest.java
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/make-test.adoc
+
+    - title: Invoke the test
+      content:
+        - action: execute
+          file: tutorial-steps/test/invoke-test.sh
+          render:
+            file: tutorials/hopping-windows/flinksql/markup/test/invoke-test.adoc
+
+ccloud:
+  steps:
+    - title: Run your app with Confluent Cloud
+      content:
+        - action: skip
+          render:
+            file: shared/markup/ccloud/try-ccloud.adoc

_data/harnesses/joining-stream-stream/flinksql.yml

@@ -13,7 +13,7 @@ dev:
       render:
         file: tutorials/joining-stream-stream/flinksql/markup/dev/init.adoc
 
-  - title: Get Confluent Platform
+  - title: Get Confluent Platform and Apache Flink®
     content:
     - action: make_file
       file: docker-compose.yml

_data/harnesses/splitting/flinksql.yml

@@ -13,7 +13,7 @@ dev:
           render:
             file: tutorials/splitting/flinksql/markup/dev/init.adoc
 
-    - title: Get Confluent Platform
+    - title: Get Confluent Platform and Apache Flink®
       content:
         - action: make_file
           file: docker-compose.yml

_data/harnesses/tumbling-windows/flinksql.yml

@@ -13,7 +13,7 @@ dev:
           render:
             file: tutorials/tumbling-windows/flinksql/markup/dev/init.adoc
 
-    - title: Get Confluent Platform
+    - title: Get Confluent Platform and Apache Flink®
       content:
         - action: make_file
           file: docker-compose.yml

_data/tutorials.yaml

@@ -174,11 +174,12 @@ hopping-windows:
     into fixed-size, possibly overlapping, contiguous time intervals to identify a
     specific scenario?
   introduction: You want to build an alerting system that automatically detects if
-    the temperature of a room consistently drops. In this tutorial, we'll write a
+    the temperature of a room drops below a threshold over a period of time. In this tutorial, we'll write a
     program that monitors a stream of temperature readings and detects when the temperature
-    consistently drops below 45 degrees Fahrenheit for a period of 10 minutes.
+    drops below 45 degrees Fahrenheit for a period of 10 minutes.
   status:
     ksql: enabled
+    flinksql: enabled
 session-windows:
   title: Create session windows
   meta-description: create session windows for time-series events