You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tajo.apache.org by hy...@apache.org on 2015/03/12 02:07:17 UTC
tajo git commit: TAJO-1380: Update JDBC documentation for new JDBC
driver. (Contributed by Dongjoon Hyun, Committed by hyunsik)
Repository: tajo
Updated Branches:
refs/heads/master 513a8c308 -> 607fdea45
TAJO-1380: Update JDBC documentation for new JDBC driver. (Contributed by Dongjoon Hyun, Committed by hyunsik)
Closes #405
Project: http://git-wip-us.apache.org/repos/asf/tajo/repo
Commit: http://git-wip-us.apache.org/repos/asf/tajo/commit/607fdea4
Tree: http://git-wip-us.apache.org/repos/asf/tajo/tree/607fdea4
Diff: http://git-wip-us.apache.org/repos/asf/tajo/diff/607fdea4
Branch: refs/heads/master
Commit: 607fdea458a0763325727b99ee2a0687b29b5160
Parents: 513a8c3
Author: Hyunsik Choi <hy...@apache.org>
Authored: Wed Mar 11 17:31:11 2015 -0700
Committer: Hyunsik Choi <hy...@apache.org>
Committed: Wed Mar 11 18:07:10 2015 -0700
----------------------------------------------------------------------
CHANGES | 3 +++
tajo-docs/src/main/sphinx/jdbc_driver.rst | 34 +++++++-------------------
2 files changed, 12 insertions(+), 25 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/tajo/blob/607fdea4/CHANGES
----------------------------------------------------------------------
diff --git a/CHANGES b/CHANGES
index 68aabf5..f330a0a 100644
--- a/CHANGES
+++ b/CHANGES
@@ -43,6 +43,9 @@ Release 0.11.0 - unreleased
TASKS
+ TAJO-1380: Update JDBC documentation for new JDBC driver.
+ (Contributed by Dongjoon Hyun, Committed by hyunsik)
+
TAJO-1335: Bump up 0.10.0-SNAPSHOT to 0.11.0-SNAPSHOT in master branch.
(hyunsik)
http://git-wip-us.apache.org/repos/asf/tajo/blob/607fdea4/tajo-docs/src/main/sphinx/jdbc_driver.rst
----------------------------------------------------------------------
diff --git a/tajo-docs/src/main/sphinx/jdbc_driver.rst b/tajo-docs/src/main/sphinx/jdbc_driver.rst
index a2a9a23..6c7371b 100644
--- a/tajo-docs/src/main/sphinx/jdbc_driver.rst
+++ b/tajo-docs/src/main/sphinx/jdbc_driver.rst
@@ -9,11 +9,15 @@ In this section, we explain how to get JDBC driver and an example code.
How to get JDBC driver
=======================
+Direct Download
+--------------------------------
+
+You can directly download a JDBC driver jar file (``tajo-jdbc-x.y.z.jar``) from `Downloads <http://tajo.apache.org/downloads.html>`_.
+
From Binary Distribution
--------------------------------
-Tajo binary distribution provides JDBC jar file and its dependent JAR files.
-Those files are located in ``${TAJO_HOME}/share/jdbc-dist/``.
+Tajo binary distribution provides JDBC jar file located in ``${TAJO_HOME}/share/jdbc-dist/tajo-jdbc-x.y.z.jar``.
From Building Source Code
@@ -25,25 +29,17 @@ You can build Tajo from the source code and then get JAR files as follows:
$ tar xzvf tajo-x.y.z-src.tar.gz
$ mvn clean package -DskipTests -Pdist -Dtar
- $ ls -l tajo-dist/target/tajo-x.y.z/share/jdbc-dist
+ $ ls -l tajo-dist/target/tajo-x.y.z/share/jdbc-dist/tajo-jdbc-x.y.z.jar
Setting the CLASSPATH
=======================
-In order to use the JDBC driver, you should set the jar files included in
-``tajo-dist/target/tajo-x.y.z/share/jdbc-dist`` to your ``CLASSPATH``.
-In addition, you should add hadoop clsspath into your ``CLASSPATH``.
-So, ``CLASSPATH`` will be set as follows:
+In order to use the JDBC driver, you should add ``tajo-jdbc-x.y.z.jar`` in your ``CLASSPATH``.
.. code-block:: bash
- CLASSPATH=path/to/tajo-jdbc/*:path/to/tajo-site.xml:path/to/core-site.xml:path/to/hdfs-site.xml
-
-.. note::
-
- You must add the locations which include Tajo config files (i.e., ``tajo-site.xml``) and
- Hadoop config files (i.e., ``core-site.xml`` and ``hdfs-site.xml``) to your ``CLASSPATH``.
+ CLASSPATH=path/to/tajo-jdbc-x.y.z.jar:$CLASSPATH
An Example JDBC Client
@@ -99,15 +95,3 @@ The following shows an example of JDBC Client.
}
}
-
-FAQ
-===========================================
-
-java.nio.channels.UnresolvedAddressException
---------------------------------------------
-
-When retriving the final result, Tajo JDBC Driver tries to access HDFS data nodes.
-So, the network access between JDBC client and HDFS data nodes must be available.
-In many cases, a HDFS cluster is built in a private network which use private hostnames.
-So, the host names must be shared with the JDBC client side.
-