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 <[email protected]> Tested-by: Impala Public Jenkins <[email protected]> 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 <[email protected]> Authored: Mon May 14 16:54:55 2018 -0700 Committer: Impala Public Jenkins <[email protected]> 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>
