All Products
Search
Document Center

Hologres:Manage internal tables

Last Updated:Feb 28, 2026

This topic describes how to create, edit, and delete internal tables in HoloWeb. It also explains how to preview table data and view DDL statements.

Prerequisites

Before you manage internal tables, make sure the following requirements are met:

Navigate to HoloWeb

All operations in this topic are performed on the HoloWeb developer page. To open HoloWeb, perform the following steps:

  1. Log on to the Hologres Management Console.

  2. In the navigation pane on the left of the top menu bar, select the desired region.

  3. You can click Go to HoloWeb to go to the HoloWeb development page.

Navigate to an existing table

The edit, delete, preview, and DDL operations in this topic require you to locate an existing internal table. Use the following steps each time you need to navigate to a table:

  1. In the left-side navigation pane, click Instances Connected to display all connected instance names.

  2. Click Database under the target instance to display all created databases.

  3. Click Schema under the target database, then click Tables to display all created internal tables.

Create an internal table

  1. On the HoloWeb developer page, in the top menu bar, click Metadata Management.

  2. Use one of the following methods to create an internal table:

    • Method 1: Click Create Table to create an internal table directly.

    • Method 2: Right-click the target schema or Table under the schema, then select Create Internal Table.

    Create Internal Table page in HoloWeb showing the schema tree and creation options

  3. On the Create Internal Table page, configure the parameters described in the following sections, then click Submit in the upper-right corner.

  4. After submission, refresh the corresponding schema in the left-side navigation pane to display the new internal table.

Note

Tip: Click Query Table in the upper-right corner of the table editing page to open the SQL query window and query the table using SQL statements.

Basic properties

Parameter

Description

Mode

The schema name. You can select the default public schema or a new schema name.

Table Name

The name of the new Hologres internal table.

Description

The description of the new Hologres internal table.

Fields

Parameter

Description

Field Name

The identifier for each column in the table.

Data Type

The data type of the field.

Primary Key

The unique identifier for each data entry in the table.

Nullable

Indicates whether the field can be set to null.

Array

An ordered sequence of elements.

Default Value

The default value for the field.

Description

The description of the field.

Actions

Includes Delete.

Attributes

Parameter

Description

Storage Mode

The storage layout for the table. Options include Column-oriented Storage, Row-oriented Storage, and Row-column Storage. The default is Column-oriented Storage.

Data Lifecycle

The retention period for table data, calculated from the first data write. After the time to live expires, the table data is purged within a certain period (no fixed timeframe). The default value is Permanent.

Binlog

Indicates whether binary logging (Binlog) is enabled for the table. For more information, see Subscribe to Hologres Binlog.

Lifecycle of Binary Logs

The time to live for Binlog. The default value is Permanent. For more information, see Subscribe to Hologres Binlog.

Distribution Column

The distribution_key for the table. For more information, see Distribution Key.

Event Time Column

The event_time_column for the table. For more information, see Event Time Column (Segment Key).

Clustering Key

The clustering_key for the table. For more information, see Clustering Key.

Dictionary Encoding Columns

The dictionary_encoding_columns for the table. For more information, see Dictionary Encoding.

Bitmap Column

The bitmap_columns for the table. For more information, see Bitmap Index.

Partitioning

Parameter

Description

Partitioned Tables

Select a partition field.

Edit an internal table

You can add fields to an existing internal table. Deleting existing table fields is not supported in Edit Table mode.

  1. Navigate to an existing table.

  2. Right-click the target internal table, then select Open Table.

  3. In the upper-right corner of the page, click Edit Table.

  4. At the bottom of the page, click Add Field to add table fields visually.

    Edit Table page showing the Add Field option

  5. Click Submit to complete editing the current internal table.

Delete an internal table

  1. Navigate to an existing table.

  2. Right-click the target internal table, then select Delete Table.

  3. Click OK.

Preview table data

  1. Navigate to an existing table.

  2. Double-click the target internal table. On the table editing page, click Data Preview.

    The following image shows an example of internal table data preview.

    Data Preview tab displaying sample rows from an internal table

View DDL statements

  1. Navigate to an existing table.

  2. Double-click the target internal table. On the table editing page, click DDL Statements.

    The following image shows an example of a DDL statement preview.

    DDL Statements tab showing the CREATE TABLE statement for an internal table

Related topics

You can also create, modify, and delete internal tables using SQL statements. For more information, see the following topics: