You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@impala.apache.org by ta...@apache.org on 2018/05/16 02:53:16 UTC
[09/12] impala git commit: IMPALA-3813: [DOCS] How to create a Kudu
table with a replication factor
IMPALA-3813: [DOCS] How to create a Kudu table with a replication factor
Described how to create a Kudu table with a replication factor that is
not the default value of 3.
Change-Id: I9dc68dcd395fcd0bd31563ea46229a12553482dc
Reviewed-on: http://gerrit.cloudera.org:8080/10401
Reviewed-by: Thomas Tauber-Marshall <tm...@cloudera.com>
Tested-by: Impala Public Jenkins <im...@cloudera.com>
Project: http://git-wip-us.apache.org/repos/asf/impala/repo
Commit: http://git-wip-us.apache.org/repos/asf/impala/commit/43998456
Tree: http://git-wip-us.apache.org/repos/asf/impala/tree/43998456
Diff: http://git-wip-us.apache.org/repos/asf/impala/diff/43998456
Branch: refs/heads/2.x
Commit: 439984564491562de66849e706cc56a668f94159
Parents: 670cd55
Author: Alex Rodoni <ar...@cloudera.com>
Authored: Mon May 14 16:54:55 2018 -0700
Committer: Impala Public Jenkins <im...@gerrit.cloudera.org>
Committed: Tue May 15 21:10:11 2018 +0000
----------------------------------------------------------------------
docs/topics/impala_create_table.xml | 5 +++++
docs/topics/impala_kudu.xml | 36 ++++++++++++++++++++++++--------
2 files changed, 32 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/impala/blob/43998456/docs/topics/impala_create_table.xml
----------------------------------------------------------------------
diff --git a/docs/topics/impala_create_table.xml b/docs/topics/impala_create_table.xml
index a60cd40..3434d9e 100644
--- a/docs/topics/impala_create_table.xml
+++ b/docs/topics/impala_create_table.xml
@@ -565,6 +565,11 @@ CREATE TABLE ctas_t1
<xref href="impala_kudu.xml#kudu_primary_key_attribute"/>.
</p>
+ <p>
+ For more on creating a Kudu table with a specific replication factor, see
+ <xref href="impala_kudu.xml#kudu_replication_factor"/>.
+ </p>
+
<p rev="IMPALA-3719">
For more on the <codeph>NULL</codeph> and <codeph>NOT NULL</codeph> attributes, see
<xref href="impala_kudu.xml#kudu_not_null_attribute"/>.
http://git-wip-us.apache.org/repos/asf/impala/blob/43998456/docs/topics/impala_kudu.xml
----------------------------------------------------------------------
diff --git a/docs/topics/impala_kudu.xml b/docs/topics/impala_kudu.xml
index 946a066..145654e 100644
--- a/docs/topics/impala_kudu.xml
+++ b/docs/topics/impala_kudu.xml
@@ -144,25 +144,43 @@ under the License.
<li>
<p>
- Data is physically divided based on units of storage called <term>tablets</term>. Tablets are
- stored by <term>tablet servers</term>. Each tablet server can store multiple tablets,
- and each tablet is replicated across multiple tablet servers, managed automatically by Kudu.
- Where practical, colocate the tablet servers on the same hosts as the DataNodes, although that is not required.
+ Data is physically divided based on units of storage called
+ <term>tablets</term>. Tablets are stored by <term>tablet
+ servers</term>. Each tablet server can store multiple tablets,
+ and each tablet is replicated across multiple tablet servers,
+ managed automatically by Kudu. Where practical, co-locate the
+ tablet servers on the same hosts as the DataNodes, although that
+ is not required.
</p>
</li>
</ul>
- <p>
- One consideration for the cluster topology is that the number of replicas for a Kudu table
- must be odd.
- </p>
-
</conbody>
</concept>
</concept>
+ <concept id="kudu_replication_factor">
+ <title>Kudu Replication Factor</title>
+ <conbody>
+ <p>
+ By default, Kudu tables created through Impala use a tablet
+ replication factor of 3. To change the replication factor for a Kudu
+ table, specify the replication factor using <codeph>TBLPROPERTIES
+ ('kudu.num_tablet_replicas' = '<i>n</i>')</codeph> in the <keyword
+ keyref="create_table"/> statement.
+ </p>
+
+ <p>
+ The number of replicas for a Kudu table must be odd.
+ </p>
+
+ <p> Altering the <codeph>kudu.num_tablet_replicas</codeph> property after
+ table creation currently has no effect. </p>
+ </conbody>
+ </concept>
+
<concept id="kudu_ddl">
<title>Impala DDL Enhancements for Kudu Tables (CREATE TABLE and ALTER TABLE)</title>