org.kududb.client

Class CreateTableBuilder

java.lang.Object

org.kududb.client.CreateTableBuilder

@InterfaceAudience.Public
 @InterfaceStability.Evolving
public class CreateTableBuilder
extends Object

This is a builder class for all the options that can be provided while creating a table.

Constructor Summary

Constructors

Constructor and Description
CreateTableBuilder()

Method Summary

Modifier and Type	Method and Description
void	addHashPartitions(List<String> columns, int buckets) Add a set of hash partitions to the table.
void	addHashPartitions(List<String> columns, int buckets, int seed) Add a set of hash partitions to the table.
void	addSplitRow(PartialRow row) Add a split point for the table.
void	setNumReplicas(int numReplicas) Sets the number of replicas that each tablet will have.
void	setRangePartitionColumns(List<String> columns) Set the columns on which the table will be range-partitioned.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CreateTableBuilder

public CreateTableBuilder()

Method Detail

addSplitRow

public void addSplitRow(PartialRow row)

Add a split point for the table. The table in the end will have splits + 1 tablets. The row may be reused or modified safely after this call without changing the split point.

Parameters:

row - a key row for the split point

addHashPartitions

public void addHashPartitions(List<String> columns,
                              int buckets)

Add a set of hash partitions to the table. Each column must be a part of the table's primary key, and an individual column may only appear in a single hash component. For each set of hash partitions added to the table, the total number of table partitions is multiplied by the number of buckets. For example, if a table is created with 3 split rows, and two hash partitions with 4 and 5 buckets respectively, the total number of table partitions will be 80 (4 range partitions * 4 hash buckets * 5 hash buckets).

Parameters:

columns - the columns to hash

buckets - the number of buckets to hash into

addHashPartitions

public void addHashPartitions(List<String> columns,
                              int buckets,
                              int seed)

Add a set of hash partitions to the table. This constructor takes a seed value, which can be used to randomize the mapping of rows to hash buckets. Setting the seed may provide some amount of protection against denial of service attacks when the hashed columns contain user provided values.

Parameters:

columns - the columns to hash

buckets - the number of buckets to hash into

seed - a hash seed

setRangePartitionColumns

public void setRangePartitionColumns(List<String> columns)

Set the columns on which the table will be range-partitioned. Every column must be a part of the table's primary key. If not set, the table will be created with the primary-key columns as the range-partition columns. If called with an empty vector, the table will be created without range partitioning.

Parameters:

columns - the range partitioned columns

setNumReplicas

public void setNumReplicas(int numReplicas)

Sets the number of replicas that each tablet will have. If not specified, it defaults to 1 replica which isn't safe for production usage.

Parameters:

numReplicas - the number of replicas to use