Updated on 2023-03-17 GMT+08:00

Overview

Partitioning refers to splitting what is logically one large table into smaller physical pieces based on specific schemes. The table based on the logic is called a partitioned table, and a physical piece is called a partition. Data is stored on these smaller physical pieces, namely, partitions, instead of the larger logical partitioned table.

Follow the steps below to define a table in your database:

  1. In the Object Browser pane, right-click Regular Tables, and choose Create Partition Table.
  2. Define basic table information, such as the table name and table type. For details, see Providing Basic Information.
  3. Define column information, such as the column name, data type schema, data type, and column constraint. For details, see Defining a Column.
  4. Select the data distribution information for the table. For details, see Change Order of Partition.
  5. Define column constraints for different constraint types. Constraint types include PRIMARY KEY, UNIQUE, and CHECK. For details, see Defining Table Constraints.
  6. Define table index information, such as the index name and access mode. For details, see Defining an Index.
  7. Define the partition information for the table such as partition name, partition column, partition value and so on. For details, see Defining a Partition.

    On the SQL Preview tab, you can check the automatically generated SQL query. For details, see Checking the SQL Preview.

  8. To add comments to Column in the Create Partition Table dialog box, add column information in Description of Column (Max 5000 chars) text box and click Add.

Providing Basic Information

Provide the following information to create a table:

For details, see Providing Basic Information.

  • Table Name
  • Schema
  • Options
  • Description of Table

Perform the following steps to configure other parameters:

  1. Select a table storage mode from the Table Orientation drop-down list.

    If table orientation is selected as ORC, then an HDFS Partitioned table is created.

  2. Enter the ORC version number in the ORC Version field. This is applicable only for HDFS Partitioned table.
  3. After providing the general information about the table, click Next to define the columns information for the table.

    The following table describes the parameters of partitioned tables.

    Table 1 Parameters

    Parameter

    Row Partition

    Column Partition

    ORC Partition

    Table Type

    x

    x

    x

    If Not Exists

    With OIDS

    x

    x

    x

    Fill Factor

    x

    x

Defining a Column

For details, see Defining a Column.

The following table describes the parameters of partitioned tables.

Table 2 Parameters

Parameter

Row Partition

Column Partition

ORC Partition

Array Dimensions

x

x

Data Type

x

x

NOT NULL

Default

UNIQUE

x

x

CHECK

x

x

Change Order of Partition

You can change the order of partition as required in the table. To change the order, select the required partition and click Up or Down.

Checking the SQL Preview

For details, see SQL Preview.

Editing a Partition

Perform the following steps to edit a partition:

  1. Select a partition.
  2. Click Edit.
  3. Edit partition configurations as needed and click Update to save the changes.

    You must complete the edit operation and save the changes to continue with other operations.

Deleting a Partition

Perform the following steps to delete a partition:

  1. Select a partition.
  2. Click Delete.

Defining a Partition

The following table describes the parameters of partitioned tables.

Table 3 Parameters

Parameter

Row Partition

Column Partition

ORC Partition

Partition Type

By Range

By Range

By Value

Partition Name

x

Partition Value

x

Perform the following steps to define a table partition:

  1. If Row or Column is selected for Table Orientation on the General tab, By Range will be displayed in the Partition Type area. If ORC is selected for Table Orientation on the General tab, By Value will be displayed in the Partition Type area.
  2. In the Available Column area, select a column and click .

    The column will be moved to the Partition Column area.

    • If Table Orientation is set to Row or Column, only one column can be selected for partitioning.
    • If Table Orientation is set to ORC, up to four columns can be selected for partitioning.
    • A maximum of four columns can be selected to define partitions.

  3. Enter a partition name.
  4. Click next to Partition Value.

    1. Enter the value by which you want to partition the table in Value column.
    2. Click OK.

  5. After you enter all information for partition, click Add.
  6. After defining all partitions, click Next.

You can perform the following operations on the partitions of a row-or column-partitioned table, but not on ORC partitioned tables:

Deleting a Partition

Editing a Partition

Defining an Index

For details about index definitions, see Defining an Index.

Table 4 Parameters

Parameter

Row Partition

Column Partition

ORC Partition

Unique Indexes

x

x

btree

x

gin

x

gist

x

hash

x

psort

x

spgist

x

Fill Factor

x

x

User Defined Expression

x

x

Partial Index

x

x

Defining Table Constraints

For details about how to define table constraints, see Defining Table Constraints.

Table 5 Parameters

Parameter

Partition

Column Partition

ORC Partition

Check

x

x

Unique

x

x

Primary Key

x

x

Configuring Data Distribution

For details about how to select a distribution type, see Selecting Data Distribution.

Table 6 Parameters

Parameter

Row Partition

Column Partition

ORC Partition

DEFAULT DISTRIBUTION

x

Hash

Replication

x