org.kududb.client

Class CreateTableOptions

java.lang.Object

org.kududb.client.CreateTableOptions

@InterfaceAudience.Public
 @InterfaceStability.Evolving
public class CreateTableOptions
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
CreateTableOptions()

Method Summary

Modifier and Type	Method and Description
CreateTableOptions	addHashPartitions(List<String> columns, int buckets) Add a set of hash partitions to the table.
CreateTableOptions	addHashPartitions(List<String> columns, int buckets, int seed) Add a set of hash partitions to the table.
CreateTableOptions	addSplitRow(PartialRow row) Add a split point for the table.
CreateTableOptions	setNumReplicas(int numReplicas) Sets the number of replicas that each tablet will have.
CreateTableOptions	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

CreateTableOptions

public CreateTableOptions()

Method Detail

addSplitRow

public CreateTableOptions 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

Returns:

this instance

addHashPartitions

public CreateTableOptions 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

Returns:

this instance

addHashPartitions

public CreateTableOptions 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

Returns:

this instance

setRangePartitionColumns

public CreateTableOptions 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 or if called with an empty vector, the table will be created without range partitioning. Tables must be created with either range, hash, or range and hash partitioning. To force the use of a single tablet (not recommended), call this method with an empty list and set no split rows and no hash partitions.

Parameters:

columns - the range partitioned columns

Returns:

this instance

setNumReplicas

public CreateTableOptions setNumReplicas(int numReplicas)

Sets the number of replicas that each tablet will have. If not specified, it uses the server-side default which is usually 3 unless changed by an administrator.

Parameters:

numReplicas - the number of replicas to use

Returns:

this instance