feat:add sql debug feature

docs/interpreter/jdbc.md

@@ -426,6 +426,63 @@ select @v
 ```
 Returns value of `v` which is set in the mysql interpreter's *default.precode*.
 
+## Sql Debug
+As we know,we develop in java and c, if the actual result is not same to our's expect result, we can add breakPoint and debug it find the reason or add log find the reason also.The feature of sql debug is also let you debug your sql to find it.
+
+for example
+
+```sql
+%jdbc_interpreter_name
+select * from (
+                  select name,`age` from test_db.user_info_01
+                  union ALL
+                  select name,`age` from test_db.user_info_02
+                  union ALL
+                  select name,`age` from test_db.user_info_03
+)t group by name,`age`
+```
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/query_table_result.png" />
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/new_ui_query_table_result.png" />
+
+but the data of 'xiaohe' should not in it,if we want find which table create the data of 'xiaohe',most of us run three times by manually,because it has three tables.
+
+```sql
+%jdbc_interpreter_name
+select name,`age` from test_db.user_info_01 where name='xiaohe'
+```
+
+```sql
+%jdbc_interpreter_name
+select name,`age` from test_db.user_info_02 where name='xiaohe'
+```
+
+```sql
+%jdbc_interpreter_name
+select name,`age` from test_db.user_info_03 where name='xiaohe'
+```
+
+if the sql is more complex,the action must more complexed.if there is a solution to quickly find this problem?let we introduce the feature of sql debug
+
+firstly,add your sql and click the button of debug paragraph,just like this
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/debug_paragraph.png" />
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/new_ui_debug_paragraph.png" />
+
+then it will return result like this
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/debug_result.png" />
+
+<img src="{{BASE_PATH}}/assets/themes/zeppelin/img/docs-img/new_ui_debug_result.png" />
+
+then we can query the table of created to find the reason
+
+```sql
+%jdbc_interpreter_name
+select * from test_zeppelin.tmp_zeppelin_paragraph_1683297437359_1950110405_1 where name='xiaohe'
+```
 
 ## Examples
 Here are some examples you can refer to. Including the below connectors, you can connect every databases as long as it can be configured with it's JDBC driver.

zeppelin-common/src/main/java/org/apache/zeppelin/common/Message.java

@@ -82,6 +82,8 @@ public enum OP {
 
     FOLDER_RENAME,
 
+    DEBUG_PARAGRAPH,
+
     RUN_PARAGRAPH,    // [c-s] run paragraph
                       // @param id paragraph id
                       // @param paragraph paragraph content.ie. script

zeppelin-distribution/src/bin_license/LICENSE

@@ -226,6 +226,7 @@ The following components are provided under Apache License.
     (Apache 2.0) Dropwizard Jackson Integration for Metrics (io.dropwizard.metrics:metrics-json:4.1.14) - https://github.com/dropwizard/metrics/blob/release/4.1.x/LICENSE
     (Apache 2.0) Dropwizard Metrics Health Checks (io.dropwizard.metrics:metrics-healthchecks:4.1.14) - https://github.com/dropwizard/metrics/blob/release/4.1.x/LICENSE
     (Apache 2.0) Dropwizard Metrics Integration with JMX (io.dropwizard.metrics:metrics-jmx:4.1.14) - https://github.com/dropwizard/metrics/blob/release/4.1.x/LICENSE
+    (Apache 2.0) antlr4-runtime (org.antlr:antlr4-runtime:4.7.2 - https://github.com/antlr/antlr4)
 
 ========================================================================
 MIT licenses

zeppelin-interpreter/pom.xml

@@ -41,6 +41,7 @@
     <sisu.plexus.version>0.3.4</sisu.plexus.version>
     <jline.version>2.14.3</jline.version>
     <atomix.version>3.0.0-rc4</atomix.version>
+    <antlr4.version>4.7.2</antlr4.version>
   </properties>
 
   <dependencies>
@@ -218,6 +219,12 @@
       <artifactId>mockito-core</artifactId>
       <scope>test</scope>
     </dependency>
+
+    <dependency>
+      <groupId>org.antlr</groupId>
+      <artifactId>antlr4-runtime</artifactId>
+      <version>${antlr4.version}</version>
+    </dependency>
   </dependencies>
 
   <build>
@@ -242,6 +249,22 @@
           <dateFormat>yyyy-MM-dd HH:mm:ss</dateFormat>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>org.antlr</groupId>
+        <artifactId>antlr4-maven-plugin</artifactId>
+        <version>${antlr4.version}</version>
+        <configuration>
+          <visitor>true</visitor>
+        </configuration>
+        <executions>
+          <execution>
+            <id>antlr</id>
+            <goals>
+              <goal>antlr4</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
 
     <resources>