You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@calcite.apache.org by fr...@apache.org on 2018/04/27 07:10:16 UTC
svn commit: r1830299 [3/4] - in /calcite/site/avatica: ./ assets/
assets/css/ develop/ docs/ downloads/ news/2018/04/ news/2018/04/26/
news/2018/04/26/release-avatica-go-3.0.0/ news/avatica-go-releases/
news/avatica-releases/
Added: calcite/site/avatica/develop/avatica-go.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/develop/avatica-go.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/develop/avatica-go.html (added)
+++ calcite/site/avatica/develop/avatica-go.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,286 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Developing the Avatica Go Client</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="standalone">
+ <div class="grid">
+
+ <div class="unit whole">
+ <article>
+ <h1>Developing the Avatica Go Client</h1>
+ <!--
+
+-->
+
+<ul id="markdown-toc">
+ <li><a href="#issues" id="markdown-toc-issues">Issues</a></li>
+ <li><a href="#updating-protobuf-definitions" id="markdown-toc-updating-protobuf-definitions">Updating protobuf definitions</a></li>
+ <li><a href="#testing" id="markdown-toc-testing">Testing</a> <ul>
+ <li><a href="#easy-way" id="markdown-toc-easy-way">Easy way</a></li>
+ <li><a href="#manual-set-up" id="markdown-toc-manual-set-up">Manual set up</a></li>
+ </ul>
+ </li>
+ <li><a href="#releasing" id="markdown-toc-releasing">Releasing</a></li>
+ <li><a href="#important-things-to-note-before-uploading-a-release" id="markdown-toc-important-things-to-note-before-uploading-a-release">Important things to note before uploading a release</a></li>
+ <li><a href="#uploading-release-artifacts-to-dev-for-voting" id="markdown-toc-uploading-release-artifacts-to-dev-for-voting">Uploading release artifacts to dev for voting</a></li>
+ <li><a href="#promoting-a-release-after-voting" id="markdown-toc-promoting-a-release-after-voting">Promoting a release after voting</a></li>
+</ul>
+
+<h2 id="issues">Issues</h2>
+
+<p>To file issues, please use the <a href="https://issues.apache.org/jira/projects/CALCITE/issues">Calcite JIRA</a> and select <code class="highlighter-rouge">avatica-go</code>
+as the component.</p>
+
+<h2 id="updating-protobuf-definitions">Updating protobuf definitions</h2>
+
+<p>To update the procotol buffer definitions, update <code class="highlighter-rouge">AVATICA_VER</code> in <code class="highlighter-rouge">gen-protobuf.bat</code> and <code class="highlighter-rouge">gen-protobuf.sh</code> to match
+the version you want to generate protobufs for and then run the appropriate script for your platform.</p>
+
+<h2 id="testing">Testing</h2>
+
+<p>The test suite takes around 4 minutes to run if you run both the Avatica HSQLDB and Apache Phoenix tests.</p>
+
+<h3 id="easy-way">Easy way</h3>
+<ol>
+ <li>
+ <p>Install <a href="https://docs.docker.com/install/">docker</a> and <a href="https://docs.docker.com/compose/install/">docker-compose</a>.</p>
+ </li>
+ <li>
+ <p>From the root of the repository, run <code class="highlighter-rouge">docker-compose up --build</code>.</p>
+ </li>
+</ol>
+
+<h3 id="manual-set-up">Manual set up</h3>
+<ol>
+ <li>
+ <p>Install <a href="https://golang.org/doc/install">Go</a>.</p>
+ </li>
+ <li>
+ <p>Install <a href="https://github.com/golang/dep">dep</a>: <code class="highlighter-rouge">go get -u github.com/golang/dep/cmd/dep</code></p>
+ </li>
+ <li>
+ <p>Install dependencies by running <code class="highlighter-rouge">dep ensure -v</code> from the root of the repository.</p>
+ </li>
+ <li>
+ <p>The test suite requires access to an instance of Avatica running HSQLDB and an instance of Apache Phoenix running the
+Phoenix Query Server.</p>
+ </li>
+</ol>
+
+<p>You should then set the <code class="highlighter-rouge">HSQLDB_HOST</code> and <code class="highlighter-rouge">PHOENIX_HOST</code> environment variables. For example:</p>
+
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell">HSQLDB_HOST: http://hsqldb:8765
+PHOENIX_HOST: http://phoenix:8765</code></pre></figure>
+
+<ol>
+ <li>
+ <p>To select the test suite, export <code class="highlighter-rouge">AVATICA_FLAVOR=HSQLDB</code> for Avatica HSQLDB or <code class="highlighter-rouge">AVATICA_FLAVOR=PHOENIX</code> for Phoenix.</p>
+ </li>
+ <li>
+ <p>Then run <code class="highlighter-rouge">go test -v ./...</code> from the root of the repository to execute the test suite.</p>
+ </li>
+</ol>
+
+<h2 id="releasing">Releasing</h2>
+<p>If you have not set up a GPG signing key, set one up by following these <a href="https://www.apache.org/dev/openpgp.html#generate-key">instructions</a>.</p>
+
+<p>From the root of the repository, run <code class="highlighter-rouge">./make-release-artifacts.sh</code>.</p>
+
+<p>You will be asked to select the tag to build release artifacts for. The latest tag is automatically selected if no tag is selected.</p>
+
+<p>The release artifacts will be placed in a folder named for the release within the <code class="highlighter-rouge">dist/</code> folder.</p>
+
+<h2 id="important-things-to-note-before-uploading-a-release">Important things to note before uploading a release</h2>
+<p>The name of the release folder must be in the following format: <code class="highlighter-rouge">apache-calcite-avatica-go-$version</code>. The version must
+include release candidate identifiers such as <code class="highlighter-rouge">-rc0</code>, if they are present.</p>
+
+<p>The files inside the release folder must have any release candidate identifiers such as <code class="highlighter-rouge">-rc1</code> removed, even if the
+release is a release candidate. <code class="highlighter-rouge">src</code> must also be added to the filename.</p>
+
+<p>For example, if we are uploading the <code class="highlighter-rouge">apache-calcite-avatica-go-3.0.0-rc1</code> folder, the files must be named
+<code class="highlighter-rouge">apache-calcite-acatica-go-src-3.0.0.tar.gz</code>. Note the inclusion of <code class="highlighter-rouge">src</code> in the filename.</p>
+
+<p>The tar.gz must be named <code class="highlighter-rouge">apache-calcite-avatica-go-src-$version.tar.gz</code>.</p>
+
+<p>There must be a GPG signature for the tar.gz named: <code class="highlighter-rouge">apache-calcite-avatica-go-src-$version.tar.gz.asc</code></p>
+
+<p>There must be a SHA256 hash for the tar.gz named: <code class="highlighter-rouge">apache-calcite-avatica-go-src-$version.tar.gz.sha256</code></p>
+
+<h2 id="uploading-release-artifacts-to-dev-for-voting">Uploading release artifacts to dev for voting</h2>
+<p><code class="highlighter-rouge">svn</code> must be installed in order to upload release artifacts.</p>
+
+<ol>
+ <li>
+ <p>Check out the Calcite dev release subdirectory: <code class="highlighter-rouge">svn co "https://dist.apache.org/repos/dist/dev/calcite/" calcite-dev</code>.</p>
+ </li>
+ <li>
+ <p>Move the release folder under <code class="highlighter-rouge">dist/</code> into the <code class="highlighter-rouge">calcite-dev</code> folder.</p>
+ </li>
+ <li>
+ <p>Add the new release to the svn repository: <code class="highlighter-rouge">svn add apache-calcite-avatica-go-3.0.0-rc0</code>. Remember to change the folder name to the
+correct release in the command.</p>
+ </li>
+ <li>
+ <p>Commit to upload the artifacts: <code class="highlighter-rouge">svn commit -m "apache-calcite-avatica-go-3.0.0-rc0" --username yourapacheusername --force-log</code>
+Note the use of <code class="highlighter-rouge">--force-log</code> to suppress the svn warning, because the commit message is the same as the name of the directory.</p>
+ </li>
+</ol>
+
+<h2 id="promoting-a-release-after-voting">Promoting a release after voting</h2>
+<p><code class="highlighter-rouge">svn</code> must be installed in order to upload release artifacts.</p>
+
+<p>NOTE: Only official releases that has passed a vote may be uploaded to the release directory.</p>
+
+<ol>
+ <li>
+ <p>Check out the Calcite release directory: <code class="highlighter-rouge">svn co "https://dist.apache.org/repos/dist/release/calcite/" calcite-release</code>.</p>
+ </li>
+ <li>
+ <p>Copy the release into the <code class="highlighter-rouge">calcite-release</code> folder. Remember to check the name of the releaseâs folder to ensure that it is in
+the correct format.</p>
+ </li>
+ <li>
+ <p>Add the release to the svn repository: <code class="highlighter-rouge">svn add apache-calcite-avatica-go-3.0.0</code>. Remember to change the folder name to the
+correct release in the command.</p>
+ </li>
+ <li>
+ <p>Commit to upload the artifacts: <code class="highlighter-rouge">svn commit -m "Release apache-calcite-avatica-go-3.0.0" --username yourapacheusername</code>.</p>
+ </li>
+</ol>
+
+ </article>
+ </div>
+
+ <div class="clear"></div>
+
+ </div>
+</section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>
Added: calcite/site/avatica/develop/avatica.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/develop/avatica.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/develop/avatica.html (added)
+++ calcite/site/avatica/develop/avatica.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,265 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Developing Avatica</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="standalone">
+ <div class="grid">
+
+ <div class="unit whole">
+ <article>
+ <h1>Developing Avatica</h1>
+ <!--
+
+-->
+
+<p>Want to help add a feature or fix a bug?</p>
+
+<ul id="markdown-toc">
+ <li><a href="#source-code" id="markdown-toc-source-code">Source code</a></li>
+ <li><a href="#download-source-build-and-run-tests" id="markdown-toc-download-source-build-and-run-tests">Download source, build, and run tests</a> <ul>
+ <li><a href="#disabling-protobuf-generation" id="markdown-toc-disabling-protobuf-generation">Disabling protobuf generation</a></li>
+ </ul>
+ </li>
+ <li><a href="#contributing" id="markdown-toc-contributing">Contributing</a></li>
+ <li><a href="#continuous-integration-testing" id="markdown-toc-continuous-integration-testing">Continuous Integration Testing</a></li>
+ <li><a href="#getting-started" id="markdown-toc-getting-started">Getting started</a></li>
+</ul>
+
+<h2 id="source-code">Source code</h2>
+
+<p>You can get the source code by
+<a href="/avatica/downloads">downloading a release</a>
+or from source control.</p>
+
+<p>Calcite uses git for version control. The canonical source is in
+<a href="https://git-wip-us.apache.org/repos/asf/calcite.git">Apache</a>,
+but most people find the
+<a href="https://github.com/apache/calcite-avatica">Github mirror</a> more
+user-friendly.</p>
+
+<h2 id="download-source-build-and-run-tests">Download source, build, and run tests</h2>
+
+<p>Prerequisites are git, maven (3.2.1 or later) and Java (JDK 1.8 or
+later, 1.9 preferred) on your path.</p>
+
+<p>Create a local copy of the git repository, <code class="highlighter-rouge">cd</code> to its root directory,
+then build using maven:</p>
+
+<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">$ </span>git clone git://github.com/apache/calcite-avatica.git avatica
+<span class="nv">$ </span><span class="nb">cd </span>avatica
+<span class="nv">$ </span>mvn install</code></pre></figure>
+
+<p>The HOWTO describes how to
+<a href="/avatica/docs/howto.html#building-from-a-source-distribution">build from a source distribution</a>,
+<a href="/avatica/docs/howto.html#running-tests">run more or fewer tests</a> and
+<a href="/avatica/docs/howto.html#running-integration-tests">run integration tests</a>.</p>
+
+<h3 id="disabling-protobuf-generation">Disabling protobuf generation</h3>
+
+<p>On older operating systems, developers trying to build Avatica may experience
+issues with the Xolstice maven-protobuf-plugin, similar to the following:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[INFO] Compiling 3 proto file(s) to /avatica/core/src/main/java
+[ERROR] PROTOC FAILED: /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe)
+[ERROR] /avatica/core/src/main/protobuf/common.proto [0:0]: /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe)
+[ERROR] /avatica/core/src/main/protobuf/responses.proto [0:0]: /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe)
+[ERROR] /avatica/core/src/main/protobuf/requests.proto [0:0]: /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by /avatica/core/target/protoc-plugins/protoc-3.1.0-linux-x86_64.exe)
+</code></pre></div></div>
+
+<p>In most cases, it is unnecessary to re-generate the Protobuf messages into Java code. Developers
+can side-step this issue by disabling the <code class="highlighter-rouge">compile-protobuf</code> profile in their Maven execution.</p>
+
+<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">$ </span>mvn package <span class="nt">-P</span><span class="o">!</span>compile-protobuf</code></pre></figure>
+
+<h2 id="contributing">Contributing</h2>
+
+<p>We welcome contributions.</p>
+
+<p>If you are planning to make a large contribution, talk to us first! It
+helps to agree on the general approach. Log a
+<a href="https://issues.apache.org/jira/browse/CALCITE">JIRA case</a> for your
+proposed feature or start a discussion on the dev list.</p>
+
+<p>Fork the github repository, and create a branch for your feature.</p>
+
+<p>Develop your feature and test cases, and make sure that
+<code class="highlighter-rouge">mvn install</code> succeeds. (Run extra tests if your change warrants it.)</p>
+
+<p>Commit your change to your branch, and use a comment that starts with
+the JIRA case number, like this:</p>
+
+<figure class="highlight"><pre><code class="language-text" data-lang="text">[CALCITE-345] AssertionError in RexToLixTranslator comparing to date literal</code></pre></figure>
+
+<p>If your change had multiple commits, use <code class="highlighter-rouge">git rebase -i master</code> to
+squash them into a single commit, and to bring your code up to date
+with the latest on the main line.</p>
+
+<p>Then push your commit(s) to github, and create a pull request from
+your branch to the calcite master branch. Update the JIRA case
+to reference your pull request, and a committer will review your
+changes.</p>
+
+<h2 id="continuous-integration-testing">Continuous Integration Testing</h2>
+
+<p>Calcite has a collection of Jenkins jobs on ASF-hosted infrastructure.
+They are all organized in a single view and available at
+<a href="https://builds.apache.org/view/A-D/view/Calcite-Avatica/">https://builds.apache.org/view/A-D/view/Calcite-Avatica/</a>.</p>
+
+<h2 id="getting-started">Getting started</h2>
+
+<p>Calcite is a community, so the first step to joining the project is to introduce yourself.
+Join the <a href="http://mail-archives.apache.org/mod_mbox/calcite-dev/">developers list</a>
+and send an email.</p>
+
+<p>If you have the chance to attend a <a href="http://www.meetup.com/Apache-Calcite/">meetup</a>,
+or meet <a href="http://calcite.apache.org/develop/#project-members">members of the community</a>
+at a conference, thatâs also great.</p>
+
+<p>Choose an initial task to work on. It should be something really simple,
+such as a bug fix or a <a href="https://issues.apache.org/jira/issues/?jql=labels%20%3D%20newbie%20%26%20project%20%3D%20Calcite%20%26%20status%20%3D%20Open">Jira task that we have labeled
+ânewbieâ</a>.
+Follow the <a href="#contributing">contributing guidelines</a> to get your change committed.</p>
+
+<p>After you have made several useful contributions we may
+<a href="https://community.apache.org/contributors/">invite you to become a committer</a>.
+We value all contributions that help to build a vibrant community, not just code.
+You can contribute by testing the code, helping verify a release,
+writing documentation or the web site,
+or just by answering questions on the list.</p>
+
+ </article>
+ </div>
+
+ <div class="clear"></div>
+
+ </div>
+</section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>
Added: calcite/site/avatica/docs/go_client_reference.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/docs/go_client_reference.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/docs/go_client_reference.html (added)
+++ calcite/site/avatica/docs/go_client_reference.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,1250 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Go Client Reference</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="docs">
+ <div class="grid">
+
+ <div class="docs-nav-mobile unit whole show-on-mobiles">
+ <select onchange="if (this.value) window.location.href=this.value">
+ <option value="">Navigate the docsâ¦</option>
+
+ <optgroup label="Overview">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Reference">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Go Client Reference">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Meta">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Go Client Meta">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ </select>
+</div>
+
+
+ <div class="unit four-fifths">
+ <article>
+ <h1>Go Client Reference</h1>
+ <!--
+
+-->
+
+<p>The Avatica Go client is an Avatica driver for Goâs
+<a href="https://golang.org/pkg/database/sql/">database/sql</a>package.</p>
+
+<p>It also works with the Phoenix Query Server from the Apache
+Phoenix project, as the Phoenix Query Server uses Avatica under the
+hood.</p>
+
+<ul id="markdown-toc">
+ <li><a href="#getting-started" id="markdown-toc-getting-started">Getting Started</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#dsn-data-source-name" id="markdown-toc-dsn-data-source-name">DSN (Data Source Name)</a></li>
+ <li><a href="#timetime-support" id="markdown-toc-timetime-support">time.Time support</a></li>
+ <li><a href="#apache-phoenix-error-codes" id="markdown-toc-apache-phoenix-error-codes">Apache Phoenix Error Codes</a></li>
+ <li><a href="#version-compatibility" id="markdown-toc-version-compatibility">Version Compatibility</a></li>
+</ul>
+
+<h2 id="getting-started">Getting Started</h2>
+<p>Install using your dependency management tool (we recommend <a href="https://github.com/golang/dep">dep</a>!):</p>
+
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nv">$ </span>dep ensure <span class="nt">-add</span> github.com/apache/calcite-avatica-go</code></pre></figure>
+
+<h2 id="usage">Usage</h2>
+
+<p>The Avatica Go driver implements Goâs <code class="highlighter-rouge">database/sql/driver</code> interface, so, import Goâs
+<code class="highlighter-rouge">database/sql</code> package and the driver:</p>
+
+<figure class="highlight"><pre><code class="language-go" data-lang="go"><span class="k">import</span><span class="x"> </span><span class="s">"database/sql"</span><span class="x">
+</span><span class="k">import</span><span class="x"> </span><span class="n">_</span><span class="x"> </span><span class="s">"github.com/apache/calcite-avatica-go"</span><span class="x">
+
+</span><span class="n">db</span><span class="p">,</span><span class="x"> </span><span class="n">err</span><span class="x"> </span><span class="o">:=</span><span class="x"> </span><span class="n">sql</span><span class="o">.</span><span class="n">Open</span><span class="p">(</span><span class="s">"avatica"</span><span class="p">,</span><span class="x"> </span><span class="s">"http://localhost:8765"</span><span class="p">)</span></code></pre></figure>
+
+<p>Then simply use the database connection to query some data, for example:</p>
+
+<figure class="highlight"><pre><code class="language-go" data-lang="go"><span class="n">rows</span><span class="x"> </span><span class="o">:=</span><span class="x"> </span><span class="n">db</span><span class="o">.</span><span class="n">Query</span><span class="p">(</span><span class="s">"SELECT COUNT(*) FROM test"</span><span class="p">)</span></code></pre></figure>
+
+<h2 id="dsn-data-source-name">DSN (Data Source Name)</h2>
+
+<p>The DSN has the following format (optional parts are marked by square brackets):</p>
+
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell">http://[username:password@]address:port[/schema][?parameter1<span class="o">=</span>value&...parameterN<span class="o">=</span>value]</code></pre></figure>
+
+<p>In other words, the scheme (http), address and port are mandatory, but the schema and parameters are optional.</p>
+
+<p><strong><a name="username" href="#username">username</a></strong></p>
+
+<p>This is the JDBC username that is passed directly to the backing database. It is <em>NOT</em> used for authenticating
+against Avatica.</p>
+
+<p><strong><a name="password" href="#password">password</a></strong></p>
+
+<p>This is the JDBC password that is passed directly to the backing database. It is <em>NOT</em> used for authenticating
+against Avatica.</p>
+
+<p><strong><a name="schema" href="#schema">schema</a></strong></p>
+
+<p>The <code class="highlighter-rouge">schema</code> path sets the default schema to use for this connection. For example, if you set it to <code class="highlighter-rouge">myschema</code>,
+then executing the query <code class="highlighter-rouge">SELECT * FROM my_table</code> will have the equivalence of <code class="highlighter-rouge">SELECT * FROM myschema.my_table</code>.
+If schema is set, you can still work on tables in other schemas by supplying a schema prefix:
+<code class="highlighter-rouge">SELECT * FROM myotherschema.my_other_table</code>.</p>
+
+<p>The parameters references the options used by the Java implementation as much as possible.
+The following parameters are supported:</p>
+
+<p><strong><a name="authentication" href="#authentication">authentication</a></strong></p>
+
+<p>The authentication type to use when authenticating against Avatica. Valid values are <code class="highlighter-rouge">BASIC</code> for HTTP Basic authentication,
+<code class="highlighter-rouge">DIGEST</code> for HTTP Digest authentication, and <code class="highlighter-rouge">SPNEGO</code> for Kerberos with SPNEGO authentication.</p>
+
+<p><strong><a name="avaticaUser" href="#avaticaUser">avaticaUser</a></strong></p>
+
+<p>The user to use when authenticating against Avatica. This parameter is required if <code class="highlighter-rouge">authentication</code> is <code class="highlighter-rouge">BASIC</code> or <code class="highlighter-rouge">DIGEST</code>.</p>
+
+<p><strong><a name="avaticaPassword" href="#avaticaPassword">avaticaPassword</a></strong></p>
+
+<p>The password to use when authenticating against Avatica. This parameter is required if <code class="highlighter-rouge">authentication</code> is <code class="highlighter-rouge">BASIC</code> or <code class="highlighter-rouge">DIGEST</code>.</p>
+
+<p><strong><a name="principal" href="#principal">principal</a></strong></p>
+
+<p>The Kerberos principal to use when authenticating against Avatica. It should be in the form <code class="highlighter-rouge">primary/instance@realm</code>, where
+the instance is optional. This parameter is required if <code class="highlighter-rouge">authentication</code> is <code class="highlighter-rouge">SPNEGO</code> and you want the driver to perform the
+Kerberos login.</p>
+
+<p><strong><a name="keytab" href="#keytab">keytab</a></strong></p>
+
+<p>The path to the Kerberos keytab to use when authenticating against Avatica. This parameter is required if <code class="highlighter-rouge">authentication</code>
+is <code class="highlighter-rouge">SPNEGO</code> and you want the driver to perform the Kerberos login.</p>
+
+<p><strong><a name="krb5Conf" href="#krb5Conf">krb5Conf</a></strong></p>
+
+<p>The path to the Kerberos configuration to use when authenticating against Avatica. This parameter is required if <code class="highlighter-rouge">authentication</code>
+is <code class="highlighter-rouge">SPNEGO</code> and you want the driver to perform the Kerberos login.</p>
+
+<p><strong><a name="krb5CredentialsCache" href="#krb5CredentialsCache">krb5CredentialsCache</a></strong></p>
+
+<p>The path to the Kerberos credential cache file to use when authenticating against Avatica. This parameter is required if
+<code class="highlighter-rouge">authentication</code> is <code class="highlighter-rouge">SPNEGO</code> and you have logged into Kerberos already and want the driver to use the existing credentials.</p>
+
+<p><strong><a name="location" href="#location">location</a></strong></p>
+
+<p>The <code class="highlighter-rouge">location</code> will be set as the location of unserialized <code class="highlighter-rouge">time.Time</code> values. It must be a valid timezone.
+If you want to use the local timezone, use <code class="highlighter-rouge">Local</code>. By default, this is set to <code class="highlighter-rouge">UTC</code>.</p>
+
+<p><strong><a name="maxRowsTotal" href="#maxRowsTotal">maxRowsTotal</a></strong></p>
+
+<p>The <code class="highlighter-rouge">maxRowsTotal</code> parameter sets the maximum number of rows to return for a given query. By default, this is set to
+<code class="highlighter-rouge">-1</code>, so that there is no limit on the number of rows returned.</p>
+
+<p><strong><a name="frameMaxSize" href="#frameMaxSize">frameMaxSize</a></strong></p>
+
+<p>The <code class="highlighter-rouge">frameMaxSize</code> parameter sets the maximum number of rows to return in a frame. Depending on the number of rows
+returned and subject to the limits of <code class="highlighter-rouge">maxRowsTotal</code>, a query result set can contain rows in multiple frames. These
+additional frames are then fetched on a as-needed basis. <code class="highlighter-rouge">frameMaxSize</code> allows you to control the number of rows
+in each frame to suit your applicationâs performance profile. By default this is set to <code class="highlighter-rouge">-1</code>, so that there is no limit
+on the number of rows in a frame.</p>
+
+<p><strong><a name="transactionIsolation" href="#transactionIsolation">transactionIsolation</a></strong></p>
+
+<p>Setting <code class="highlighter-rouge">transactionIsolation</code> allows you to set the isolation level for transactions using the connection. The value
+should be a positive integer analogous to the transaction levels defined by the JDBC specification. The default value
+is <code class="highlighter-rouge">0</code>, which means transactions are not supported. This is to deal with the fact that Calcite/Avatica works with
+many types of backends, with some backends having no transaction support. If you are using Apache Phoenix 4.7 onwards,
+we recommend setting it to <code class="highlighter-rouge">4</code>, which is the maximum isolation level supported.</p>
+
+<p>The supported values for <code class="highlighter-rouge">transactionIsolation</code> are:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Value</th>
+ <th style="text-align: left">JDBC Constant</th>
+ <th style="text-align: left">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">0</td>
+ <td style="text-align: left">none</td>
+ <td style="text-align: left">Transactions are not supported</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">1</td>
+ <td style="text-align: left"><code class="highlighter-rouge">TRANSACTION_READ_UNCOMMITTED</code></td>
+ <td style="text-align: left">Dirty reads, non-repeatable reads and phantom reads may occur.</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">2</td>
+ <td style="text-align: left"><code class="highlighter-rouge">TRANSACTION_READ_COMMITTED</code></td>
+ <td style="text-align: left">Dirty reads are prevented, but non-repeatable reads and phantom reads may occur.</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">4</td>
+ <td style="text-align: left"><code class="highlighter-rouge">TRANSACTION_REPEATABLE_READ</code></td>
+ <td style="text-align: left">Dirty reads and non-repeatable reads are prevented, but phantom reads may occur.</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">8</td>
+ <td style="text-align: left"><code class="highlighter-rouge">TRANSACTION_SERIALIZABLE</code></td>
+ <td style="text-align: left">Dirty reads, non-repeatable reads, and phantom reads are all prevented.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="timetime-support">time.Time support</h2>
+
+<p>The following datatypes are automatically converted to and from <code class="highlighter-rouge">time.Time</code>:
+<code class="highlighter-rouge">TIME</code>, <code class="highlighter-rouge">DATE</code> and <code class="highlighter-rouge">TIMESTAMP</code>.</p>
+
+<p>It is important to understand that Avatica and the underlying database ignores the timezone. If you save a <code class="highlighter-rouge">time.Time</code>
+to the database, the timezone is ignored and vice-versa. This is why you need to make sure the <code class="highlighter-rouge">location</code> parameter
+in your DSN is set to the same value as the location of the <code class="highlighter-rouge">time.Time</code> values you are inserting into the database.</p>
+
+<p>We recommend using <code class="highlighter-rouge">UTC</code>, which is the default value of <code class="highlighter-rouge">location</code>.</p>
+
+<h2 id="apache-phoenix-error-codes">Apache Phoenix Error Codes</h2>
+<p>The Go client comes with support for retrieving the error code when an error occurs. This is extremely useful when
+you want to take specific action when a particular type of error occurs.</p>
+
+<p>If the error returned is a ResponseError, calling the <code class="highlighter-rouge">Name()</code> method on the error will return the appropriate
+Apache Phoenix error code:</p>
+
+<figure class="highlight"><pre><code class="language-go" data-lang="go"><span class="n">_</span><span class="p">,</span><span class="x"> </span><span class="n">err</span><span class="x"> </span><span class="o">:=</span><span class="x"> </span><span class="n">db</span><span class="o">.</span><span class="n">Exec</span><span class="p">(</span><span class="s">"SELECT * FROM table_that_does_not_exist"</span><span class="p">)</span><span class="x"> </span><span class="c">// Query undefined table</span><span class="x">
+
+</span><span class="c">// First, assert the error type</span><span class="x">
+</span><span class="n">perr</span><span class="p">,</span><span class="x"> </span><span class="n">ok</span><span class="x"> </span><span class="o">:=</span><span class="x"> </span><span class="n">err</span><span class="o">.</span><span class="p">(</span><span class="n">avatica</span><span class="o">.</span><span class="n">ResponseError</span><span class="p">)</span><span class="x">
+
+</span><span class="c">// If it cannot be asserted</span><span class="x">
+</span><span class="k">if</span><span class="x"> </span><span class="o">!</span><span class="n">ok</span><span class="x"> </span><span class="p">{</span><span class="x">
+ </span><span class="c">// Error was not an Avatica ResponseError</span><span class="x">
+</span><span class="p">}</span><span class="x">
+
+</span><span class="c">// Print the Apache Phoenix error code</span><span class="x">
+</span><span class="n">fmt</span><span class="o">.</span><span class="n">Println</span><span class="p">(</span><span class="n">perr</span><span class="o">.</span><span class="n">Name</span><span class="p">())</span><span class="x"> </span><span class="c">// Prints: table_undefined</span></code></pre></figure>
+
+<h2 id="version-compatibility">Version Compatibility</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Driver Version</th>
+ <th style="text-align: left">Phoenix Version</th>
+ <th style="text-align: left">Calcite-Avatica Version</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">3.x.x</td>
+ <td style="text-align: left">>= 4.8.0</td>
+ <td style="text-align: left">>= 1.11.0</td>
+ </tr>
+ </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <div class="section-nav">
+ <div class="left align-right">
+
+
+
+ <a href="/avatica/docs/protocol_testing.html" class="prev">Previous</a>
+
+ </div>
+ <div class="right align-left">
+
+
+
+
+
+ <a href="/avatica/docs/history.html" class="next">Next</a>
+
+ </div>
+ </div>
+ <div class="clear"></div>
+
+
+ </article>
+ </div>
+
+ <div class="unit one-fifth hide-on-mobiles">
+ <aside>
+
+ <h4>Overview</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/index.html">Background</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/roadmap.html">Roadmap</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Reference</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/client_reference.html">Client Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/json_reference.html">JSON Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/protobuf_reference.html">Protobuf Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/howto.html">HOWTO</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/security.html">Security</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/compatibility.html">Compatibility</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/custom_client_artifacts.html">Custom Client Artifacts</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/docker.html">Docker Images</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/protocol_testing.html">Protocol Testing</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Go Client Reference</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class="current"><a href="/avatica/docs/go_client_reference.html">Go Client Reference</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Meta</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/history.html">History</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/api/">API</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/testapi/">Test API</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Go Client Meta</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/go_history.html">Go Client History</a></li>
+
+
+</ul>
+
+
+ </aside>
+</div>
+
+
+ <div class="clear"></div>
+
+ </div>
+ </section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>
Added: calcite/site/avatica/docs/go_history.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/docs/go_history.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/docs/go_history.html (added)
+++ calcite/site/avatica/docs/go_history.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,1085 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Go Client History</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="docs">
+ <div class="grid">
+
+ <div class="docs-nav-mobile unit whole show-on-mobiles">
+ <select onchange="if (this.value) window.location.href=this.value">
+ <option value="">Navigate the docsâ¦</option>
+
+ <optgroup label="Overview">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Reference">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Go Client Reference">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Meta">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ <optgroup label="Avatica Go Client Meta">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </optgroup>
+
+ </select>
+</div>
+
+
+ <div class="unit four-fifths">
+ <article>
+ <h1>Go Client History</h1>
+ <!--
+
+-->
+
+<p>For a full list of releases, see
+<a href="https://github.com/apache/calcite-avatica-go/releases">github</a>.
+Downloads are available on the
+<a href="/avatica/downloads/avatica-go.html">downloads page</a>.</p>
+
+<h2 id="v3-0-0"><a href="https://github.com/apache/calcite-avatica-go/releases/tag/3.0.0">3.0.0</a> / 2018-04-27</h2>
+
+<p>Apache Calcite Avatica Go 3.0.0 is the first release since the Go driver has been donated
+to the Apache Software foundation.
+We recommend using the latest stable version of Go.</p>
+
+<p>Features and bug fixes</p>
+
+<ul>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1240">CALCITE-1240</a>]
+Intial import of the original <a href="https://github.com/Boostport/avatica">Boostport/avatica</a> code-base into the
+<a href="https://github.com/apache/calcite-avatica-go">apache/calcite-avatica-go</a> repository</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1938">CALCITE-1938</a>]
+Releasing the first release of Calcite Avatica Go under the Apache Software Foundation</li>
+ <li>Remove go-cleanhttp dependency</li>
+ <li>Support for Avatica HSQLDB backend and move Apache Phoenix support into adapter</li>
+ <li>Add bash script to automate releases with checks to alert on files without the Apache license header</li>
+ <li>Replace gopher.png test fixture with Calcite logo</li>
+</ul>
+
+<p>Web site and documentation</p>
+
+<ul>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1937">CALCITE-1937</a>]
+Set up Calcite Avatica Go website</li>
+</ul>
+
+<h2 id="past-releases">Past releases</h2>
+
+<p>Prior to release 3.0.0, the Avatica Go client was developed by Boostport.</p>
+
+<p>Please refer to the <a href="https://github.com/Boostport/avatica">Boostport/avatica</a> Github repository for previous releases
+of the Avatica Go client.</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <div class="section-nav">
+ <div class="left align-right">
+
+
+
+ <a href="/avatica/docs/testapi.html" class="prev">Previous</a>
+
+ </div>
+ <div class="right align-left">
+
+ <span class="next disabled">Next</span>
+
+ </div>
+ </div>
+ <div class="clear"></div>
+
+
+ </article>
+ </div>
+
+ <div class="unit one-fifth hide-on-mobiles">
+ <aside>
+
+ <h4>Overview</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/index.html">Background</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/roadmap.html">Roadmap</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Reference</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/client_reference.html">Client Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/json_reference.html">JSON Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/protobuf_reference.html">Protobuf Reference</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/howto.html">HOWTO</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/security.html">Security</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/compatibility.html">Compatibility</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/custom_client_artifacts.html">Custom Client Artifacts</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/docker.html">Docker Images</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/protocol_testing.html">Protocol Testing</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Go Client Reference</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/go_client_reference.html">Go Client Reference</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Meta</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/history.html">History</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/api/">API</a></li>
+
+
+
+
+
+
+
+
+
+ <li class=""><a href="/avatica/docs/testapi/">Test API</a></li>
+
+
+</ul>
+
+
+ <h4>Avatica Go Client Meta</h4>
+
+
+<ul>
+
+
+
+
+
+
+
+
+ <li class="current"><a href="/avatica/docs/go_history.html">Go Client History</a></li>
+
+
+</ul>
+
+
+ </aside>
+</div>
+
+
+ <div class="clear"></div>
+
+ </div>
+ </section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>
Added: calcite/site/avatica/downloads/avatica-go.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/downloads/avatica-go.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/downloads/avatica-go.html (added)
+++ calcite/site/avatica/downloads/avatica-go.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,187 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Avatica Go Client Downloads</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="standalone">
+ <div class="grid">
+
+ <div class="unit whole">
+ <article>
+ <h1>Avatica Go Client Downloads</h1>
+ <!--
+
+-->
+
+<h2 id="source-releases">Source releases</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Release</th>
+ <th style="text-align: left">Date</th>
+ <th style="text-align: left">Commit</th>
+ <th style="text-align: left">Download</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v3-0-0">3.0.0</a></td>
+ <td style="text-align: left">26 Apr 2018</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica-go/commit/273c53f">273c53f</a></td>
+ <td style="text-align: left"><a href="http://www.apache.org/dyn/closer.lua?filename=calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.tar.gz&action=download">tar</a> (<a href="https://www.apache.org/dist/calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.tar.gz.sha256">sha256</a> <a href="https://www.apache.org/dist/calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.tar.gz.asc">pgp</a>) <br /> <a href="http://www.apache.org/dyn/closer.lua?filename=calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.zip&action=download">zip</a> (<a href="https://www.apache.org/dist/calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.zip.sha256">sha256</a> <a href="https://www.apache.org/dist/calcite/apache-calcite-avatica-go3.0.0/apache-calcite-avatica-go3.0.0-src.zip.asc">pgp</a>)</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Choose a source distribution in either <em>tar</em> or <em>zip</em> format,
+and <a href="http://www.apache.org/dyn/closer.cgi#verify">verify</a>
+using the corresponding <em>pgp</em> signature (using the committer file in
+<a href="http://www.apache.org/dist/calcite/KEYS">KEYS</a>).
+If you cannot do that, use the <em>sha256</em> hash file (<em>md5</em> in older
+releases) to check that the download has completed OK.</p>
+
+<p>For fast downloads, current source distributions are hosted on mirror servers;
+older source distributions are in the
+<a href="http://archive.apache.org/dist/calcite/">archive</a>.
+If a download from a mirror fails, retry, and the second download will likely
+succeed.</p>
+
+<p>For security, hash and signature files are always hosted at
+<a href="https://www.apache.org/dist">Apache</a>.</p>
+
+ </article>
+ </div>
+
+ <div class="clear"></div>
+
+ </div>
+</section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>
Added: calcite/site/avatica/downloads/avatica.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/downloads/avatica.html?rev=1830299&view=auto
==============================================================================
--- calcite/site/avatica/downloads/avatica.html (added)
+++ calcite/site/avatica/downloads/avatica.html Fri Apr 27 07:10:15 2018
@@ -0,0 +1,245 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+<head>
+ <meta charset="UTF-8">
+ <title>Avatica Downloads</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="generator" content="Jekyll v3.7.3">
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+ <link rel="stylesheet" href="/avatica/css/screen.css">
+ <link rel="icon" type="image/x-icon" href="/avatica/favicon.ico">
+ <!--[if lt IE 9]>
+ <script src="/js/html5shiv.min.js"></script>
+ <script src="/js/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+
+<body class="wrap">
+ <header role="banner">
+ <nav class="mobile-nav show-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ <div class="grid">
+ <div class="unit one-third center-on-mobiles">
+ <h1>
+ <a href="/avatica/">
+ <span class="sr-only">Apache Calcite Avatica</span>
+ <img src="/avatica/img/logo.png" width="226" height="140" alt="Calcite Logo">
+ </a>
+ </h1>
+ </div>
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
+ <ul>
+ <li class="">
+ <a href="/avatica/">Home</a>
+ </li>
+ <li class="current">
+ <a href="/avatica/downloads/">Download</a>
+ </li>
+ <li class="">
+ <a href="/avatica/community/">Community</a>
+ </li>
+ <li class="">
+ <a href="/avatica/develop/">Develop</a>
+ </li>
+ <li class="">
+ <a href="/avatica/news/">News</a>
+ </li>
+ <li class="">
+ <a href="/avatica/docs/">Docs</a>
+ </li>
+</ul>
+
+ </nav>
+ </div>
+</header>
+
+
+ <section class="standalone">
+ <div class="grid">
+
+ <div class="unit whole">
+ <article>
+ <h1>Avatica Downloads</h1>
+ <!--
+
+-->
+
+<p>Avatica is released as a source artifact, and also through Maven and Docker Hub.</p>
+
+<h1 id="source-releases">Source releases</h1>
+
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Release</th>
+ <th style="text-align: left">Date</th>
+ <th style="text-align: left">Commit</th>
+ <th style="text-align: left">Download</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v1-11-0">1.11.0</a></td>
+ <td style="text-align: left">09 Mar 2018</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica/commit/e533391">e533391</a></td>
+ <td style="text-align: left"><a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.tar.gz">tar</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.tar.gz.sha256">sha256</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.tar.gz.asc">pgp</a>) <br /> <a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.zip">zip</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.zip.sha256">sha256</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.11.0/apache-calcite-avatica-1.11.0-src.zip.asc">pgp</a>)</td>
+ </tr>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v1-10-0">1.10.0</a></td>
+ <td style="text-align: left">30 May 2017</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica/commit/fcec4be">fcec4be</a></td>
+ <td style="text-align: left"><a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.tar.gz">tar</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.tar.gz.mds">mds</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.tar.gz.asc">pgp</a>) <br /> <a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.zip">zip</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.zip.mds">mds</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.10.0/apache-calcite-avatica-1.10.0-src.zip.asc">pgp</a>)</td>
+ </tr>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v1-9-0">1.9.0</a></td>
+ <td style="text-align: left">01 Nov 2016</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica/commit/e32d778">e32d778</a></td>
+ <td style="text-align: left"><a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.tar.gz">tar</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.tar.gz.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.tar.gz.asc">pgp</a>) <br /> <a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.zip">zip</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.zip.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.9.0/apache-calcite-avatica-1.9.0-src.zip.asc">pgp</a>)</td>
+ </tr>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v1-8-0">1.8.0</a></td>
+ <td style="text-align: left">04 Jun 2016</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica/commit/ddfaf07">ddfaf07</a></td>
+ <td style="text-align: left"><a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.tar.gz">tar</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.tar.gz.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.tar.gz.asc">pgp</a>) <br /> <a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.zip">zip</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.zip.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.8.0/apache-calcite-avatica-1.8.0-src.zip.asc">pgp</a>)</td>
+ </tr>
+ <tr>
+ <td style="text-align: left"><a href="/avatica/docs/history.html#v1-7-1">1.7.1</a></td>
+ <td style="text-align: left">18 Mar 2016</td>
+ <td style="text-align: left"><a href="https://github.com/apache/calcite-avatica/commit/11cb0a8">11cb0a8</a></td>
+ <td style="text-align: left"><a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.tar.gz">tar</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.tar.gz.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.tar.gz.asc">pgp</a>) <br /> <a href="http://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.zip">zip</a> (<a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.zip.md5">md5</a> <a href="https://archive.apache.org/dist/calcite/apache-calcite-avatica-1.7.1/apache-calcite-avatica-1.7.1-src.zip.asc">pgp</a>)</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Choose a source distribution in either <em>tar</em> or <em>zip</em> format,
+and <a href="http://www.apache.org/dyn/closer.cgi#verify">verify</a>
+using the corresponding <em>pgp</em> signature (using the committer file in
+<a href="http://www.apache.org/dist/calcite/KEYS">KEYS</a>).
+If you cannot do that, use the <em>sha256</em> hash file (<em>md5</em> in older
+releases) to check that the download has completed OK.</p>
+
+<p>For fast downloads, current source distributions are hosted on mirror servers;
+older source distributions are in the
+<a href="http://archive.apache.org/dist/calcite/">archive</a>.
+If a download from a mirror fails, retry, and the second download will likely
+succeed.</p>
+
+<p>For security, hash and signature files are always hosted at
+<a href="https://www.apache.org/dist">Apache</a>.</p>
+
+<h1 id="maven-artifacts">Maven artifacts</h1>
+
+<p>Add the following to the dependencies section of your <code class="highlighter-rouge">pom.xml</code> file:</p>
+
+<figure class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><dependencies></span>
+ <span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.apache.calcite.avatica<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>avatica<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>3.0.0<span class="nt"></version></span>
+ <span class="nt"></dependency></span>
+ <span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.apache.calcite.avatica<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>avatica-server<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>3.0.0<span class="nt"></version></span>
+ <span class="nt"></dependency></span>
+<span class="nt"></dependencies></span></code></pre></figure>
+
+<p>As of Apache Calcite Avatica 1.9.0, the following un-shaded client artifact is also available:</p>
+
+<figure class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><dependencies></span>
+ <span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.apache.calcite.avatica<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>avatica-core<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>3.0.0<span class="nt"></version></span>
+ <span class="nt"></dependency></span>
+<span class="nt"></dependencies></span></code></pre></figure>
+
+<h1 id="docker-images">Docker images</h1>
+
+<p>From release 1.10.0 onwards, Docker images for Avatica Server are available at
+<a href="https://hub.docker.com/r/apache/calcite-avatica">Docker Hub</a>.</p>
+
+ </article>
+ </div>
+
+ <div class="clear"></div>
+
+ </div>
+</section>
+
+
+ <footer role="contentinfo">
+ <div id="poweredby">
+ <a href="http://www.apache.org/">
+ <span class="sr-only">Apache</span>
+ <img src="/avatica/img/feather.png" width="190" height="77" alt="Apache Logo"></a>
+ </div>
+ <div id="copyright">
+ <p>The contents of this website are © 2018
+ <a href="https://www.apache.org/">Apache Software Foundation</a>
+ under the terms of
+ the <a href="https://www.apache.org/licenses/LICENSE-2.0.html">
+ Apache License v2</a>. Apache Calcite and its logo are
+ trademarks of the Apache Software Foundation.</p>
+ </div>
+</footer>
+
+ <script>
+ var anchorForId = function (id) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
+ anchor.title = "Permalink";
+ return anchor;
+ };
+
+ var linkifyAnchors = function (level, containingElement) {
+ var headers = containingElement.getElementsByTagName("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id));
+ }
+ }
+ };
+
+ document.onreadystatechange = function () {
+ if (this.readyState === "complete") {
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
+ if (!contentBlock) {
+ return;
+ }
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+ }
+ };
+</script>
+
+
+</body>
+</html>