| |
| |
| <!DOCTYPE html> |
| <html class="writer-html5" lang="en" > |
| <head> |
| <meta charset="utf-8" /> |
| |
| <meta name="viewport" content="width=device-width, initial-scale=1.0" /> |
| |
| <title>Changes — Apache Cassandra Documentation v3.11.10</title> |
| |
| |
| |
| <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" /> |
| <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> |
| <link rel="stylesheet" href="../_static/extra.css" type="text/css" /> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <!--[if lt IE 9]> |
| <script src="../_static/js/html5shiv.min.js"></script> |
| <![endif]--> |
| |
| |
| <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script> |
| <script src="../_static/jquery.js"></script> |
| <script src="../_static/underscore.js"></script> |
| <script src="../_static/doctools.js"></script> |
| |
| <script type="text/javascript" src="../_static/js/theme.js"></script> |
| |
| |
| <link rel="index" title="Index" href="../genindex.html" /> |
| <link rel="search" title="Search" href="../search.html" /> |
| <link rel="next" title="Configuring Cassandra" href="../configuration/index.html" /> |
| <link rel="prev" title="Appendices" href="appendices.html" /> |
| </head> |
| |
| <body class="wy-body-for-nav"> |
| |
| |
| <div class="wy-grid-for-nav"> |
| |
| <nav data-toggle="wy-nav-shift" class="wy-nav-side"> |
| <div class="wy-side-scroll"> |
| <div class="wy-side-nav-search" > |
| |
| |
| |
| <a href="../index.html" class="icon icon-home"> Apache Cassandra |
| |
| |
| |
| </a> |
| |
| |
| |
| |
| <div class="version"> |
| 3.11.10 |
| </div> |
| |
| |
| |
| |
| <div role="search"> |
| <form id="rtd-search-form" class="wy-form" action="../search.html" method="get"> |
| <input type="text" name="q" placeholder="Search docs" /> |
| <input type="hidden" name="check_keywords" value="yes" /> |
| <input type="hidden" name="area" value="default" /> |
| </form> |
| </div> |
| |
| |
| </div> |
| |
| |
| <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> |
| |
| |
| |
| |
| |
| |
| <ul class="current"> |
| <li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../architecture/index.html">Architecture</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../data_modeling/index.html">Data Modeling</a></li> |
| <li class="toctree-l1 current"><a class="reference internal" href="index.html">The Cassandra Query Language (CQL)</a><ul class="current"> |
| <li class="toctree-l2"><a class="reference internal" href="definitions.html">Definitions</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="types.html">Data Types</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="ddl.html">Data Definition</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="dml.html">Data Manipulation</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="indexes.html">Secondary Indexes</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="mvs.html">Materialized Views</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="security.html">Security</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="functions.html">Functions</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="json.html">JSON Support</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="triggers.html">Triggers</a></li> |
| <li class="toctree-l2"><a class="reference internal" href="appendices.html">Appendices</a></li> |
| <li class="toctree-l2 current"><a class="current reference internal" href="#">Changes</a><ul> |
| <li class="toctree-l3"><a class="reference internal" href="#id1">3.4.4</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id2">3.4.3</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id5">3.4.2</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id6">3.4.1</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id7">3.4.0</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id8">3.3.1</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id9">3.3.0</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id10">3.2.0</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id11">3.1.7</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id12">3.1.6</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id13">3.1.5</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id14">3.1.4</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id15">3.1.3</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id16">3.1.2</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id17">3.1.1</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id18">3.1.0</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id19">3.0.5</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id20">3.0.4</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id21">3.0.3</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id22">3.0.2</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#id23">3.0.1</a></li> |
| <li class="toctree-l3"><a class="reference internal" href="#versioning">Versioning</a></li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="toctree-l1"><a class="reference internal" href="../configuration/index.html">Configuring Cassandra</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../operating/index.html">Operating Cassandra</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../tools/index.html">Cassandra Tools</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../troubleshooting/index.html">Troubleshooting</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../development/index.html">Cassandra Development</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../faq/index.html">Frequently Asked Questions</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../bugs.html">Reporting Bugs and Contributing</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../contactus.html">Contact us</a></li> |
| </ul> |
| |
| |
| |
| </div> |
| |
| </div> |
| </nav> |
| |
| <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> |
| |
| |
| <nav class="wy-nav-top" aria-label="top navigation"> |
| |
| <i data-toggle="wy-nav-top" class="fa fa-bars"></i> |
| <a href="../index.html">Apache Cassandra</a> |
| |
| </nav> |
| |
| |
| <div class="wy-nav-content"> |
| |
| <div class="rst-content"> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <div role="navigation" aria-label="breadcrumbs navigation"> |
| |
| <ul class="wy-breadcrumbs"> |
| |
| <li><a href="../index.html" class="icon icon-home"></a> »</li> |
| |
| <li><a href="index.html">The Cassandra Query Language (CQL)</a> »</li> |
| |
| <li>Changes</li> |
| |
| |
| <li class="wy-breadcrumbs-aside"> |
| |
| |
| <a href="../_sources/cql/changes.rst.txt" rel="nofollow"> View page source</a> |
| |
| |
| </li> |
| |
| </ul> |
| |
| |
| <hr/> |
| </div> |
| <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> |
| <div itemprop="articleBody"> |
| |
| <div class="section" id="changes"> |
| <h1>Changes<a class="headerlink" href="#changes" title="Permalink to this headline">¶</a></h1> |
| <p>The following describes the changes in each version of CQL.</p> |
| <div class="section" id="id1"> |
| <h2>3.4.4<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">ALTER</span> <span class="pre">TABLE</span></code> <code class="docutils literal notranslate"><span class="pre">ALTER</span></code> has been removed; a column’s type may not be changed after creation (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-12443">CASSANDRA-12443</a>).</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">ALTER</span> <span class="pre">TYPE</span></code> <code class="docutils literal notranslate"><span class="pre">ALTER</span></code> has been removed; a field’s type may not be changed after creation (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-12443">CASSANDRA-12443</a>).</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id2"> |
| <h2>3.4.3<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Adds a new <a href="#id3"><span class="problematic" id="id4">``</span></a>duration `` <a class="reference internal" href="types.html#data-types"><span class="std std-ref">data types</span></a> (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-11873">CASSANDRA-11873</a>).</p></li> |
| <li><p>Support for <code class="docutils literal notranslate"><span class="pre">GROUP</span> <span class="pre">BY</span></code> (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-10707">CASSANDRA-10707</a>).</p></li> |
| <li><p>Adds a <code class="docutils literal notranslate"><span class="pre">DEFAULT</span> <span class="pre">UNSET</span></code> option for <code class="docutils literal notranslate"><span class="pre">INSERT</span> <span class="pre">JSON</span></code> to ignore omitted columns (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-11424">CASSANDRA-11424</a>).</p></li> |
| <li><p>Allows <code class="docutils literal notranslate"><span class="pre">null</span></code> as a legal value for TTL on insert and update. It will be treated as equivalent to</p></li> |
| </ul> |
| <p>inserting a 0 (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-12216">CASSANDRA-12216</a>).</p> |
| </div> |
| <div class="section" id="id5"> |
| <h2>3.4.2<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>If a table has a non zero <code class="docutils literal notranslate"><span class="pre">default_time_to_live</span></code>, then explicitly specifying a TTL of 0 in an <code class="docutils literal notranslate"><span class="pre">INSERT</span></code> or |
| <code class="docutils literal notranslate"><span class="pre">UPDATE</span></code> statement will result in the new writes not having any expiration (that is, an explicit TTL of 0 cancels |
| the <code class="docutils literal notranslate"><span class="pre">default_time_to_live</span></code>). This wasn’t the case before and the <code class="docutils literal notranslate"><span class="pre">default_time_to_live</span></code> was applied even though a |
| TTL had been explicitly set.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">ALTER</span> <span class="pre">TABLE</span></code> <code class="docutils literal notranslate"><span class="pre">ADD</span></code> and <code class="docutils literal notranslate"><span class="pre">DROP</span></code> now allow multiple columns to be added/removed.</p></li> |
| <li><p>New <code class="docutils literal notranslate"><span class="pre">PER</span> <span class="pre">PARTITION</span> <span class="pre">LIMIT</span></code> option for <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> statements (see <a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-7017)">CASSANDRA-7017</a>.</p></li> |
| <li><p><a class="reference internal" href="functions.html#cql-functions"><span class="std std-ref">User-defined functions</span></a> can now instantiate <code class="docutils literal notranslate"><span class="pre">UDTValue</span></code> and <code class="docutils literal notranslate"><span class="pre">TupleValue</span></code> instances via the |
| new <code class="docutils literal notranslate"><span class="pre">UDFContext</span></code> interface (see <a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-10818)">CASSANDRA-10818</a>.</p></li> |
| <li><p><a class="reference internal" href="types.html#udts"><span class="std std-ref">User-defined types</span></a> may now be stored in a non-frozen form, allowing individual fields to be updated and |
| deleted in <code class="docutils literal notranslate"><span class="pre">UPDATE</span></code> statements and <code class="docutils literal notranslate"><span class="pre">DELETE</span></code> statements, respectively. (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-7423)">CASSANDRA-7423</a>).</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id6"> |
| <h2>3.4.1<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Adds <code class="docutils literal notranslate"><span class="pre">CAST</span></code> functions.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id7"> |
| <h2>3.4.0<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Support for <a class="reference internal" href="mvs.html#materialized-views"><span class="std std-ref">materialized views</span></a>.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">DELETE</span></code> support for inequality expressions and <code class="docutils literal notranslate"><span class="pre">IN</span></code> restrictions on any primary key columns.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">UPDATE</span></code> support for <code class="docutils literal notranslate"><span class="pre">IN</span></code> restrictions on any primary key columns.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id8"> |
| <h2>3.3.1<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>The syntax <code class="docutils literal notranslate"><span class="pre">TRUNCATE</span> <span class="pre">TABLE</span> <span class="pre">X</span></code> is now accepted as an alias for <code class="docutils literal notranslate"><span class="pre">TRUNCATE</span> <span class="pre">X</span></code>.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id9"> |
| <h2>3.3.0<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><a class="reference internal" href="functions.html#cql-functions"><span class="std std-ref">User-defined functions and aggregates</span></a> are now supported.</p></li> |
| <li><p>Allows double-dollar enclosed strings literals as an alternative to single-quote enclosed strings.</p></li> |
| <li><p>Introduces Roles to supersede user based authentication and access control</p></li> |
| <li><p>New <code class="docutils literal notranslate"><span class="pre">date</span></code>, <code class="docutils literal notranslate"><span class="pre">time</span></code>, <code class="docutils literal notranslate"><span class="pre">tinyint</span></code> and <code class="docutils literal notranslate"><span class="pre">smallint</span></code> <a class="reference internal" href="types.html#data-types"><span class="std std-ref">data types</span></a> have been added.</p></li> |
| <li><p><a class="reference internal" href="json.html#cql-json"><span class="std std-ref">JSON support</span></a> has been added</p></li> |
| <li><p>Adds new time conversion functions and deprecate <code class="docutils literal notranslate"><span class="pre">dateOf</span></code> and <code class="docutils literal notranslate"><span class="pre">unixTimestampOf</span></code>.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id10"> |
| <h2>3.2.0<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><a class="reference internal" href="types.html#udts"><span class="std std-ref">User-defined types</span></a> supported.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">CREATE</span> <span class="pre">INDEX</span></code> now supports indexing collection columns, including indexing the keys of map collections through the |
| <code class="docutils literal notranslate"><span class="pre">keys()</span></code> function</p></li> |
| <li><p>Indexes on collections may be queried using the new <code class="docutils literal notranslate"><span class="pre">CONTAINS</span></code> and <code class="docutils literal notranslate"><span class="pre">CONTAINS</span> <span class="pre">KEY</span></code> operators</p></li> |
| <li><p><a class="reference internal" href="types.html#tuples"><span class="std std-ref">Tuple types</span></a> were added to hold fixed-length sets of typed positional fields.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">DROP</span> <span class="pre">INDEX</span></code> now supports optionally specifying a keyspace.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id11"> |
| <h2>3.1.7<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">SELECT</span></code> statements now support selecting multiple rows in a single partition using an <code class="docutils literal notranslate"><span class="pre">IN</span></code> clause on combinations |
| of clustering columns.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">IF</span> <span class="pre">NOT</span> <span class="pre">EXISTS</span></code> and <code class="docutils literal notranslate"><span class="pre">IF</span> <span class="pre">EXISTS</span></code> syntax is now supported by <code class="docutils literal notranslate"><span class="pre">CREATE</span> <span class="pre">USER</span></code> and <code class="docutils literal notranslate"><span class="pre">DROP</span> <span class="pre">USER</span></code> statements, |
| respectively.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id12"> |
| <h2>3.1.6<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>A new <code class="docutils literal notranslate"><span class="pre">uuid()</span></code> method has been added.</p></li> |
| <li><p>Support for <code class="docutils literal notranslate"><span class="pre">DELETE</span> <span class="pre">...</span> <span class="pre">IF</span> <span class="pre">EXISTS</span></code> syntax.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id13"> |
| <h2>3.1.5<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>It is now possible to group clustering columns in a relation, see <a class="reference internal" href="dml.html#where-clause"><span class="std std-ref">WHERE</span></a> clauses.</p></li> |
| <li><p>Added support for <a class="reference internal" href="ddl.html#static-columns"><span class="std std-ref">static columns</span></a>.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id14"> |
| <h2>3.1.4<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">CREATE</span> <span class="pre">INDEX</span></code> now allows specifying options when creating CUSTOM indexes.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id15"> |
| <h2>3.1.3<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Millisecond precision formats have been added to the <a class="reference internal" href="types.html#timestamps"><span class="std std-ref">timestamp</span></a> parser.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id16"> |
| <h2>3.1.2<a class="headerlink" href="#id16" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">NaN</span></code> and <code class="docutils literal notranslate"><span class="pre">Infinity</span></code> has been added as valid float constants. They are now reserved keywords. In the unlikely case |
| you we using them as a column identifier (or keyspace/table one), you will now need to double quote them.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id17"> |
| <h2>3.1.1<a class="headerlink" href="#id17" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">SELECT</span></code> statement now allows listing the partition keys (using the <code class="docutils literal notranslate"><span class="pre">DISTINCT</span></code> modifier). See <a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-4536">CASSANDRA-4536</a>.</p></li> |
| <li><p>The syntax <code class="docutils literal notranslate"><span class="pre">c</span> <span class="pre">IN</span> <span class="pre">?</span></code> is now supported in <code class="docutils literal notranslate"><span class="pre">WHERE</span></code> clauses. In that case, the value expected for the bind variable |
| will be a list of whatever type <code class="docutils literal notranslate"><span class="pre">c</span></code> is.</p></li> |
| <li><p>It is now possible to use named bind variables (using <code class="docutils literal notranslate"><span class="pre">:name</span></code> instead of <code class="docutils literal notranslate"><span class="pre">?</span></code>).</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id18"> |
| <h2>3.1.0<a class="headerlink" href="#id18" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">ALTER</span> <span class="pre">TABLE</span></code> <code class="docutils literal notranslate"><span class="pre">DROP</span></code> option added.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">SELECT</span></code> statement now supports aliases in select clause. Aliases in WHERE and ORDER BY clauses are not supported.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">CREATE</span></code> statements for <code class="docutils literal notranslate"><span class="pre">KEYSPACE</span></code>, <code class="docutils literal notranslate"><span class="pre">TABLE</span></code> and <code class="docutils literal notranslate"><span class="pre">INDEX</span></code> now supports an <code class="docutils literal notranslate"><span class="pre">IF</span> <span class="pre">NOT</span> <span class="pre">EXISTS</span></code> condition. |
| Similarly, <code class="docutils literal notranslate"><span class="pre">DROP</span></code> statements support a <code class="docutils literal notranslate"><span class="pre">IF</span> <span class="pre">EXISTS</span></code> condition.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">INSERT</span></code> statements optionally supports a <code class="docutils literal notranslate"><span class="pre">IF</span> <span class="pre">NOT</span> <span class="pre">EXISTS</span></code> condition and <code class="docutils literal notranslate"><span class="pre">UPDATE</span></code> supports <code class="docutils literal notranslate"><span class="pre">IF</span></code> conditions.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id19"> |
| <h2>3.0.5<a class="headerlink" href="#id19" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">SELECT</span></code>, <code class="docutils literal notranslate"><span class="pre">UPDATE</span></code>, and <code class="docutils literal notranslate"><span class="pre">DELETE</span></code> statements now allow empty <code class="docutils literal notranslate"><span class="pre">IN</span></code> relations (see <a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-5626)">CASSANDRA-5626</a>.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id20"> |
| <h2>3.0.4<a class="headerlink" href="#id20" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Updated the syntax for custom <a class="reference internal" href="indexes.html#secondary-indexes"><span class="std std-ref">secondary indexes</span></a>.</p></li> |
| <li><p>Non-equal condition on the partition key are now never supported, even for ordering partitioner as this was not |
| correct (the order was <strong>not</strong> the one of the type of the partition key). Instead, the <code class="docutils literal notranslate"><span class="pre">token</span></code> method should always |
| be used for range queries on the partition key (see <a class="reference internal" href="dml.html#where-clause"><span class="std std-ref">WHERE clauses</span></a>).</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id21"> |
| <h2>3.0.3<a class="headerlink" href="#id21" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Support for custom <a class="reference internal" href="indexes.html#secondary-indexes"><span class="std std-ref">secondary indexes</span></a> has been added.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id22"> |
| <h2>3.0.2<a class="headerlink" href="#id22" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Type validation for the <a class="reference internal" href="definitions.html#constants"><span class="std std-ref">constants</span></a> has been fixed. For instance, the implementation used to allow |
| <code class="docutils literal notranslate"><span class="pre">'2'</span></code> as a valid value for an <code class="docutils literal notranslate"><span class="pre">int</span></code> column (interpreting it has the equivalent of <code class="docutils literal notranslate"><span class="pre">2</span></code>), or <code class="docutils literal notranslate"><span class="pre">42</span></code> as a valid |
| <code class="docutils literal notranslate"><span class="pre">blob</span></code> value (in which case <code class="docutils literal notranslate"><span class="pre">42</span></code> was interpreted as an hexadecimal representation of the blob). This is no longer |
| the case, type validation of constants is now more strict. See the <a class="reference internal" href="types.html#data-types"><span class="std std-ref">data types</span></a> section for details |
| on which constant is allowed for which type.</p></li> |
| <li><p>The type validation fixed of the previous point has lead to the introduction of blobs constants to allow the input of |
| blobs. Do note that while the input of blobs as strings constant is still supported by this version (to allow smoother |
| transition to blob constant), it is now deprecated and will be removed by a future version. If you were using strings |
| as blobs, you should thus update your client code ASAP to switch blob constants.</p></li> |
| <li><p>A number of functions to convert native types to blobs have also been introduced. Furthermore the token function is |
| now also allowed in select clauses. See the <a class="reference internal" href="functions.html#cql-functions"><span class="std std-ref">section on functions</span></a> for details.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="id23"> |
| <h2>3.0.1<a class="headerlink" href="#id23" title="Permalink to this headline">¶</a></h2> |
| <ul class="simple"> |
| <li><p>Date strings (and timestamps) are no longer accepted as valid <code class="docutils literal notranslate"><span class="pre">timeuuid</span></code> values. Doing so was a bug in the sense |
| that date string are not valid <code class="docutils literal notranslate"><span class="pre">timeuuid</span></code>, and it was thus resulting in <a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-4936">confusing behaviors</a>. However, the following new methods have been added to help |
| working with <code class="docutils literal notranslate"><span class="pre">timeuuid</span></code>: <code class="docutils literal notranslate"><span class="pre">now</span></code>, <code class="docutils literal notranslate"><span class="pre">minTimeuuid</span></code>, <code class="docutils literal notranslate"><span class="pre">maxTimeuuid</span></code> , |
| <code class="docutils literal notranslate"><span class="pre">dateOf</span></code> and <code class="docutils literal notranslate"><span class="pre">unixTimestampOf</span></code>.</p></li> |
| <li><p>Float constants now support the exponent notation. In other words, <code class="docutils literal notranslate"><span class="pre">4.2E10</span></code> is now a valid floating point value.</p></li> |
| </ul> |
| </div> |
| <div class="section" id="versioning"> |
| <h2>Versioning<a class="headerlink" href="#versioning" title="Permalink to this headline">¶</a></h2> |
| <p>Versioning of the CQL language adheres to the <a class="reference external" href="http://semver.org">Semantic Versioning</a> guidelines. Versions take the |
| form X.Y.Z where X, Y, and Z are integer values representing major, minor, and patch level respectively. There is no |
| correlation between Cassandra release versions and the CQL language version.</p> |
| <table class="docutils align-default"> |
| <colgroup> |
| <col style="width: 8%" /> |
| <col style="width: 92%" /> |
| </colgroup> |
| <thead> |
| <tr class="row-odd"><th class="head"><p>version</p></th> |
| <th class="head"><p>description</p></th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr class="row-even"><td><p>Major</p></td> |
| <td><p>The major version <em>must</em> be bumped when backward incompatible changes are introduced. This should rarely |
| occur.</p></td> |
| </tr> |
| <tr class="row-odd"><td><p>Minor</p></td> |
| <td><p>Minor version increments occur when new, but backward compatible, functionality is introduced.</p></td> |
| </tr> |
| <tr class="row-even"><td><p>Patch</p></td> |
| <td><p>The patch version is incremented when bugs are fixed.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| </div> |
| |
| |
| </div> |
| |
| </div> |
| <footer> |
| <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> |
| <a href="../configuration/index.html" class="btn btn-neutral float-right" title="Configuring Cassandra" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a> |
| <a href="appendices.html" class="btn btn-neutral float-left" title="Appendices" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a> |
| </div> |
| |
| <hr/> |
| |
| <div role="contentinfo"> |
| <p> |
| © Copyright 2016, The Apache Cassandra team. |
| |
| </p> |
| </div> |
| |
| |
| |
| Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a |
| |
| <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> |
| |
| provided by <a href="https://readthedocs.org">Read the Docs</a>. |
| |
| </footer> |
| </div> |
| </div> |
| |
| </section> |
| |
| </div> |
| |
| |
| <script type="text/javascript"> |
| jQuery(function () { |
| SphinxRtdTheme.Navigation.enable(true); |
| }); |
| </script> |
| |
| |
| |
| |
| |
| |
| </body> |
| </html> |