openeuler/kyuubi repository overview

⁠Quick reference

• The official Kyuubi docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Kyuubi | openEuler

Current Kyuubi docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

Apache Kyuubi is a distributed and multi-tenant gateway to provide serverless SQL on data warehouses and lakehouses.

Learn more on Kyuubi website⁠.

⁠Supported tags and respective Dockerfile links

The tag of each kyuubi docker image is consist of the version of kyuubi and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/kyuubi image from docker

  docker pull openeuler/kyuubi:{Tag}
  

  Copy

• Run the container in the background

  If container runs successfully, it will store the PID of the server instance into pid/kyuubi--org.apache.kyuubi.server.KyuubiServer.pid. And you are able to get the JDBC connection URL from the log file - logs/kyuubi--org.apache.kyuubi.server.KyuubiServer-.out.

  docker run -d -p 10009:10009 --name kyuubi openeuler/kyuubi:{Tag}
  

  Copy

• Enter the container

  Enter the container and view the log file mentioned above.

  docker exec -it kyuubi bash
  

  Copy

  For example

  Starting and exposing JDBC connection at: jdbc:kyuubi://localhost:10009/
  

  Copy

• Open Connections

  Replace the host and port with the actual ones you’ve got in the step of server startup for the following JDBC URL. The case below open a session for user named apache.

  bin/kyuubi-beeline -u 'jdbc:kyuubi://localhost:10009/' -n apache
  

  Copy

• Execute Statements

  After successfully connected with the server, you can run sql queries in the kyuubi-beeline console. For instance,

  > SHOW DATABASES;
  

  Copy

  You will see a wall of operation logs, and a result table in the kyuubi-beeline console.

  omitted logs
  +------------+
  | namespace  |
  +------------+
  | default    |
  +------------+
  1 row selected (0.2 seconds)
  

  Copy

• Start Engines

  Engines are launched by the server automatically without end users’ attention. If you use the same user in the above case to create another connection, the engine will be reused. You may notice that the time cost for connection here is much shorter than the last round. If you use a different user to create a new connection, another engine will be started.

  bin/kyuubi-beeline -u 'jdbc:kyuubi://localhost:10009/' -n kentyao
  

  Copy

• Close Connections

  Close the session between kyuubi-beeline and Kyuubi server by executing !quit, for example,

  > !quit
  Closing: 0: jdbc:kyuubi://localhost:10009/
  

  Copy

• Stop Kyuubi

  Stop Kyuubi which running at the background by performing the following in the $KYUUBI_HOME directory:

  bin/kyuubi stop
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.