[ 
https://issues.apache.org/jira/browse/DERBY-4587?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12896946#action_12896946
 ] 

Rick Hillegas commented on DERBY-4587:
--------------------------------------

Thanks for this excellent contribution to Derby, Nirmal. Here are a couple 
initial comments:

o The PlanExporter tool takes a connection URL argument as well as special 
username and password arguments. In contrast, our other tools only take a 
connection URL argument (see the api for dblook and SignatureChecker). For 
those tools, the username and password are part of the connection URL. 
Separating out the username and password arguments raises the awkward 
possibility that they may conflict with the corresponding attributes in the 
connection URL. In addition, for embedded databases which don't need 
authentication, it seems awkward to have to put dummy username/password 
arguments on the command line. In order to avoid these awkwardnesses and to 
promote a common api across our tools, I would rather see PlanExporter behave 
like dblook and SignatureChecker.

o It would be nice to be able to run the tool without having to specify a 
statement id. In this mode, I could imagine that plans would be produced for 
all tracked statements. Our other tools do not require the user to query the 
system tables before use and I think it would be good to reproduce that 
friendly experience.

o The xml output contains a header comment, giving credit to the author. In 
general, Derby follows the Apache way by not singling out individuals for 
special credit either in the code or in production artifacts. People who want 
to understand the contribution history of a component should be able to recover 
that information from JIRA. The header comment should be removed.


> Add tools for improved analysis and understanding of query plans and 
> execution statistics
> -----------------------------------------------------------------------------------------
>
>                 Key: DERBY-4587
>                 URL: https://issues.apache.org/jira/browse/DERBY-4587
>             Project: Derby
>          Issue Type: Improvement
>          Components: SQL, Tools
>            Reporter: Bryan Pendleton
>            Assignee: C.S. Nirmal J. Fernando
>         Attachments: AdavancedXSL-mouseover.jpg, advancedViewXSL.xsl, 
> advancedViewXSL.xsl, advancedViewXSL2.xsl, advancedXSL-1.jpg, 
> advancedXSL-2.jpg, advancedXSL-3.jpg, basic_html-2.2.jpg, basic_html-2.3.jpg, 
> basic_html-2.jpg, basic_html-3.jpg, basic_html-4.1.jpg, basic_html-4.2.jpg, 
> Derby Query Plan Screen Shot 2.jpg, DERBY-4587-javadoc_fix.diff, 
> DERBY-4587-tool-2.diff, DERBY-4587-tool-3.diff, DERBY-4587-tool-4.diff, 
> DERBY-4587-tool-5.diff, DERBY-4587-tool-6.diff, DERBY-4587-tool-7-b.diff, 
> DERBY-4587-tool-7.diff, DERBY-4587-tool-8.diff, DERBY-4587-tool-9.1.diff, 
> DERBY-4587-tool-9.2.diff, DERBY-4587-tool-9.3.diff, DERBY-4587-tool-9.4.diff, 
> DERBY-4587-tool-9.5.diff, DERBY-4587-tool-9.6.diff, DERBY-4587-tool-9.7.diff, 
> DERBY-4587-tool-9.7.diff, DERBY-4587-tool-9.diff, DERBY-4587-tool-test1.diff, 
> DERBY-4587-tool-test2.diff, DERBY-4587-tool.diff, derby-logo.png, 
> Derby_Query_Plan_Screen_Shot.jpg, PostgreSQL license.jpg, Read_Me.txt, 
> screenshot-1.jpg, screenshot-2.jpg, screenshot-3.jpg, Simple HTML View (Pure 
> XSL).jpg, Source.rar, test.xml, test4.xsl, vanilla_html.xsl, 
> vanilla_html.xsl, vanilla_html.xsl, vanilla_html.xsl, vanilla_html.xsl, 
> xml_doc_screenshot.jpg, xml_doc_screenshot.jpg
>
>
> I think it would be great to see some work in the area of tools for helping
> with the analysis of complex query execution. Quite frequently, users of
> Derby have trouble comprehending (a) how their query is being translated
> into a query plan by the optimizer, and (b) what the execution-time resource
> usage of the various parts of the query is.
> There are low-level features in Derby which capture this information and
> record it, such as logQueryPlan, and the XPLAIN tables, but there is a lot
> of opportunity for designing higher-level tools which can process the query
> plan and execution statistics information and present it in a more
> comprehensible fashion. 

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to