vrajat commented on code in PR #13746:
URL: https://github.com/apache/pinot/pull/13746#discussion_r1745157640


##########
pinot-broker/src/main/java/org/apache/pinot/broker/api/resources/PinotClientRequest.java:
##########
@@ -236,6 +243,76 @@ public void processSqlWithMultiStageQueryEnginePost(String 
query, @Suspended Asy
     }
   }
 
+  @POST
+  @Produces(MediaType.APPLICATION_JSON)
+  @Path("query/compare")
+  @ApiOperation(value = "Query Pinot using both the single stage query engine 
and the multi stage query engine and "

Review Comment:
   I am using swagger APIs quite a bit today. Setting `sql` vs `v1Sql/v2Sql` 
maybe confusing. Majority of users will only use the doc in the swagger page to 
use the API. There are a couple of options to reduce confusion:
   * Only provide `v1Sql`/`v2Sql`. Its not that hard to copy paste twice.
   * Change the one-line documentation to add more info. There is precedence to 
multi-line description in swagger page. For example:
   
   > Query Pinot using both the single stage query engine and the multi stage 
query engine and compare the results. Set sql field to run the same query in 
both engines. Set v1Sql & v2Sql instead if query text is different. 
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscr...@pinot.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@pinot.apache.org
For additional commands, e-mail: commits-h...@pinot.apache.org

Reply via email to