You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@calcite.apache.org by jh...@apache.org on 2016/10/31 16:29:06 UTC
svn commit: r1767324 - in /calcite/site/avatica/docs: history.html howto.html
Author: jhyde
Date: Mon Oct 31 16:29:05 2016
New Revision: 1767324
URL: http://svn.apache.org/viewvc?rev=1767324&view=rev
Log:
Avatica 1.9 release notes and howto
Modified:
calcite/site/avatica/docs/history.html
calcite/site/avatica/docs/howto.html
Modified: calcite/site/avatica/docs/history.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/docs/history.html?rev=1767324&r1=1767323&r2=1767324&view=diff
==============================================================================
--- calcite/site/avatica/docs/history.html (original)
+++ calcite/site/avatica/docs/history.html Mon Oct 31 16:29:05 2016
@@ -456,6 +456,95 @@
Downloads are available on the
<a href="/avatica/downloads/">downloads page</a>.</p>
+<h2 id="v1-9-0"><a href="https://github.com/apache/calcite/releases/tag/calcite-avatica-1.9.0">1.9.0</a> / 2016-11-01</h2>
+
+<p>Apache Calcite Avatica 1.9.0 includes various improvements to make it
+more robust and secure, while maintaining API and protocol
+compatibility with previous versions. We now include non-shaded and
+shaded artifacts, to make it easier to embed Avatica in your
+application. There is improved support for the JDBC API, including
+better type conversions and support for canceling statements. The
+transport is upgraded to use protobuf-3.1.0 (previously 3.0 beta).</p>
+
+<p>Compatibility: This release is tested
+on Linux, macOS, Microsoft Windows;
+using Oracle JDK 1.7, 1.8;
+Guava versions 14.0 to 19.0;
+other software versions as specified in <code class="highlighter-rouge">pom.xml</code>.</p>
+
+<p>Features and bug fixes</p>
+
+<ul>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1471">CALCITE-1471</a>]
+<code class="highlighter-rouge">HttpServerSpnegoWithJaasTest.testAuthenticatedClientsAllowed</code> fails on Windows
+(Aaron Mihalik)</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1464">CALCITE-1464</a>]
+Upgrade Jetty version to 9.2.19v20160908</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1463">CALCITE-1463</a>]
+In <code class="highlighter-rouge">standalone-server</code> jar, relocate dependencies rather than excluding them</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1355">CALCITE-1355</a>]
+Upgrade to protobuf-java 3.1.0</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1462">CALCITE-1462</a>]
+Remove Avatica pom cruft</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1458">CALCITE-1458</a>]
+Add column values to the deprecated protobuf attribute</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1433">CALCITE-1433</a>]
+Add missing dependencies to <code class="highlighter-rouge">avatica-server</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1433">CALCITE-1433</a>]
+Fix missing avatica <code class="highlighter-rouge">test-jar</code> dependency</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1423">CALCITE-1423</a>]
+Add method <code class="highlighter-rouge">ByteString.indexOf(ByteString, int)</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1408">CALCITE-1408</a>]
+<code class="highlighter-rouge">ResultSet.getXxx</code> methods should throw <code class="highlighter-rouge">SQLDataException</code> if cannot convert to
+the requested type (Laurent Goujon)</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1410">CALCITE-1410</a>]
+Fix JDBC metadata classes (Laurent Goujon)</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1224">CALCITE-1224</a>]
+Publish non-shaded and shaded versions of Avatica client artifacts</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1407">CALCITE-1407</a>]
+<code class="highlighter-rouge">MetaImpl.fieldMetaData</code> wrongly uses 1-based column ordinals</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1361">CALCITE-1361</a>]
+Remove entry from <code class="highlighter-rouge">AvaticaConnection.flagMap</code> when session closed</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1399">CALCITE-1399</a>]
+Make the jcommander <code class="highlighter-rouge">SerializationConverter</code> public</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1394">CALCITE-1394</a>]
+Javadoc warnings due to <code class="highlighter-rouge">CoreMatchers.containsString</code> and <code class="highlighter-rouge">mockito-all</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1390">CALCITE-1390</a>]
+Avatica JDBC driver wrongly modifies <code class="highlighter-rouge">Properties</code> object</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1371">CALCITE-1371</a>]
+<code class="highlighter-rouge">PreparedStatement</code> does not process Date type correctly (Billy (Yiming) Liu)</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1301">CALCITE-1301</a>]
+Add <code class="highlighter-rouge">cancel</code> flag to <code class="highlighter-rouge">AvaticaStatement</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1315">CALCITE-1315</a>]
+Retry the request on <code class="highlighter-rouge">NoHttpResponseException</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1300">CALCITE-1300</a>]
+Retry on HTTP-503 in hc-based <code class="highlighter-rouge">AvaticaHttpClient</code></li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1263">CALCITE-1263</a>]
+Case-insensitive match and null default value for <code class="highlighter-rouge">enum</code> properties</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1282">CALCITE-1282</a>]
+Adds an API method to set extra allowed Kerberos realms</li>
+</ul>
+
+<p>Tests</p>
+
+<ul>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1226">CALCITE-1226</a>]
+Disable <code class="highlighter-rouge">AvaticaSpnegoTest</code> due to intermittent failures</li>
+</ul>
+
+<p>Web site and documentation</p>
+
+<ul>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1369">CALCITE-1369</a>]
+Add list of Avatica clients to the web site</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1229">CALCITE-1229</a>]
+Restore API and Test API links to site</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1287">CALCITE-1287</a>]
+TCK test for binary columns</li>
+ <li>[<a href="https://issues.apache.org/jira/browse/CALCITE-1285">CALCITE-1285</a>]
+Fix client URL template in example config file</li>
+</ul>
+
<h2 id="v1-8-0"><a href="https://github.com/apache/calcite/releases/tag/calcite-avatica-1.8.0">1.8.0</a> / 2016-06-04</h2>
<p>Apache Calcite Avatica 1.8.0 continues the focus on compatibility with previous
Modified: calcite/site/avatica/docs/howto.html
URL: http://svn.apache.org/viewvc/calcite/site/avatica/docs/howto.html?rev=1767324&r1=1767323&r2=1767324&view=diff
==============================================================================
--- calcite/site/avatica/docs/howto.html (original)
+++ calcite/site/avatica/docs/howto.html Mon Oct 31 16:29:05 2016
@@ -487,8 +487,8 @@ and Java (JDK 1.7 or later, 1.8 preferre
<code class="highlighter-rouge">cd</code> to the root directory of the unpacked source,
then build using maven:</p>
-<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>tar xvfz calcite-1.6.0-source.tar.gz
-<span class="gp">$ </span><span class="nb">cd </span>calcite-1.6.0
+<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>tar xvfz apache-calcite-avatica-1.9.0-src.tar.gz
+<span class="gp">$ </span><span class="nb">cd </span>apache-calcite-avatica-1.9.0-src
<span class="gp">$ </span>mvn install</code></pre></figure>
<p><a href="#running-tests">Running tests</a> describes how to run more or fewer
@@ -504,23 +504,9 @@ and Java (JDK 1.7 or later, 1.8 preferre
then build using maven:</p>
<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>git clone git://github.com/apache/calcite.git
-<span class="gp">$ </span><span class="nb">cd </span>calcite
+<span class="gp">$ </span><span class="nb">cd </span>calcite/avatica
<span class="gp">$ </span>mvn install</code></pre></figure>
-<p>Calcite includes a number of machine-generated codes. By default, these are
-regenerated on every build, but this has the negative side-effect of causing
-a re-compilation of the entire project when the non-machine-generated code
-has not changed. To make sure incremental compilation still works as intended,
-provide the <code class="highlighter-rouge">skipGenerate</code> command line option with your maven command.
-If you invoke the <code class="highlighter-rouge">clean</code> lifecycle phase, you must not specify the
-<code class="highlighter-rouge">skipGenerate</code> option as it will not recompile the necessary code for the build
-to succeed.</p>
-
-<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>mvn clean
-<span class="gp">$ </span>mvn package
-... hacks ...
-<span class="gp">$ </span>mvn package -DskipGenerate</code></pre></figure>
-
<p><a href="#running-tests">Running tests</a> describes how to run more or fewer
tests.</p>
@@ -563,10 +549,10 @@ objects.</p>
<p>Typically, the code generated by the Protocol Buffers library doesn’t
need to be re-generated only every build, only when the schema changes.</p>
-<p>First, install Protobuf 3.0:</p>
+<p>First, install Protobuf 3.1:</p>
-<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>wget https://github.com/google/protobuf/releases/download/v3.0.0-beta-1/protobuf-java-3.0.0-beta-1.tar.gz
-<span class="gp">$ </span>tar xf protobuf-java-3.0.0-beta-1.tar.gz <span class="o">&&</span> <span class="nb">cd </span>protobuf-3.0.0-beta-1
+<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>wget https://github.com/google/protobuf/releases/download/v3.1.0/protobuf-java-3.1.0.tar.gz
+<span class="gp">$ </span>tar xf protobuf-java-3.1.0.tar.gz <span class="o">&&</span> <span class="nb">cd </span>protobuf-3.1.0
<span class="gp">$ </span>./configure
<span class="gp">$ </span>make
<span class="gp">$ </span>sudo make install</code></pre></figure>
@@ -653,10 +639,11 @@ a fix version assigned (most likely the
just about to release)</li>
</ul>
-<p>Create a release branch named after the release, e.g. <code class="highlighter-rouge">branch-1.1</code>, and push it to Apache.</p>
+<p>Create a release branch named after the release, e.g.
+<code class="highlighter-rouge">branch-avatica-1.9</code>, and push it to Apache.</p>
-<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>git checkout -b branch-X.Y
-<span class="gp">$ </span>git push -u origin branch-X.Y</code></pre></figure>
+<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>git checkout -b branch-avatica-X.Y
+<span class="gp">$ </span>git push -u origin branch-avatica-X.Y</code></pre></figure>
<p>We will use the branch for the entire the release process. Meanwhile,
we do not allow commits to the master branch. After the release is
@@ -705,11 +692,9 @@ no binary distro), check that all files
</ul>
</li>
<li>For each .jar, verify that the <code class="highlighter-rouge">META-INF</code> directory contains the correct
-contents for <code class="highlighter-rouge">DEPENDENCIES</code>, <code class="highlighter-rouge">LICENSE</code>, <code class="highlighter-rouge">NOTICE</code> and <code class="highlighter-rouge">git.properties</code> per the
+contents for <code class="highlighter-rouge">DEPENDENCIES</code>, <code class="highlighter-rouge">LICENSE</code> and <code class="highlighter-rouge">NOTICE</code> per the
source/classes contained. Refer to the ASF licensing documentation on
what is required.</li>
- <li>In each .jar, check that <code class="highlighter-rouge">org-apache-calcite-jdbc.properties</code> is
-present and does not contain un-substituted <code class="highlighter-rouge">${...}</code> variables</li>
<li>Check PGP, per <a href="https://httpd.apache.org/dev/verification.html">this</a></li>
</ul>
@@ -750,8 +735,8 @@ svn co https://dist.apache.org/repos/dis
<span class="c"># Move the files into a directory</span>
<span class="nb">cd </span>target
-mkdir ~/dist/dev/calcite/apache-calcite-X.Y.Z-rcN
-mv apache-calcite-<span class="k">*</span> ~/dist/dev/calcite/apache-calcite-avatica-X.Y.Z-rcN
+mkdir ~/dist/dev/calcite/apache-calcite-avatica-X.Y.Z-rcN
+mv apache-calcite-avatica-<span class="k">*</span> ~/dist/dev/calcite/apache-calcite-avatica-X.Y.Z-rcN
<span class="c"># Check in</span>
<span class="nb">cd</span> ~/dist/dev/calcite