From 73fc9de54689f150265522b06e66e61737ae1c3b Mon Sep 17 00:00:00 2001 From: Abhishek Balaji Radhakrishnan Date: Wed, 12 Apr 2023 15:07:02 -0700 Subject: [PATCH] Javadoc --- .../apache/druid/sql/calcite/planner/QueryHandler.java | 3 +++ .../druid/sql/calcite/planner/SqlStatementHandler.java | 10 ++++++++++ 2 files changed, 13 insertions(+) diff --git a/sql/src/main/java/org/apache/druid/sql/calcite/planner/QueryHandler.java b/sql/src/main/java/org/apache/druid/sql/calcite/planner/QueryHandler.java index 7e2889c0b3a8..2e44a3772691 100644 --- a/sql/src/main/java/org/apache/druid/sql/calcite/planner/QueryHandler.java +++ b/sql/src/main/java/org/apache/druid/sql/calcite/planner/QueryHandler.java @@ -234,6 +234,9 @@ public String statementKind() return "SELECT"; } + /** + * No target datasource for SELECT/non-DML statements. + */ @Nullable @Override public SqlNode targetDataSource() diff --git a/sql/src/main/java/org/apache/druid/sql/calcite/planner/SqlStatementHandler.java b/sql/src/main/java/org/apache/druid/sql/calcite/planner/SqlStatementHandler.java index d9bfcf8dcd6c..fdc00cec85ca 100644 --- a/sql/src/main/java/org/apache/druid/sql/calcite/planner/SqlStatementHandler.java +++ b/sql/src/main/java/org/apache/druid/sql/calcite/planner/SqlStatementHandler.java @@ -43,7 +43,17 @@ public interface SqlStatementHandler void prepare(); PrepareResult prepareResult(); PlannerResult plan() throws ValidationException; + + /** + * @return the statement kind for a SQL statement. For example, SELECT, INSERT, or REPLACE. + */ String statementKind(); + + /** + * + * @return the SQL node representing the target table in a SQL statement. Returns + * null for SELECT/non-DML statements. + */ @Nullable SqlNode targetDataSource(); /**