pan3793 commented on code in PR #3041: URL: https://github.com/apache/incubator-kyuubi/pull/3041#discussion_r917676401
########## docs/client/jdbc/kyuubi_jdbc.rst: ########## @@ -0,0 +1,160 @@ +.. Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +Kyuubi Hive JDBC Driver +======================= + +.. versionadded:: 1.4.0 + Since 1.4.0, kyuubi community maintains a forked hive jdbc driver module and provides both shaded and non-shaded packages. + +This packages aims to support some missing functionalities of the original hive jdbc. +For kyuubi engines that support multiple catalogs, it provides meta APIs for better support. +The behaviors of the original hive jdbc have remained. + +To access a Hive data warehouse or new lakehouse formats, such as Apache Iceberg/Hudi, delta lake using the kyuubi jdbc driver for Apache kyuubi, you need to configure +the following: + +- The list of driver library files - :ref:`referencing-libraries`. +- The Driver or DataSource class - :ref:`registering_class`. +- The connection URL for the driver - :ref:`building_url` + +.. _referencing-libraries: + +Referencing the JDBC Driver Libraries +------------------------------------- + +Before you use the jdbc driver for Apache Kyuubi, the JDBC application or Java code that +you are using to connect to your data must be able to access the driver JAR files. + +Using the Driver in Java Code +***************************** + +In the code, specify the artifact `kyuubi-hive-jdbc-shaded` from `Maven Central`_ according to the build tool you use. + +Maven +^^^^^ + +.. code-block:: xml + + <dependency> + <groupId>org.apache.kyuubi</groupId> + <artifactId>kyuubi-hive-jdbc-shaded</artifactId> + <version>1.5.2-incubating</version> + </dependency> + +Sbt +^^^ + +.. code-block:: sbt + + libraryDependencies += "org.apache.kyuubi" % "kyuubi-hive-jdbc-shaded" % "1.5.0-incubating" Review Comment: 1.5.2 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
