This is an automated email from the ASF dual-hosted git repository. paulo pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/cassandra-website.git
commit f8f3ae33fb3ea1d481e64c24adc651b1ecceb2df Author: Paulo Motta <[email protected]> AuthorDate: Wed Mar 10 11:21:36 2021 -0300 generate docs for 7daffb6d --- .../blog/2021/03/10/join_cassandra_gsoc_2021.html | 181 +++++++++++++++++++++ content/blog/index.html | 16 +- content/blog/page2/index.html | 18 +- content/blog/page3/index.html | 9 + .../configuration/cassandra_config_file.html | 4 +- content/doc/4.0-beta5/cql/definitions.html | 6 +- .../doc/4.0-beta5/getting_started/installing.html | 2 +- content/doc/4.0-beta5/new/streaming.html | 10 +- content/doc/4.0-beta5/searchindex.js | 2 +- content/doc/4.0-beta5/tools/cqlsh.html | 4 +- content/doc/4.0-beta5/tools/nodetool/import.html | 9 +- .../configuration/cassandra_config_file.html | 4 +- content/doc/latest/cql/definitions.html | 6 +- content/doc/latest/getting_started/installing.html | 2 +- content/doc/latest/new/streaming.html | 10 +- content/doc/latest/searchindex.js | 2 +- content/doc/latest/tools/cqlsh.html | 4 +- content/doc/latest/tools/nodetool/import.html | 9 +- content/feed.xml | 164 ++++--------------- .../configuration/cassandra_config_file.rst.txt | 4 +- src/doc/4.0-beta5/_sources/cql/definitions.rst.txt | 6 +- .../_sources/getting_started/installing.rst.txt | 2 +- src/doc/4.0-beta5/_sources/new/streaming.rst.txt | 13 +- src/doc/4.0-beta5/_sources/tools/cqlsh.rst.txt | 4 +- .../configuration/cassandra_config_file.html | 4 +- src/doc/4.0-beta5/cql/definitions.html | 6 +- src/doc/4.0-beta5/getting_started/installing.html | 2 +- src/doc/4.0-beta5/new/streaming.html | 10 +- src/doc/4.0-beta5/searchindex.js | 2 +- src/doc/4.0-beta5/tools/cqlsh.html | 4 +- src/doc/4.0-beta5/tools/nodetool/import.html | 9 +- 31 files changed, 321 insertions(+), 207 deletions(-) diff --git a/content/blog/2021/03/10/join_cassandra_gsoc_2021.html b/content/blog/2021/03/10/join_cassandra_gsoc_2021.html new file mode 100644 index 0000000..2aa7c59 --- /dev/null +++ b/content/blog/2021/03/10/join_cassandra_gsoc_2021.html @@ -0,0 +1,181 @@ +<!DOCTYPE html> +<html> + + + + +<head> + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <meta name="description" content="Getting involved with Apache Cassandra @ Google Summer of Code 2021"> + <meta name="keywords" content="cassandra, apache, apache cassandra, distributed storage, key value store, scalability, bigtable, dynamo" /> + <meta name="robots" content="index,follow" /> + <meta name="language" content="en" /> + + <title>Join Apache Cassandra for Google Summer of Code 2021</title> + + <link rel="canonical" href="http://cassandra.apache.org/blog/2021/03/10/join_cassandra_gsoc_2021.html";> + + <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"; integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7" crossorigin="anonymous"> + <link rel="stylesheet" href="./../../../../css/style.css"> + + + + <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.2.0/css/all.css"; integrity="sha384-hWVjflwFxL6sNzntih27bfxkr27PmbbK/iSvJ+a4+0owXq79v+lsFkW54bOGbiDQ" crossorigin="anonymous"> + + <link type="application/atom+xml" rel="alternate" href="http://cassandra.apache.org/feed.xml"; title="Apache Cassandra Website" /> +</head> + + <body> + <!-- breadcrumbs --> +<div class="topnav"> + <div class="container breadcrumb-container"> + <ul class="breadcrumb"> + <li> + <div class="dropdown"> + <img class="asf-logo" src="./../../../../img/asf_feather.png" /> + <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a> + <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel"> + <li><a href="http://www.apache.org";>Apache Homepage</a></li> + <li><a href="http://www.apache.org/licenses/";>License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> + <li><a href="http://www.apache.org/security/";>Security</a></li> + </ul> + </div> + </li> + + + <li><a href="./../../../../">Apache Cassandra</a></li> + + + + + <li>Join Apache Cassandra for Google Summer of Code 2021</li> + + + + + + + </ul> + </div> + + <!-- navbar --> + <nav class="navbar navbar-default navbar-static-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#cassandra-menu" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="./../../../../"><img src="./../../../../img/cassandra_logo.png" alt="Apache Cassandra logo" /></a> + </div><!-- /.navbar-header --> + + <div id="cassandra-menu" class="collapse navbar-collapse"> + <ul class="nav navbar-nav navbar-right"> + <li><a href="./../../../../">Home</a></li> + <li><a href="./../../../../download/">Download</a></li> + <li><a href="./../../../../doc/latest/">Documentation</a></li> + <li><a href="./../../../../community/">Community</a></li> + <li> + <a href="./../../../../blog/">Blog</a> + </li> + </ul> + </div><!-- /#cassandra-menu --> + + + </div> + </nav><!-- /.navbar --> +</div><!-- /.topnav --> + + <div class="content"> + <div class="container"> + <h2>Join Apache Cassandra for Google Summer of Code 2021</h2> + <p>Posted on March 10, 2021 by Paulo Motta</p> + <h5><a href="/blog">« Back to the Apache Cassandra Blog</a></h5> + <hr /> + <p align="center"> + <img src="https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png"; style="width:40%;" /> +</p> + +<p>I have been involved with Apache Cassandra for the past eight years, and I’m very proud to mention that my open source journey started a little more than a decade ago during my participation at the Google Summer of Code (GSoC).</p> + +<p>GSoC is a program sponsored by Google to promote open source development, where post-secondary students submit project proposals to open source organizations. Selected students receive community mentorship and a stipend from Google to work on the project for ten weeks during the northern hemisphere summer. Over 16,000 students from 111 countries have participated so far! More details about the program can be found on the <a href="https://summerofcode.withgoogle.com/";>official GSoC web [...] + +<p>The Apache Software Foundation (ASF) has been a <a href="https://community.apache.org/gsoc.html";>GSoC mentor organization</a> since the beginning of the program 17 years ago. The ASF acts as an “umbrella” organization, which means that students can submit project proposals to any subproject within the ASF. Apache Cassandra mentored a successful GSoC project in <a href="https://summerofcode.withgoogle.com/archive/2016/projects/5429448547500032/";>2016</a> and we are participating again [...] + +<h3 id="how-to-get-involved">How to Get Involved</h3> + +<h4 id="getting-started">Getting Started</h4> + +<p>The best way to get started if you’re new to Apache Cassandra is to get acquainted by reading the <a href="https://cassandra.apache.org/doc/latest/";>documentation</a> and setting up a local <a href="https://cassandra.apache.org/doc/latest/development/ide.html";>development environment</a>. Play around with a locally running instance via <a href="https://cassandra.apache.org/doc/latest/tools/cqlsh.html?highlight=cqlsh";>cqlsh</a> and <a href="https://cassandra.apache.org/doc/latest/tools [...] + +<h4 id="gsoc-project-ideas">GSoC Project Ideas</h4> + +<p>Once you have a basic understanding of how the project works, browse the <a href="https://issues.apache.org/jira/browse/CASSANDRA-16456?jql=labels%20%3D%20gsoc2021%20AND%20project%20%3D%20Cassandra";>GSoC ideas list</a> to select ideas that you are interested in working on. Browse the <a href="https://github.com/apache/cassandra/";>codebase</a> to identify components related to the idea you picked. You are welcome to propose other projects if they’re not on the ideas list.</p> + +<h4 id="writing-a-proposal">Writing a proposal</h4> + +<p>Write a message on the JIRA ticket introducing yourself and demonstrating your interest in working on that particular idea. Sketch a quick proposal on how you plan to tackle the problem and share it with the community for feedback. If you don’t know where to start, don’t hesitate to ask for help!</p> + +<h4 id="useful-resources">Useful Resources</h4> + +<p>There are many good resources on the web on preparing for GSoC, particularly the <a href="https://community.apache.org/gsoc.html";>ASF GSoC Guide</a> and the Python community notes on <a href="https://wiki.python.org/moin/SummerOfCode/Expectations";>GSoC expectations</a>. The best GSoC students are self-motivated and proactive, and following the tips above should increase your chances of getting selected and delivering your project successfully. Good luck!</p> + + </div> +</div> + + <hr /> + +<footer> + <div class="container"> + <div class="col-md-4 social-blk"> + <span class="social"> + <a href="https://twitter.com/cassandra"; + class="twitter-follow-button" + data-show-count="false" data-size="large">Follow @cassandra</a> + <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> + <a href="https://twitter.com/intent/tweet?button_hashtag=cassandra"; + class="twitter-hashtag-button" + data-size="large" + data-related="ApacheCassandra">Tweet #cassandra</a> + <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> + + </span> + <a class="subscribe-rss icon-link" href="/feed.xml" title="Subscribe to Blog via RSS"> + <span><i class="fa fa-rss"></i></span> + </a> + </div> + + <div class="col-md-8 trademark"> + <p>© 2016 <a href="http://apache.org";>The Apache Software Foundation</a>. + Apache, the Apache feather logo, and Apache Cassandra are trademarks of The Apache Software Foundation. + <p> + </div> + </div><!-- /.container --> +</footer> + +<!-- Javascript. Placed here so pages load faster --> +<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js";></script> +<script src="./../../../../js/underscore-min.js"></script> +<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"; integrity="sha384-0mSbJDEHialfmuBBQP6A4Qrprq5OVfW37PRR3j5ELqxss1yVqOtnepnHVP9aJ7xS" crossorigin="anonymous"></script> + + + +<script type="text/javascript"> + var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl."; : "http://www.";); + document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); + + try { + var pageTracker = _gat._getTracker("UA-11583863-1"); + pageTracker._trackPageview(); + } catch(err) {} +</script> + + + </body> +</html> diff --git a/content/blog/index.html b/content/blog/index.html index ff7e415..9b514df 100644 --- a/content/blog/index.html +++ b/content/blog/index.html @@ -102,6 +102,13 @@ <ul class="blog-post-listing"> <li class="blog-post"> + <h4><a href="/blog/2021/03/10/join_cassandra_gsoc_2021.html">Join Apache Cassandra for Google Summer of Code 2021</a></h4> + <p>Posted on March 10, 2021 by Paulo Motta</p> + Getting involved with Apache Cassandra @ Google Summer of Code 2021 + <h5><a href="/blog/2021/03/10/join_cassandra_gsoc_2021.html">Read more »</a></h5> + </li> + + <li class="blog-post"> <h4><a href="/blog/2021/02/11/cass-changelog_4.html">Apache Cassandra Changelog #4 | February 2021</a></h4> <p>Posted on February 11, 2021 by the Apache Cassandra Community</p> <p>Our monthly roundup of key activities and knowledge to keep the community informed.</p> @@ -137,15 +144,6 @@ <h5><a href="/blog/2020/10/28/cass_changelog_1.html">Read more »</a></h5> </li> - <li class="blog-post"> - <h4><a href="/blog/2020/09/17/cassandra-usage-report-2020.html">Apache Cassandra Usage Report 2020</a></h4> - <p>Posted on September 17, 2020 by the Apache Cassandra Community</p> - <p>Apache Cassandra is the open source NoSQL database for mission critical data. Today the community announced findings from a comprehensive global survey of 901 practitioners on Cassandra usage. It’s the first of what will become an annual survey that provides a baseline understanding of who, how, and why organizations use Cassandra.</p> - - - <h5><a href="/blog/2020/09/17/cassandra-usage-report-2020.html">Read more »</a></h5> - </li> - </ul> diff --git a/content/blog/page2/index.html b/content/blog/page2/index.html index ba51ff2..ec11858 100644 --- a/content/blog/page2/index.html +++ b/content/blog/page2/index.html @@ -102,6 +102,15 @@ <ul class="blog-post-listing"> <li class="blog-post"> + <h4><a href="/blog/2020/09/17/cassandra-usage-report-2020.html">Apache Cassandra Usage Report 2020</a></h4> + <p>Posted on September 17, 2020 by the Apache Cassandra Community</p> + <p>Apache Cassandra is the open source NoSQL database for mission critical data. Today the community announced findings from a comprehensive global survey of 901 practitioners on Cassandra usage. It’s the first of what will become an annual survey that provides a baseline understanding of who, how, and why organizations use Cassandra.</p> + + + <h5><a href="/blog/2020/09/17/cassandra-usage-report-2020.html">Read more »</a></h5> + </li> + + <li class="blog-post"> <h4><a href="/blog/2020/09/03/improving-resiliency.html">Improving Apache Cassandra’s Front Door and Backpressure</a></h4> <p>Posted on September 03, 2020 by the Apache Cassandra Community</p> <p>As part of <a href="https://issues.apache.org/jira/browse/CASSANDRA-15013";>CASSANDRA-15013</a>, we have improved Cassandra’s ability to handle high throughput workloads, while having enough safeguards in place to protect itself from potentially going out of memory. In order to better explain the change we have made, let us understand at a high level, on how an incoming request is processed by Cassandra before the fix, followed by what we changed, and the new relevant configu [...] @@ -137,15 +146,6 @@ <h5><a href="/blog/2019/04/09/benchmarking_streaming.html">Read more »</a></h5> </li> - <li class="blog-post"> - <h4><a href="/blog/2018/12/03/introducing-transient-replication.html">Introducing Transient Replication</a></h4> - <p>Posted on December 03, 2018 by The Apache Cassandra Community</p> - <p>Transient Replication is a new experimental feature soon to be available in 4.0. When enabled, it allows for the creation of keyspaces where replication factor can be specified as a number of copies (full replicas) and temporary copies (transient replicas). Transient replicas retain the data they replicate only long enough for it to be propagated to full replicas, via incremental repair, at which point the data is deleted. Writing to transient replicas can be avoided almost [...] - - - <h5><a href="/blog/2018/12/03/introducing-transient-replication.html">Read more »</a></h5> - </li> - </ul> diff --git a/content/blog/page3/index.html b/content/blog/page3/index.html index 7bc601e..3ce0bf2 100644 --- a/content/blog/page3/index.html +++ b/content/blog/page3/index.html @@ -102,6 +102,15 @@ <ul class="blog-post-listing"> <li class="blog-post"> + <h4><a href="/blog/2018/12/03/introducing-transient-replication.html">Introducing Transient Replication</a></h4> + <p>Posted on December 03, 2018 by The Apache Cassandra Community</p> + <p>Transient Replication is a new experimental feature soon to be available in 4.0. When enabled, it allows for the creation of keyspaces where replication factor can be specified as a number of copies (full replicas) and temporary copies (transient replicas). Transient replicas retain the data they replicate only long enough for it to be propagated to full replicas, via incremental repair, at which point the data is deleted. Writing to transient replicas can be avoided almost [...] + + + <h5><a href="/blog/2018/12/03/introducing-transient-replication.html">Read more »</a></h5> + </li> + + <li class="blog-post"> <h4><a href="/blog/2018/10/29/audit_logging_cassandra.html">Audit Logging in Apache Cassandra 4.0</a></h4> <p>Posted on October 29, 2018 by the Apache Cassandra Community</p> <p>Database audit logging is an industry standard tool for enterprises to diff --git a/content/doc/4.0-beta5/configuration/cassandra_config_file.html b/content/doc/4.0-beta5/configuration/cassandra_config_file.html index c66967b..3f4bdc8 100644 --- a/content/doc/4.0-beta5/configuration/cassandra_config_file.html +++ b/content/doc/4.0-beta5/configuration/cassandra_config_file.html @@ -1246,9 +1246,7 @@ throttling specified by stream_throughput_outbound_megabits_per_sec. Enabling this will reduce the GC pressure on sending and receiving node. When unset, the default is enabled. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically -disabled if internode encryption is enabled. Currently this can be used with -Leveled Compaction. Once CASSANDRA-14586 is fixed other compaction strategies -will benefit as well when used in combination with CASSANDRA-6696.</p> +disabled if internode encryption is enabled.</p> <p><em>Default Value:</em> true</p> </div> <div class="section" id="stream-throughput-outbound-megabits-per-sec"> diff --git a/content/doc/4.0-beta5/cql/definitions.html b/content/doc/4.0-beta5/cql/definitions.html index 4d4d3d1..0f99cfa 100644 --- a/content/doc/4.0-beta5/cql/definitions.html +++ b/content/doc/4.0-beta5/cql/definitions.html @@ -194,8 +194,10 @@ this document suggests otherwise. Also, not everything accepted by the grammar i </div> <div class="section" id="identifiers"> <span id="identifiers-and-keywords"></span><h2>Identifiers and keywords<a class="headerlink" href="#identifiers" title="Permalink to this headline">¶</a></h2> -<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier is a token -matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>.</p> +<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier can be either +unquoted or quoted. The unquoted identifier is a token matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>. +In the case of quoted, the identity can contain non-ASCII characters between the quotation marks, with one exception that +Cassandra does not accept non-ASCII characters, if the quoted identifier is used for keyspace name or table name.</p> <p>A number of such identifiers, like <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> or <code class="docutils literal notranslate"><span class="pre">WITH</span></code>, are <em>keywords</em>. They have a fixed meaning for the language and most are reserved. The list of those keywords can be found in <a class="reference internal" href="appendices.html#appendix-a"><span class="std std-ref">Appendix A: CQL Keywords</span></a>.</p> <p>Identifiers and (unquoted) keywords are case insensitive. Thus <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> is the same than <code class="docutils literal notranslate"><span class="pre">select</span></code> or <code class="docutils literal notranslate"><span class="pre">sElEcT</span></code>, and diff --git a/content/doc/4.0-beta5/getting_started/installing.html b/content/doc/4.0-beta5/getting_started/installing.html index 753db3a..eec4125 100644 --- a/content/doc/4.0-beta5/getting_started/installing.html +++ b/content/doc/4.0-beta5/getting_started/installing.html @@ -188,7 +188,7 @@ verify that you have the correct version of java installed, type <code class="do <li><strong>NOTE</strong>: <em>Experimental</em> support for Java 11 was added in Cassandra 4.0 (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-9608";>CASSANDRA-9608</a>). Running Cassandra on Java 11 is <em>experimental</em>. Do so at your own risk. For more information, see <a class="reference external" href="https://github.com/apache/cassandra/blob/trunk/NEWS.txt";>NEWS.txt</a>.</li> -<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 2.7</a> or Python 3.6+. To verify that you have +<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 3.6+</a> or Python 2.7 (support deprecated). To verify that you have the correct version of Python installed, type <code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">--version</span></code>.</li> </ul> </div> diff --git a/content/doc/4.0-beta5/new/streaming.html b/content/doc/4.0-beta5/new/streaming.html index 5eac819..57a8650 100644 --- a/content/doc/4.0-beta5/new/streaming.html +++ b/content/doc/4.0-beta5/new/streaming.html @@ -196,7 +196,8 @@ <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">stream_entire_sstables</span><span class="p">:</span> <span class="n">true</span> </pre></div> </div> -<p>By default zero copy streaming is enabled.</p> +<p>It is enabled by default.</p> +<p>This feature is automatically disabled if internode encryption is enabled.</p> </div> <div class="section" id="sstables-eligible-for-zero-copy-streaming"> <h3>SSTables Eligible for Zero Copy Streaming<a class="headerlink" href="#sstables-eligible-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> @@ -205,7 +206,12 @@ <div class="section" id="benefits-of-zero-copy-streaming"> <h3>Benefits of Zero Copy Streaming<a class="headerlink" href="#benefits-of-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> <p>When enabled, it permits Cassandra to zero-copy stream entire eligible SSTables between nodes, including every component. This speeds up the network transfer significantly subject to throttling specified by <code class="docutils literal notranslate"><span class="pre">stream_throughput_outbound_megabits_per_sec</span></code>.</p> -<p>Enabling this will reduce the GC pressure on sending and receiving node. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically disabled if internode encryption is enabled. Currently this can be used with Leveled Compaction.</p> +<p>Enabling zero copy streaming also reduces the GC pressure on the sending and receiving nodes.</p> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">While this feature tries to keep the disks balanced, it cannot guarantee it. +For instance, it is expected that some of the SSTables do not fit entirely in their disk boundaries, when bootstraping a new node having multiple data directoris.</p> +</div> </div> <div class="section" id="configuring-for-zero-copy-streaming"> <h3>Configuring for Zero Copy Streaming<a class="headerlink" href="#configuring-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> diff --git a/content/doc/4.0-beta5/searchindex.js b/content/doc/4.0-beta5/searchindex.js index 38b03d8..9b32e61 100644 --- a/content/doc/4.0-beta5/searchindex.js +++ b/content/doc/4.0-beta5/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file +Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file diff --git a/content/doc/4.0-beta5/tools/cqlsh.html b/content/doc/4.0-beta5/tools/cqlsh.html index 0a1cc0f..e1551d1 100644 --- a/content/doc/4.0-beta5/tools/cqlsh.html +++ b/content/doc/4.0-beta5/tools/cqlsh.html @@ -172,7 +172,7 @@ with every Cassandra package, and can be found in the bin/ directory alongside t the Python native protocol driver, and connects to the single node specified on the command line.</p> <div class="section" id="compatibility"> <h2>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline">¶</a></h2> -<p>cqlsh is compatible with Python 2.7.</p> +<p>cqlsh is compatible with Python 3.6+ (and 2.7, deprecated).</p> <p>In general, a given version of cqlsh is only guaranteed to work with the version of Cassandra that it was released with. In some cases, cqlsh make work with older or newer versions of Cassandra, but this is not officially supported.</p> </div> @@ -210,7 +210,7 @@ can also view the latest version of <a class="reference external" href="https:// <dt><code class="docutils literal notranslate"><span class="pre">--no-color</span></code></dt> <dd>Disable color output</dd> <dt><code class="docutils literal notranslate"><span class="pre">--browser</span></code></dt> -<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/2/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. +<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/3/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. <code class="docutils literal notranslate"><span class="pre">/usr/bin/google-chrome-stable</span> <span class="pre">%s</span></code>).</dd> <dt><code class="docutils literal notranslate"><span class="pre">--ssl</span></code></dt> <dd>Use SSL when connecting to Cassandra</dd> diff --git a/content/doc/4.0-beta5/tools/nodetool/import.html b/content/doc/4.0-beta5/tools/nodetool/import.html index 0fdb6b5..502bc7d 100644 --- a/content/doc/4.0-beta5/tools/nodetool/import.html +++ b/content/doc/4.0-beta5/tools/nodetool/import.html @@ -162,9 +162,9 @@ <span class="p">[(</span><span class="o">-</span><span class="n">pwf</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">password</span><span class="o">-</span><span class="n">file</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">u</span> <span class="o"><</span><span class="n">username</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">username</span> <span class="o"><</span><span class="n">username</span><span class="o">></span><span class="p">)]</span> <span class="kn">import</span> <span class="p">[(</span><span class="o">-</span><span class="n">c</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">e</span> <span class="o">|</span> <span class="o">--</span><span class="n">extended</span><span class="o">-</span><span class= [...] - <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">q</span> <span class="o">|</span> <span class="o">--</span><span class="n">quick</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">r</s [...] - <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">v</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">verify</span><span class="p">)]</span> <span class="p">[</s [...] - <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> + <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">p</span> <span class="o">|</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span><span class="p">)]</span> <span class="p">[(< [...] + <span class="p">[(</span><span class="o">-</span><span class="n">r</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">repaired</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p"> [...] + <span class="o"><</span><span class="n">keyspace</span><span class="o">></span> <span class="o"><</span><span class="n">table</span><span class="o">></span> <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> <span class="n">OPTIONS</span> <span class="o">-</span><span class="n">c</span><span class="p">,</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span> @@ -182,6 +182,9 @@ <span class="o">-</span><span class="n">p</span> <span class="o"><</span><span class="n">port</span><span class="o">></span><span class="p">,</span> <span class="o">--</span><span class="n">port</span> <span class="o"><</span><span class="n">port</span><span class="o">></span> <span class="n">Remote</span> <span class="n">jmx</span> <span class="n">agent</span> <span class="n">port</span> <span class="n">number</span> + <span class="o">-</span><span class="n">p</span><span class="p">,</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span> + <span class="n">Copy</span> <span class="n">data</span> <span class="kn">from</span> <span class="nn">source</span> <span class="n">directories</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">moving</span> <span class="n">them</span> + <span class="o">-</span><span class="n">pp</span><span class="p">,</span> <span class="o">--</span><span class="nb">print</span><span class="o">-</span><span class="n">port</span> <span class="n">Operate</span> <span class="ow">in</span> <span class="mf">4.0</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">hosts</span> <span class="n">disambiguated</span> <span class="n">by</span> <span class="n">port</span> <span class="n">number</span> diff --git a/content/doc/latest/configuration/cassandra_config_file.html b/content/doc/latest/configuration/cassandra_config_file.html index 1385261..868ba27 100644 --- a/content/doc/latest/configuration/cassandra_config_file.html +++ b/content/doc/latest/configuration/cassandra_config_file.html @@ -1246,9 +1246,7 @@ throttling specified by stream_throughput_outbound_megabits_per_sec. Enabling this will reduce the GC pressure on sending and receiving node. When unset, the default is enabled. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically -disabled if internode encryption is enabled. Currently this can be used with -Leveled Compaction. Once CASSANDRA-14586 is fixed other compaction strategies -will benefit as well when used in combination with CASSANDRA-6696.</p> +disabled if internode encryption is enabled.</p> <p><em>Default Value:</em> true</p> </div> <div class="section" id="stream-throughput-outbound-megabits-per-sec"> diff --git a/content/doc/latest/cql/definitions.html b/content/doc/latest/cql/definitions.html index 16c3568..52350f4 100644 --- a/content/doc/latest/cql/definitions.html +++ b/content/doc/latest/cql/definitions.html @@ -194,8 +194,10 @@ this document suggests otherwise. Also, not everything accepted by the grammar i </div> <div class="section" id="identifiers"> <span id="identifiers-and-keywords"></span><h2>Identifiers and keywords<a class="headerlink" href="#identifiers" title="Permalink to this headline">¶</a></h2> -<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier is a token -matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>.</p> +<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier can be either +unquoted or quoted. The unquoted identifier is a token matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>. +In the case of quoted, the identity can contain non-ASCII characters between the quotation marks, with one exception that +Cassandra does not accept non-ASCII characters, if the quoted identifier is used for keyspace name or table name.</p> <p>A number of such identifiers, like <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> or <code class="docutils literal notranslate"><span class="pre">WITH</span></code>, are <em>keywords</em>. They have a fixed meaning for the language and most are reserved. The list of those keywords can be found in <a class="reference internal" href="appendices.html#appendix-a"><span class="std std-ref">Appendix A: CQL Keywords</span></a>.</p> <p>Identifiers and (unquoted) keywords are case insensitive. Thus <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> is the same than <code class="docutils literal notranslate"><span class="pre">select</span></code> or <code class="docutils literal notranslate"><span class="pre">sElEcT</span></code>, and diff --git a/content/doc/latest/getting_started/installing.html b/content/doc/latest/getting_started/installing.html index 63db907..729c61c 100644 --- a/content/doc/latest/getting_started/installing.html +++ b/content/doc/latest/getting_started/installing.html @@ -188,7 +188,7 @@ verify that you have the correct version of java installed, type <code class="do <li><strong>NOTE</strong>: <em>Experimental</em> support for Java 11 was added in Cassandra 4.0 (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-9608";>CASSANDRA-9608</a>). Running Cassandra on Java 11 is <em>experimental</em>. Do so at your own risk. For more information, see <a class="reference external" href="https://github.com/apache/cassandra/blob/trunk/NEWS.txt";>NEWS.txt</a>.</li> -<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 2.7</a> or Python 3.6+. To verify that you have +<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 3.6+</a> or Python 2.7 (support deprecated). To verify that you have the correct version of Python installed, type <code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">--version</span></code>.</li> </ul> </div> diff --git a/content/doc/latest/new/streaming.html b/content/doc/latest/new/streaming.html index ccf2788..a727251 100644 --- a/content/doc/latest/new/streaming.html +++ b/content/doc/latest/new/streaming.html @@ -196,7 +196,8 @@ <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">stream_entire_sstables</span><span class="p">:</span> <span class="n">true</span> </pre></div> </div> -<p>By default zero copy streaming is enabled.</p> +<p>It is enabled by default.</p> +<p>This feature is automatically disabled if internode encryption is enabled.</p> </div> <div class="section" id="sstables-eligible-for-zero-copy-streaming"> <h3>SSTables Eligible for Zero Copy Streaming<a class="headerlink" href="#sstables-eligible-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> @@ -205,7 +206,12 @@ <div class="section" id="benefits-of-zero-copy-streaming"> <h3>Benefits of Zero Copy Streaming<a class="headerlink" href="#benefits-of-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> <p>When enabled, it permits Cassandra to zero-copy stream entire eligible SSTables between nodes, including every component. This speeds up the network transfer significantly subject to throttling specified by <code class="docutils literal notranslate"><span class="pre">stream_throughput_outbound_megabits_per_sec</span></code>.</p> -<p>Enabling this will reduce the GC pressure on sending and receiving node. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically disabled if internode encryption is enabled. Currently this can be used with Leveled Compaction.</p> +<p>Enabling zero copy streaming also reduces the GC pressure on the sending and receiving nodes.</p> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">While this feature tries to keep the disks balanced, it cannot guarantee it. +For instance, it is expected that some of the SSTables do not fit entirely in their disk boundaries, when bootstraping a new node having multiple data directoris.</p> +</div> </div> <div class="section" id="configuring-for-zero-copy-streaming"> <h3>Configuring for Zero Copy Streaming<a class="headerlink" href="#configuring-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> diff --git a/content/doc/latest/searchindex.js b/content/doc/latest/searchindex.js index 38b03d8..9b32e61 100644 --- a/content/doc/latest/searchindex.js +++ b/content/doc/latest/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file +Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file diff --git a/content/doc/latest/tools/cqlsh.html b/content/doc/latest/tools/cqlsh.html index 7050741..7614232 100644 --- a/content/doc/latest/tools/cqlsh.html +++ b/content/doc/latest/tools/cqlsh.html @@ -172,7 +172,7 @@ with every Cassandra package, and can be found in the bin/ directory alongside t the Python native protocol driver, and connects to the single node specified on the command line.</p> <div class="section" id="compatibility"> <h2>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline">¶</a></h2> -<p>cqlsh is compatible with Python 2.7.</p> +<p>cqlsh is compatible with Python 3.6+ (and 2.7, deprecated).</p> <p>In general, a given version of cqlsh is only guaranteed to work with the version of Cassandra that it was released with. In some cases, cqlsh make work with older or newer versions of Cassandra, but this is not officially supported.</p> </div> @@ -210,7 +210,7 @@ can also view the latest version of <a class="reference external" href="https:// <dt><code class="docutils literal notranslate"><span class="pre">--no-color</span></code></dt> <dd>Disable color output</dd> <dt><code class="docutils literal notranslate"><span class="pre">--browser</span></code></dt> -<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/2/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. +<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/3/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. <code class="docutils literal notranslate"><span class="pre">/usr/bin/google-chrome-stable</span> <span class="pre">%s</span></code>).</dd> <dt><code class="docutils literal notranslate"><span class="pre">--ssl</span></code></dt> <dd>Use SSL when connecting to Cassandra</dd> diff --git a/content/doc/latest/tools/nodetool/import.html b/content/doc/latest/tools/nodetool/import.html index 181464e..2055431 100644 --- a/content/doc/latest/tools/nodetool/import.html +++ b/content/doc/latest/tools/nodetool/import.html @@ -162,9 +162,9 @@ <span class="p">[(</span><span class="o">-</span><span class="n">pwf</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">password</span><span class="o">-</span><span class="n">file</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">u</span> <span class="o"><</span><span class="n">username</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">username</span> <span class="o"><</span><span class="n">username</span><span class="o">></span><span class="p">)]</span> <span class="kn">import</span> <span class="p">[(</span><span class="o">-</span><span class="n">c</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">e</span> <span class="o">|</span> <span class="o">--</span><span class="n">extended</span><span class="o">-</span><span class= [...] - <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">q</span> <span class="o">|</span> <span class="o">--</span><span class="n">quick</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">r</s [...] - <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">v</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">verify</span><span class="p">)]</span> <span class="p">[</s [...] - <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> + <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">p</span> <span class="o">|</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span><span class="p">)]</span> <span class="p">[(< [...] + <span class="p">[(</span><span class="o">-</span><span class="n">r</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">repaired</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p"> [...] + <span class="o"><</span><span class="n">keyspace</span><span class="o">></span> <span class="o"><</span><span class="n">table</span><span class="o">></span> <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> <span class="n">OPTIONS</span> <span class="o">-</span><span class="n">c</span><span class="p">,</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span> @@ -182,6 +182,9 @@ <span class="o">-</span><span class="n">p</span> <span class="o"><</span><span class="n">port</span><span class="o">></span><span class="p">,</span> <span class="o">--</span><span class="n">port</span> <span class="o"><</span><span class="n">port</span><span class="o">></span> <span class="n">Remote</span> <span class="n">jmx</span> <span class="n">agent</span> <span class="n">port</span> <span class="n">number</span> + <span class="o">-</span><span class="n">p</span><span class="p">,</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span> + <span class="n">Copy</span> <span class="n">data</span> <span class="kn">from</span> <span class="nn">source</span> <span class="n">directories</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">moving</span> <span class="n">them</span> + <span class="o">-</span><span class="n">pp</span><span class="p">,</span> <span class="o">--</span><span class="nb">print</span><span class="o">-</span><span class="n">port</span> <span class="n">Operate</span> <span class="ow">in</span> <span class="mf">4.0</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">hosts</span> <span class="n">disambiguated</span> <span class="n">by</span> <span class="n">port</span> <span class="n">number</span> diff --git a/content/feed.xml b/content/feed.xml index 8750b23..3623e2c 100644 --- a/content/feed.xml +++ b/content/feed.xml @@ -1,5 +1,31 @@ -<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom"; ><generator uri="https://jekyllrb.com/"; version="3.4.3">Jekyll</generator><link href="http://cassandra.apache.org/feed.xml"; rel="self" type="application/atom+xml" /><link href="http://cassandra.apache.org/"; rel="alternate" type="text/html" /><updated>2021-02-16T11:07:01+00:00</updated><id>http://cassandra.apache.org/</id><title type="html">Apache Cassandra Website</title><subtitle>The Apache Cassandra databas [...] -</subtitle><entry><title type="html">Apache Cassandra Changelog #4 | February 2021</title><link href="http://cassandra.apache.org/blog/2021/02/11/cass-changelog_4.html"; rel="alternate" type="text/html" title="Apache Cassandra Changelog #4 | February 2021" /><published>2021-02-11T00:00:00+00:00</published><updated>2021-02-11T00:00:00+00:00</updated><id>http://cassandra.apache.org/blog/2021/02/11/cass-changelog_4</id><content type="html" xml:base="http://cassandra.apache.org/blog/2021/02/1 [...] +<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom"; ><generator uri="https://jekyllrb.com/"; version="3.4.3">Jekyll</generator><link href="http://cassandra.apache.org/feed.xml"; rel="self" type="application/atom+xml" /><link href="http://cassandra.apache.org/"; rel="alternate" type="text/html" /><updated>2021-03-10T12:46:20+00:00</updated><id>http://cassandra.apache.org/</id><title type="html">Apache Cassandra Website</title><subtitle>The Apache Cassandra databas [...] +</subtitle><entry><title type="html">Join Apache Cassandra for Google Summer of Code 2021</title><link href="http://cassandra.apache.org/blog/2021/03/10/join_cassandra_gsoc_2021.html"; rel="alternate" type="text/html" title="Join Apache Cassandra for Google Summer of Code 2021" /><published>2021-03-10T00:00:00+00:00</published><updated>2021-03-10T00:00:00+00:00</updated><id>http://cassandra.apache.org/blog/2021/03/10/join_cassandra_gsoc_2021</id><content type="html" xml:base="http://cassa [...] + <img src="https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png" style="width:40%;" /> +</p> + +<p>I have been involved with Apache Cassandra for the past eight years, and I’m very proud to mention that my open source journey started a little more than a decade ago during my participation at the Google Summer of Code (GSoC).</p> + +<p>GSoC is a program sponsored by Google to promote open source development, where post-secondary students submit project proposals to open source organizations. Selected students receive community mentorship and a stipend from Google to work on the project for ten weeks during the northern hemisphere summer. Over 16,000 students from 111 countries have participated so far! More details about the program can be found on the <a href="https://summerofcode.withgoogle.com/" [...] + +<p>The Apache Software Foundation (ASF) has been a <a href="https://community.apache.org/gsoc.html">GSoC mentor organization</a> since the beginning of the program 17 years ago. The ASF acts as an “umbrella” organization, which means that students can submit project proposals to any subproject within the ASF. Apache Cassandra mentored a successful GSoC project in <a href="https://summerofcode.withgoogle.com/archive/2016/projects/5429448547500032/" [...] + +<h3 id="how-to-get-involved">How to Get Involved</h3> + +<h4 id="getting-started">Getting Started</h4> + +<p>The best way to get started if you’re new to Apache Cassandra is to get acquainted by reading the <a href="https://cassandra.apache.org/doc/latest/">documentation</a> and setting up a local <a href="https://cassandra.apache.org/doc/latest/development/ide.html">development environment</a>. Play around with a locally running instance via <a href="https://cassandra.apache.org/doc/latest/tools/cqlsh.html?highlight=cqlsh">cq [...] + +<h4 id="gsoc-project-ideas">GSoC Project Ideas</h4> + +<p>Once you have a basic understanding of how the project works, browse the <a href="https://issues.apache.org/jira/browse/CASSANDRA-16456?jql=labels%20%3D%20gsoc2021%20AND%20project%20%3D%20Cassandra">GSoC ideas list</a> to select ideas that you are interested in working on. Browse the <a href="https://github.com/apache/cassandra/">codebase</a> to identify components related to the idea you picked. You are welcome to propose other projec [...] + +<h4 id="writing-a-proposal">Writing a proposal</h4> + +<p>Write a message on the JIRA ticket introducing yourself and demonstrating your interest in working on that particular idea. Sketch a quick proposal on how you plan to tackle the problem and share it with the community for feedback. If you don’t know where to start, don’t hesitate to ask for help!</p> + +<h4 id="useful-resources">Useful Resources</h4> + +<p>There are many good resources on the web on preparing for GSoC, particularly the <a href="https://community.apache.org/gsoc.html">ASF GSoC Guide</a> and the Python community notes on <a href="https://wiki.python.org/moin/SummerOfCode/Expectations">GSoC expectations</a>. The best GSoC students are self-motivated and proactive, and following the tips above should increase your chances of getting selected and delivering your project succe [...] <p><img src="https://cassandra.apache.org/img/changelog_header.jpg" alt="Apache Cassandra Changelog Header" /></p> @@ -705,136 +731,4 @@ CREATE TABLE testing.test ( <p><strong>Risk Reduction:</strong> There is a great reduction in the risk due to Zero Copy Streaming as well. Since a Cluster’s recovery mainly depends on the streaming speed, Cassandra clusters with failed nodes will be able to recover much more quickly (5x faster). This means the window of vulnerability is reduced significantly, in some situations down to few minutes.</p> -<p>Finally, a benefit that we generally don’t talk about is the environmental benefit of this change. Zero Copy Streaming enables us to move data very quickly through the cluster. It objectively reduces the number and sizes of instances that are used to build Cassandra cluster. As a result not only does it reduce Cassandra’s TCO (Total Cost of Ownership), it also helps the environment by consuming fewer resources!</p></content><author><name>The Apache Cassandra Community</nam [...] - -<p>This results in a savings in disk space, CPU, and IO. By deleting data as soon as it is no longer needed, transient replicas require only a fraction of the disk space of a full replica. By not having to store the data indefinitely, the CPU and IO required for compaction is reduced, and read queries are faster as they have less data to process.</p> - -<p>So what are the benefits of not actually keeping a full copy of the data? Well, for some installations and use cases, transient replicas can be almost free if <a href="https://en.wikipedia.org/wiki/Consistency_model#Monotonic_Read_Consistency">monotonic reads</a> are disabled. In future releases where monotonic reads are supported with Transient Replication, enabling monotonic reads would reduce the savings in CPU and IO, but even then they should still be [...] - -<p>Transient Replication is designed to be transparent to applications:</p> - -<ul> - <li>Consistency levels continue to produce the same results for queries.</li> - <li>The number of replicas that can be lost before data loss occurs is unchanged.</li> - <li>The number of replicas that can be unavailable before some queries start to timeout or return unavailable is unchanged (with the exception of ONE).</li> -</ul> - -<p>With Transient Replication, you can go from 3 replicas to 5 replicas, two of which are transient, without adding any hardware.</p> - -<p>If you are running an active-passive 2 DC setup with 3 replicas in each DC, you can make one replica in each DC transient and still have four full copies of the data in total.</p> - -<h2 id="feature-support">Feature support</h2> - -<p>Transient Replication is not intended to fully replace Cassandra’s existing approach to replication. There are features that currently don’t work with transiently replicated keyspaces and features that are unlikely ever to work with them.</p> - -<p>You can have keyspaces with and without Transient Replication enabled in the same cluster, so it is possible to use Transient Replication for just the use cases that are a good fit for the currently available functionality.</p> - -<h3 id="currently-unsupported-but-coming">Currently unsupported but coming:</h3> - -<ul> - <li>Monotonic reads</li> - <li>Batch log</li> - <li>LWT</li> - <li>Counters</li> -</ul> - -<h3 id="will-never-be-supported">Will never be supported:</h3> - -<ul> - <li>Secondary indexes</li> - <li>Materialized views</li> -</ul> - -<h2 id="how-transient-replication-works">How Transient Replication works</h2> - -<h3 id="overview">Overview</h3> - -<p>Transient replication extends Cassandra’s existing consistent hashing algorithm to designate some replicas of a point or range on the consistent hash ring as transient and some as full. The following image depicts a consistent hash ring with three replicas <strong>A</strong>, <strong>B</strong>, and <strong>C</strong>. The replicas are located at tokens 5, 10, 15 respectively. A key <strong><em>k</em></strong> hashes to [...] - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-hash-ring.gif" alt="A consistent hash ring without Transient Replication" title="A consistent hash ring without Rransient Replication" /></p> - -<p>Replicas are selected by walking the ring clockwise starting at the point on the ring the key hashes to. At RF=3, the replicas of key <strong><em>k **</em>are **A</strong>, <strong>B</strong>, <strong>C</strong>. -With Transient Replication, the last N replicas (where N is the configured number of transient replicas) found while walking the ring are designated as transient.</p> - -<p>There are no nodes designated as transient replicas or full replicas. All nodes will fully replicate some ranges on the ring and transiently replicate others.</p> - -<p>The following image depicts a consistent hash ring at RF=3/1 (three replicas, one of which is transient). The replicas of <strong><em>k</em></strong> are still <strong>A</strong>, <strong>B</strong>, and <strong>C</strong>, but <strong>C</strong> is now transiently replicating <strong><em>k</em></strong>.</p> - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-hash-ring-with-transient-replica.gif" alt="A consistent hash ring with Transient Replication" title="A consistent hash ring with Transient Replication" /></p> - -<p>Normally all replicas of a range receive all writes for that range, as depicted in the following image.</p> - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-regular-write.gif" alt="Normal write behavior" title="Normal write behavior" /></p> - -<p>Transient replicas do not receive writes in the normal write path.</p> - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-transient-write.gif" alt="Transient write behavior" title="Transient write behavior" /></p> - -<p>If sufficient full replicas are unavailable, transient replicas will receive writes.</p> - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-transient-write-down-node.gif" alt="Transient write with unavailable node" title="Transient write with unavailable node" /></p> - -<p>This optimization, which is possible with Transient Replication, is called Cheap Quorums. This minimizes the amount of work that transient replicas have to do at write time, and reduces the amount of background compaction they will have to do.</p> - -<p><strong>Cheap Quorums and monotonic reads:</strong> Cheap Quorums may end up being incompatible with an initial implementation of monotonic reads, and operators will be able to make a conscious trade off between performance and monotonic reads.</p> - -<h3 id="rapid-write-protection">Rapid write protection</h3> - -<p>In keyspaces utilizing Transient Replication, writes are sent to every full replica and enough transient replicas to meet the requested consistency level (to make up for unavailable full replicas). In addition, enough transient replicas are selected to reach a quorum in every datacenter, though unless the consistency level requires it, the write will be acknowledged without ensuring all have been delivered.</p> - -<p>Because not all replicas are sent the write, it’s possible that insufficient replicas will respond, causing timeouts. To prevent this, we implement rapid write protection, similar to rapid read protection, that sends writes to additional replicas if sufficient acknowledgements to meet the consistency level are not received promptly.</p> - -<p>The following animation shows rapid write protection in action.</p> - -<p><img src="/img/blog-post-introducing-transient-replication/diagram-rapid-write-protection.gif" alt="Animation of rapid write protection preventing a write timeout" title="Rapid write protection preventing a write timeout" /></p> - -<p>Rapid write protection is configured similarly to rapid read protection using the table option <code class="highlighter-rouge">additional_write_policy</code>. The policy determines how long to wait for acknowledgements before sending additional mutations. The default is to wait for P99 of the observed latency.</p> - -<h3 id="incremental-repair">Incremental repair</h3> - -<p>Incremental repair is used to clean up transient data at transient replicas and propagate it to full replicas.</p> - -<p>When incremental repair occurs transient replicas stream out transient data, but don’t receive any. Anti-compaction is used to separate transient and fully replicated data so that only fully replicated data is retained once incremental repair completes.</p> - -<p>The result of running an incremental repair is that all full replicas for a range are synchronized and can be used interchangeably to retrieve the repaired data set for a query.</p> - -<h3 id="read-path">Read path</h3> - -<p>Reads must always include at least one full replica and can include as many replicas (transient or full) as necessary to achieve the desired consistency level. At least one full replica is required in order to provide the data not available at transient replicas, but it doesn’t matter which full replica is picked because incremental repair synchronizes the repaired data set across full replicas.</p> - -<p>Reads at transient replicas are faster than reads at full replicas because reads at transient replicas are unlikely to return any results if monotonic reads are disabled, and they haven’t been receiving writes.</p> - -<h2 id="creating-keyspaces-with-transient-replication">Creating keyspaces with Transient Replication</h2> - -<p>Transient Replication is supported by SimpleStrategy and NetworkTopologyStrategy. When specifying the replication factor, you can specify the number of transient replicas in addition to the total number of replicas (including transient replicas). The syntax for a replication factor of 3 replicas total with one of them being transient would be “3/1”.</p> - -<div class="highlighter-rouge"><pre class="highlight"><code>ALTER KEYSPACE foo WITH REPLICATION = {'class' : 'NetworkTopologyStrategy', 'DC1' : '3/1'}; -ALTER KEYSPACE foo WITH REPLICATION = {'class' : 'SimpleStrategy', 'replication_factor' : '3/1'}; -</code></pre> -</div> - -<p>Monotonic reads are not supported with Transient Replication in 4.0, so any existing tables in the keyspace must have monotonic reads disabled by setting <code class="highlighter-rouge">read_repair = 'NONE'</code></p> - -<p>Once the keyspace has been altered, you will need to run incremental repair and then nodetool cleanup to ensure transient data is cleaned up.</p> - -<h2 id="operational-matters">Operational matters</h2> - -<p>Transient replication requires rolling incremental repair to be run regularly in order to move data from transient replicas to full replicas. By default transient replicas will receive 1% of writes for transiently replicated ranges due to rapid write protection. If a node is down for an extended period of time, its transient replicas will receive additional write load and that data should be cleaned up using incremental repair. Running incremental repair regularly will ensure th [...] - -<p>It’s also a good idea to run a small number of vnodes with transient replication so that when a node goes down the load is spread out over several other nodes that transiently replicate that range. Larges numbers of vnodes are known to be problematic, so it’s best to start with a cluster that is already close to or at its maximum size so that a small number of vnodes will be sufficient. If you intend to grow the cluster in the future, you will need to be cognizant of how this wi [...] - -<p>While the odds of any data loss should multiple nodes be permanently lost remain the same with transient replication, the magnitude of potential data loss does not. With 3/1 transient replication the permanent loss of two nodes could result in the loss of the entirety of the repaired data set. If you are running a multi-DC setup with a high level of replication such as 2 DCs, with 3/1 replicas in each, then you will have 4 full copies total and the added risk of transient replic [...] - -<h2 id="experimental-features">Experimental features</h2> - -<p>Experimental features are a relatively new idea for Apache Cassandra. Although we recently voted to make materialized views an experimental feature retroactively, Transient Replication is the first experimental feature to be introduced as such.</p> - -<p>The goal of introducing experimental features is to allow for incremental development across multiple releases. In the case of Transient Replication, we can avoid a giant code drop that heavily modifies the code base, and the associated risks with incorporating a new feature that way.</p> - -<p>What it means for a feature to be experimental doesn’t have a set definition, but for Transient Replication it’s intended to set expectations. As of 4.0, Transient Replication’s intended audience is expert operators of Cassandra with the ability to write the book on how to safely deploy Transient Replication, debug any issues that result, and if necessary contribute code back to address problems as they are discovered.</p> - -<p>It’s expected that the feature set for Transient Replication will not change in minor updates to 4.0, but eventually it should be ready for use by a wider audience.</p> - -<h2 id="next-steps-for-transient-replication">Next steps for Transient Replication</h2> - -<p>If increasing availability or saving on capacity sounds good to you, then you can help make transient replication production-ready by testing it out or even deploying it. Experience and feedback from the community is one the of the things that will drive transient replication bug fixing and development.</p></content><author><name>The Apache Cassandra Community</name></author><summary type="html">Transient Replication is a new experimental feature soon to be available in 4. [...] \ No newline at end of file +<p>Finally, a benefit that we generally don’t talk about is the environmental benefit of this change. Zero Copy Streaming enables us to move data very quickly through the cluster. It objectively reduces the number and sizes of instances that are used to build Cassandra cluster. As a result not only does it reduce Cassandra’s TCO (Total Cost of Ownership), it also helps the environment by consuming fewer resources!</p></content><author><name>The Apache Cassandra Community</nam [...] \ No newline at end of file diff --git a/src/doc/4.0-beta5/_sources/configuration/cassandra_config_file.rst.txt b/src/doc/4.0-beta5/_sources/configuration/cassandra_config_file.rst.txt index 45dce45..a2a2dec 100644 --- a/src/doc/4.0-beta5/_sources/configuration/cassandra_config_file.rst.txt +++ b/src/doc/4.0-beta5/_sources/configuration/cassandra_config_file.rst.txt @@ -1358,9 +1358,7 @@ throttling specified by stream_throughput_outbound_megabits_per_sec. Enabling this will reduce the GC pressure on sending and receiving node. When unset, the default is enabled. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically -disabled if internode encryption is enabled. Currently this can be used with -Leveled Compaction. Once CASSANDRA-14586 is fixed other compaction strategies -will benefit as well when used in combination with CASSANDRA-6696. +disabled if internode encryption is enabled. *Default Value:* true diff --git a/src/doc/4.0-beta5/_sources/cql/definitions.rst.txt b/src/doc/4.0-beta5/_sources/cql/definitions.rst.txt index 3df6f20..8ccb630 100644 --- a/src/doc/4.0-beta5/_sources/cql/definitions.rst.txt +++ b/src/doc/4.0-beta5/_sources/cql/definitions.rst.txt @@ -46,8 +46,10 @@ To aid in specifying the CQL syntax, we will use the following conventions in th Identifiers and keywords ^^^^^^^^^^^^^^^^^^^^^^^^ -The CQL language uses *identifiers* (or *names*) to identify tables, columns and other objects. An identifier is a token -matching the regular expression ``[a-zA-Z][a-zA-Z0-9_]*``. +The CQL language uses *identifiers* (or *names*) to identify tables, columns and other objects. An identifier can be either +unquoted or quoted. The unquoted identifier is a token matching the regular expression ``[a-zA-Z][a-zA-Z0-9_]*``. +In the case of quoted, the identity can contain non-ASCII characters between the quotation marks, with one exception that +Cassandra does not accept non-ASCII characters, if the quoted identifier is used for keyspace name or table name. A number of such identifiers, like ``SELECT`` or ``WITH``, are *keywords*. They have a fixed meaning for the language and most are reserved. The list of those keywords can be found in :ref:`appendix-A`. diff --git a/src/doc/4.0-beta5/_sources/getting_started/installing.rst.txt b/src/doc/4.0-beta5/_sources/getting_started/installing.rst.txt index 5c5239d..568549f 100644 --- a/src/doc/4.0-beta5/_sources/getting_started/installing.rst.txt +++ b/src/doc/4.0-beta5/_sources/getting_started/installing.rst.txt @@ -43,7 +43,7 @@ Prerequisites - **NOTE**: *Experimental* support for Java 11 was added in Cassandra 4.0 (`CASSANDRA-9608 <https://issues.apache.org/jira/browse/CASSANDRA-9608>`__). Running Cassandra on Java 11 is *experimental*. Do so at your own risk. For more information, see `NEWS.txt <https://github.com/apache/cassandra/blob/trunk/NEWS.txt>`__. -- For using cqlsh, the latest version of `Python 2.7 <https://www.python.org/downloads/>`__ or Python 3.6+. To verify that you have +- For using cqlsh, the latest version of `Python 3.6+ <https://www.python.org/downloads/>`__ or Python 2.7 (support deprecated). To verify that you have the correct version of Python installed, type ``python --version``. Choosing an installation method diff --git a/src/doc/4.0-beta5/_sources/new/streaming.rst.txt b/src/doc/4.0-beta5/_sources/new/streaming.rst.txt index 1807eb4..849b43d 100644 --- a/src/doc/4.0-beta5/_sources/new/streaming.rst.txt +++ b/src/doc/4.0-beta5/_sources/new/streaming.rst.txt @@ -50,20 +50,25 @@ Zero copy streaming is enabled by setting the following setting in ``cassandra.y stream_entire_sstables: true -By default zero copy streaming is enabled. +It is enabled by default. + +This feature is automatically disabled if internode encryption is enabled. SSTables Eligible for Zero Copy Streaming ***************************************** Zero copy streaming is used if all partitions within the SSTable need to be transmitted. This is common when using ``LeveledCompactionStrategy`` or when partitioning SSTables by token range has been enabled. All partition keys in the SSTables are iterated over to determine the eligibility for Zero Copy streaming. Benefits of Zero Copy Streaming -******************************** +******************************* When enabled, it permits Cassandra to zero-copy stream entire eligible SSTables between nodes, including every component. This speeds up the network transfer significantly subject to throttling specified by ``stream_throughput_outbound_megabits_per_sec``. -Enabling this will reduce the GC pressure on sending and receiving node. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically disabled if internode encryption is enabled. Currently this can be used with Leveled Compaction. +Enabling zero copy streaming also reduces the GC pressure on the sending and receiving nodes. + +.. note:: While this feature tries to keep the disks balanced, it cannot guarantee it. + For instance, it is expected that some of the SSTables do not fit entirely in their disk boundaries, when bootstraping a new node having multiple data directoris. Configuring for Zero Copy Streaming -************************************ +*********************************** Throttling would reduce the streaming speed. The ``stream_throughput_outbound_megabits_per_sec`` throttles all outbound streaming file transfers on a node to the given total throughput in Mbps. When unset, the default is 200 Mbps or 25 MB/s. :: diff --git a/src/doc/4.0-beta5/_sources/tools/cqlsh.rst.txt b/src/doc/4.0-beta5/_sources/tools/cqlsh.rst.txt index b800b88..2f47554 100644 --- a/src/doc/4.0-beta5/_sources/tools/cqlsh.rst.txt +++ b/src/doc/4.0-beta5/_sources/tools/cqlsh.rst.txt @@ -13,7 +13,7 @@ the Python native protocol driver, and connects to the single node specified on Compatibility ^^^^^^^^^^^^^ -cqlsh is compatible with Python 2.7. +cqlsh is compatible with Python 3.6+ (and 2.7, deprecated). In general, a given version of cqlsh is only guaranteed to work with the version of Cassandra that it was released with. In some cases, cqlsh make work with older or newer versions of Cassandra, but this is not officially supported. @@ -65,7 +65,7 @@ Options: ``--browser`` Specify the browser to use for displaying cqlsh help. This can be one of the `supported browser names - <https://docs.python.org/2/library/webbrowser.html>`__ (e.g. ``firefox``) or a browser path followed by ``%s`` (e.g. + <https://docs.python.org/3/library/webbrowser.html>`__ (e.g. ``firefox``) or a browser path followed by ``%s`` (e.g. ``/usr/bin/google-chrome-stable %s``). ``--ssl`` diff --git a/src/doc/4.0-beta5/configuration/cassandra_config_file.html b/src/doc/4.0-beta5/configuration/cassandra_config_file.html index 15f8676..f784574 100644 --- a/src/doc/4.0-beta5/configuration/cassandra_config_file.html +++ b/src/doc/4.0-beta5/configuration/cassandra_config_file.html @@ -1175,9 +1175,7 @@ throttling specified by stream_throughput_outbound_megabits_per_sec. Enabling this will reduce the GC pressure on sending and receiving node. When unset, the default is enabled. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically -disabled if internode encryption is enabled. Currently this can be used with -Leveled Compaction. Once CASSANDRA-14586 is fixed other compaction strategies -will benefit as well when used in combination with CASSANDRA-6696.</p> +disabled if internode encryption is enabled.</p> <p><em>Default Value:</em> true</p> </div> <div class="section" id="stream-throughput-outbound-megabits-per-sec"> diff --git a/src/doc/4.0-beta5/cql/definitions.html b/src/doc/4.0-beta5/cql/definitions.html index bc14aa3..4433ad9 100644 --- a/src/doc/4.0-beta5/cql/definitions.html +++ b/src/doc/4.0-beta5/cql/definitions.html @@ -126,8 +126,10 @@ this document suggests otherwise. Also, not everything accepted by the grammar i </div> <div class="section" id="identifiers"> <span id="identifiers-and-keywords"></span><h2>Identifiers and keywords<a class="headerlink" href="#identifiers" title="Permalink to this headline">¶</a></h2> -<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier is a token -matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>.</p> +<p>The CQL language uses <em>identifiers</em> (or <em>names</em>) to identify tables, columns and other objects. An identifier can be either +unquoted or quoted. The unquoted identifier is a token matching the regular expression <code class="docutils literal notranslate"><span class="pre">[a-zA-Z][a-zA-Z0-9_]*</span></code>. +In the case of quoted, the identity can contain non-ASCII characters between the quotation marks, with one exception that +Cassandra does not accept non-ASCII characters, if the quoted identifier is used for keyspace name or table name.</p> <p>A number of such identifiers, like <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> or <code class="docutils literal notranslate"><span class="pre">WITH</span></code>, are <em>keywords</em>. They have a fixed meaning for the language and most are reserved. The list of those keywords can be found in <a class="reference internal" href="appendices.html#appendix-a"><span class="std std-ref">Appendix A: CQL Keywords</span></a>.</p> <p>Identifiers and (unquoted) keywords are case insensitive. Thus <code class="docutils literal notranslate"><span class="pre">SELECT</span></code> is the same than <code class="docutils literal notranslate"><span class="pre">select</span></code> or <code class="docutils literal notranslate"><span class="pre">sElEcT</span></code>, and diff --git a/src/doc/4.0-beta5/getting_started/installing.html b/src/doc/4.0-beta5/getting_started/installing.html index a702a23..816a1b4 100644 --- a/src/doc/4.0-beta5/getting_started/installing.html +++ b/src/doc/4.0-beta5/getting_started/installing.html @@ -120,7 +120,7 @@ verify that you have the correct version of java installed, type <code class="do <li><strong>NOTE</strong>: <em>Experimental</em> support for Java 11 was added in Cassandra 4.0 (<a class="reference external" href="https://issues.apache.org/jira/browse/CASSANDRA-9608";>CASSANDRA-9608</a>). Running Cassandra on Java 11 is <em>experimental</em>. Do so at your own risk. For more information, see <a class="reference external" href="https://github.com/apache/cassandra/blob/trunk/NEWS.txt";>NEWS.txt</a>.</li> -<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 2.7</a> or Python 3.6+. To verify that you have +<li>For using cqlsh, the latest version of <a class="reference external" href="https://www.python.org/downloads/";>Python 3.6+</a> or Python 2.7 (support deprecated). To verify that you have the correct version of Python installed, type <code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">--version</span></code>.</li> </ul> </div> diff --git a/src/doc/4.0-beta5/new/streaming.html b/src/doc/4.0-beta5/new/streaming.html index 85bd68f..a47a2de 100644 --- a/src/doc/4.0-beta5/new/streaming.html +++ b/src/doc/4.0-beta5/new/streaming.html @@ -128,7 +128,8 @@ extra-footer: ' <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">stream_entire_sstables</span><span class="p">:</span> <span class="n">true</span> </pre></div> </div> -<p>By default zero copy streaming is enabled.</p> +<p>It is enabled by default.</p> +<p>This feature is automatically disabled if internode encryption is enabled.</p> </div> <div class="section" id="sstables-eligible-for-zero-copy-streaming"> <h3>SSTables Eligible for Zero Copy Streaming<a class="headerlink" href="#sstables-eligible-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> @@ -137,7 +138,12 @@ extra-footer: ' <div class="section" id="benefits-of-zero-copy-streaming"> <h3>Benefits of Zero Copy Streaming<a class="headerlink" href="#benefits-of-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> <p>When enabled, it permits Cassandra to zero-copy stream entire eligible SSTables between nodes, including every component. This speeds up the network transfer significantly subject to throttling specified by <code class="docutils literal notranslate"><span class="pre">stream_throughput_outbound_megabits_per_sec</span></code>.</p> -<p>Enabling this will reduce the GC pressure on sending and receiving node. While this feature tries to keep the disks balanced, it cannot guarantee it. This feature will be automatically disabled if internode encryption is enabled. Currently this can be used with Leveled Compaction.</p> +<p>Enabling zero copy streaming also reduces the GC pressure on the sending and receiving nodes.</p> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">While this feature tries to keep the disks balanced, it cannot guarantee it. +For instance, it is expected that some of the SSTables do not fit entirely in their disk boundaries, when bootstraping a new node having multiple data directoris.</p> +</div> </div> <div class="section" id="configuring-for-zero-copy-streaming"> <h3>Configuring for Zero Copy Streaming<a class="headerlink" href="#configuring-for-zero-copy-streaming" title="Permalink to this headline">¶</a></h3> diff --git a/src/doc/4.0-beta5/searchindex.js b/src/doc/4.0-beta5/searchindex.js index 38b03d8..9b32e61 100644 --- a/src/doc/4.0-beta5/searchindex.js +++ b/src/doc/4.0-beta5/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file +Search.setIndex({docnames:["architecture/dynamo","architecture/guarantees","architecture/index","architecture/overview","architecture/storage_engine","bugs","configuration/cass_cl_archive_file","configuration/cass_env_sh_file","configuration/cass_jvm_options_file","configuration/cass_logback_xml_file","configuration/cass_rackdc_file","configuration/cass_topo_file","configuration/cass_yaml_file","configuration/cassandra_config_file","configuration/index","contactus","cql/appendices","cql/ [...] \ No newline at end of file diff --git a/src/doc/4.0-beta5/tools/cqlsh.html b/src/doc/4.0-beta5/tools/cqlsh.html index 367d3b9..1dcedaa 100644 --- a/src/doc/4.0-beta5/tools/cqlsh.html +++ b/src/doc/4.0-beta5/tools/cqlsh.html @@ -104,7 +104,7 @@ with every Cassandra package, and can be found in the bin/ directory alongside t the Python native protocol driver, and connects to the single node specified on the command line.</p> <div class="section" id="compatibility"> <h2>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline">¶</a></h2> -<p>cqlsh is compatible with Python 2.7.</p> +<p>cqlsh is compatible with Python 3.6+ (and 2.7, deprecated).</p> <p>In general, a given version of cqlsh is only guaranteed to work with the version of Cassandra that it was released with. In some cases, cqlsh make work with older or newer versions of Cassandra, but this is not officially supported.</p> </div> @@ -142,7 +142,7 @@ can also view the latest version of <a class="reference external" href="https:// <dt><code class="docutils literal notranslate"><span class="pre">--no-color</span></code></dt> <dd>Disable color output</dd> <dt><code class="docutils literal notranslate"><span class="pre">--browser</span></code></dt> -<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/2/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. +<dd>Specify the browser to use for displaying cqlsh help. This can be one of the <a class="reference external" href="https://docs.python.org/3/library/webbrowser.html";>supported browser names</a> (e.g. <code class="docutils literal notranslate"><span class="pre">firefox</span></code>) or a browser path followed by <code class="docutils literal notranslate"><span class="pre">%s</span></code> (e.g. <code class="docutils literal notranslate"><span class="pre">/usr/bin/google-chrome-stable</span> <span class="pre">%s</span></code>).</dd> <dt><code class="docutils literal notranslate"><span class="pre">--ssl</span></code></dt> <dd>Use SSL when connecting to Cassandra</dd> diff --git a/src/doc/4.0-beta5/tools/nodetool/import.html b/src/doc/4.0-beta5/tools/nodetool/import.html index 905ce78..1dc1e98 100644 --- a/src/doc/4.0-beta5/tools/nodetool/import.html +++ b/src/doc/4.0-beta5/tools/nodetool/import.html @@ -91,9 +91,9 @@ extra-footer: ' <span class="p">[(</span><span class="o">-</span><span class="n">pwf</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">password</span><span class="o">-</span><span class="n">file</span> <span class="o"><</span><span class="n">passwordFilePath</span><span class="o">></span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">u</span> <span class="o"><</span><span class="n">username</span><span class="o">></span> <span class="o">|</span> <span class="o">--</span><span class="n">username</span> <span class="o"><</span><span class="n">username</span><span class="o">></span><span class="p">)]</span> <span class="kn">import</span> <span class="p">[(</span><span class="o">-</span><span class="n">c</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">e</span> <span class="o">|</span> <span class="o">--</span><span class="n">extended</span><span class="o">-</span><span class= [...] - <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">q</span> <span class="o">|</span> <span class="o">--</span><span class="n">quick</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">r</s [...] - <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">v</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">verify</span><span class="p">)]</span> <span class="p">[</s [...] - <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> + <span class="p">[(</span><span class="o">-</span><span class="n">l</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">level</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">p</span> <span class="o">|</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span><span class="p">)]</span> <span class="p">[(< [...] + <span class="p">[(</span><span class="o">-</span><span class="n">r</span> <span class="o">|</span> <span class="o">--</span><span class="n">keep</span><span class="o">-</span><span class="n">repaired</span><span class="p">)]</span> <span class="p">[(</span><span class="o">-</span><span class="n">t</span> <span class="o">|</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">tokens</span><span class="p">)]</span> <span class="p"> [...] + <span class="o"><</span><span class="n">keyspace</span><span class="o">></span> <span class="o"><</span><span class="n">table</span><span class="o">></span> <span class="o"><</span><span class="n">directory</span><span class="o">></span> <span class="o">...</span> <span class="n">OPTIONS</span> <span class="o">-</span><span class="n">c</span><span class="p">,</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">invalidate</span><span class="o">-</span><span class="n">caches</span> @@ -111,6 +111,9 @@ extra-footer: ' <span class="o">-</span><span class="n">p</span> <span class="o"><</span><span class="n">port</span><span class="o">></span><span class="p">,</span> <span class="o">--</span><span class="n">port</span> <span class="o"><</span><span class="n">port</span><span class="o">></span> <span class="n">Remote</span> <span class="n">jmx</span> <span class="n">agent</span> <span class="n">port</span> <span class="n">number</span> + <span class="o">-</span><span class="n">p</span><span class="p">,</span> <span class="o">--</span><span class="n">copy</span><span class="o">-</span><span class="n">data</span> + <span class="n">Copy</span> <span class="n">data</span> <span class="kn">from</span> <span class="nn">source</span> <span class="n">directories</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">moving</span> <span class="n">them</span> + <span class="o">-</span><span class="n">pp</span><span class="p">,</span> <span class="o">--</span><span class="nb">print</span><span class="o">-</span><span class="n">port</span> <span class="n">Operate</span> <span class="ow">in</span> <span class="mf">4.0</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">hosts</span> <span class="n">disambiguated</span> <span class="n">by</span> <span class="n">port</span> <span class="n">number</span> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
![https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png"](https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png"){kind=link}
![https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png"](https://developers.google.com/open-source/gsoc/resources/downloads/GSoC-logo-horizontal-800.png"){kind=link}
![https://cassandra.apache.org/img/changelog_header.jpg"](https://cassandra.apache.org/img/changelog_header.jpg"){kind=link}