Repository: incubator-drill Updated Branches: refs/heads/master b094c4438 -> b7df73062
Update READMEs Project: http://git-wip-us.apache.org/repos/asf/incubator-drill/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-drill/commit/b7df7306 Tree: http://git-wip-us.apache.org/repos/asf/incubator-drill/tree/b7df7306 Diff: http://git-wip-us.apache.org/repos/asf/incubator-drill/diff/b7df7306 Branch: refs/heads/master Commit: b7df73062643be71d5e5a6885dbf7da162690ca8 Parents: b094c44 Author: Jacques Nadeau <jacques.dr...@gmail.com> Authored: Sun Aug 31 10:54:08 2014 -0700 Committer: Jacques Nadeau <jacq...@apache.org> Committed: Sun Aug 31 11:20:52 2014 -0700 ---------------------------------------------------------------------- README.md | 8 ++---- distribution/pom.xml | 1 + distribution/src/assemble/bin.xml | 4 +++ distribution/src/resources/README.md | 44 +++++++++++++++++++++++++++++++ 4 files changed, 51 insertions(+), 6 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 1e489e1..9bb9a68 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,7 @@ -# Apache Drill Milestone 1 - (Drill Alpha) +# Apache Drill Apache Drill is a distributed mpp query layer that supports SQL and alternative query languages against NoSQL and Hadoop data storage systems. It was inspired in part by the [Google's Dremel](http://research.google.com/pubs/pub36632.html). It is currently incubating under the Apache Foundation. - -## Milestone 1 -Milestone 1 is focused on providing a technology preview for developers. It offers the ability to query JSON and Parquet columnar data storage formats using ANSI compliant SQL. It also provides the ability to run queries in distributed execution mode utilizing Apache Zookeeper as a cluster coordination service. - ## Quickstart Please read INSTALL.md for setting up and running Apache Drill. @@ -23,4 +19,4 @@ Please see the [Apache Drill Website](http://incubator.apache.org/drill/) or the Apache Drill is an Apache Foundation project and is seeking all types of contributions. Please say hello on the Apache Drill mailing list or join our weekly Google Hangouts for more information. (More information can be found at the Apache Drill website). ## Disclaimer -Apache Drill is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. \ No newline at end of file +Apache Drill is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/pom.xml ---------------------------------------------------------------------- diff --git a/distribution/pom.xml b/distribution/pom.xml index a0abada..a8a28e0 100644 --- a/distribution/pom.xml +++ b/distribution/pom.xml @@ -112,6 +112,7 @@ <exclude>**/control</exclude> <exclude>**/*.checkstyle</exclude> <exclude>**/*.json</exclude> + <exclude>**/README.md</exclude> <exclude>**/hadoop-excludes.txt</exclude> </excludes> </configuration> http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/src/assemble/bin.xml ---------------------------------------------------------------------- diff --git a/distribution/src/assemble/bin.xml b/distribution/src/assemble/bin.xml index 1c07e2f..455f9bd 100644 --- a/distribution/src/assemble/bin.xml +++ b/distribution/src/assemble/bin.xml @@ -114,6 +114,10 @@ <outputDirectory/> </file> <file> + <source>src/resources/README.md</source> + <outputDirectory/> + </file> + <file> <source>../NOTICE</source> <outputDirectory/> </file> http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/src/resources/README.md ---------------------------------------------------------------------- diff --git a/distribution/src/resources/README.md b/distribution/src/resources/README.md new file mode 100644 index 0000000..f333b38 --- /dev/null +++ b/distribution/src/resources/README.md @@ -0,0 +1,44 @@ +# Running Apache Drill + +## Prerequisites + + * Linux, Windows or OSX + * Oracle JDK 7 (JDK, not JRE) + +Additional requirements when running in clustered mode: + * Hadoop 2.3+ distribution of Hadoop (such as Apache or MapR) + * Zookeeper is required for a clustered installation + +## Installing the Tarball + + 1. mkdir /opt/drill + 2. tar xvzf [tarball] --strip=1 -C /opt/drill + +## Running in embedded mode + + 1. cd /opt/drill + 2. bin/sqlline -u jdbc:drill:zk=local + 3. Run a query (below). + +## Running in clustered mode + + 1. Edit drill-override.conf to provide zookeeper location + 2. Start the drillbit using bin/drillbit.sh start + 3. Repeat on other nodes + 4. Connect with sqlline by using bin/sqlline -u "jdbc:drill:zk=[zk_host:port]" + 5. Run a query (below). + +## Run a query + +Drill comes preinstalled with a number of example data files including a small copy of the TPCH data in self describing Parquet files as well as the foodmart database in JSON. You can query these files using the cp schema. For example: + + USE cp; + + SELECT + employee_id, + first_name + FROM `employee.json`; + +## More information + +For more information including how to run a Apache Drill cluster, visit the [Apache Drill Wiki](https://cwiki.apache.org/confluence/display/DRILL/Apache+Drill+Wiki)
