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 <[email protected]> Authored: Wed Mar 11 17:31:11 2015 -0700 Committer: Hyunsik Choi <[email protected]> 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. -
