+1 for Jason. He has mentioned everything you need for playing with and debugging Drill.
Just to add - Join the Drill hangout to discuss areas where you are stuck or you would like to start. We are planning one this Tuesday 10AM PDT. Keep an eye on the dev list. On Thu, Jan 15, 2015 at 6:42 AM, Jason Altekruse <[email protected]> wrote: > Hello Ankur! > > I'm sorry for your trouble getting started with Drill. I did not realize > how out of date that wiki page was. The reference interpreter was a proof > of concept execution engine that was developed early on in Drill to > validate some design decisions before beginning the actual project. While > we did maintain it for a little while alongside the full implementation of > the execution engine, it has be deprecated for some time now. If you want > to try to run some test queries on Drill I would recommend starting > sqlline, which is a bundled sql shell that leverages Drills JDBC driver. > The guide below show how to do it with a pre-built binary. > > > https://cwiki.apache.org/confluence/display/DRILL/Apache+Drill+in+10+Minutes > > You can also run sqlline after a build of Drill. To build, run "mvn clean > install -DskipTests" from the root of the project. The finished build will > be in: distribution/target/ > > You are correct that java-exec is where the development has been happening > by and large. There are few pluggable components defined in the other > modules, as well as a few system interface and logical constructs (such as > our expression parser/AST) in the common submodule. > > For debugging during development we mostly write unit tests that submit sql > queries to test different components of the engine. The testing > infrastructure is available from any class that inherits from > BestTestQuery. Here is one example: > > > https://github.com/apache/drill/blob/35a350fd381d839b3a51587092779fd822a19734/exec/java-exec/src/test/java/org/apache/drill/TestExampleQueries.java > > We recently added a unified system for creating tests that run queries and > verify the full result set against a baseline. This has previously be > re-created in a number of the test classes in various forms, so we now have > one unified framework to give a single interface to these tests. This class > contains some example of the usage of the new framework. > > > https://github.com/apache/drill/blob/df56954771950cd850ecae10404007d11d9241cb/exec/java-exec/src/test/java/org/apache/drill/TestFrameworkTest.java > > -Jason > > > > On Wed, Jan 14, 2015 at 10:53 AM, Ankur Garg <[email protected]> wrote: > > > Hi All , > > > > I joined the Apache Drill community recently and want to contribute to > > Drill as a developer . > > > > As a first step, I am setting up my dev environment . I see that > > > > > https://cwiki.apache.org/confluence/display/DRILL/Setting+Up+Your+Development+Environment > > > > says that the page is Outdated and needs to be updated . > > > > Specifically , I couldn't get this( *I cant locate ReferenceInterpreter > > project in the workspace . Although I could see a donuts.json file > > under exec/java-exec . Is the ReferenceInterpreter renamed to > > exec/java-exec ?? *) : > > > > Additionally , is there somewhere i can find the latest update info for > > setting up my dev environment . I will then update this page with those > so > > that new contributors do not face any hassle :) > > *Executing the ReferenceInterpreter from ref project:* > > > > *Copy "ref\src\ test\resources\donuts.json" to > > "ref\src\ main\resources\donuts.json"* > > > > *First time:* > > > > *Right click on "ReferenceInterpreter", select 'Run As -> Run > > Configurations'.* > > > > *Select Java Application and New.* > > > > *In Main tab:* > > > > *Project: ref* > > > > *Main class: org.apache.drill.exec.ref.ReferenceInterpreter* > > > > *In Arguments tab:* > > > > *Program arguments: "src/test/resources/simple_plan.json" (with quotes).* > > > > *Click 'Run'.* > > > > *Next time onwards:* > > > > *Right click on "ReferenceInterpreter", select 'Run As -> Java > > Application'.* > > > > > > Looking for help . > > > > > > Regards > > > > Ankur > > >
