OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Developer Center

V3.2.2Community Edition

  • OceanBase Developer Center Documentation
  • What's New
    • Product updates
  • Overview
    • What is ODC?
    • Benefits
    • Architecture
    • Features
    • Limits
  • Quick Start
    • Overview
    • Install ODC
    • Log on to ODC with an account
    • Create a private connection
  • Tutorials
    • Tips on the SQL Console
    • Create a connection
    • Export data
    • Import data
    • Debug a stored procedure
    • View the performance of an SQL statement
  • User Guide (Web ODC)
    • Log on to ODC
      • Log on to ODC with an account
      • Change the password
    • ODC homepage
    • Connect to a database
      • Create a private connection
      • Manage private connections
    • Public resource management
      • Overview
      • Member management
        • Manage users
        • Manage roles
      • Resource management
        • Manage public connections
        • Manage resource groups
      • System settings
    • Use the workspace
      • Overview
      • SQL window
      • Anonymous block window
      • Command-line window
      • Stored scripts
      • Snippet
    • Use tools
      • Data export and import
        • Overview
        • Export and import formats
        • Batch export and import
        • Single table export and import
      • Data mocking
      • Asynchronous execution
    • Recycle bin
    • Task management
      • Overview
      • Import tasks
      • Export tasks
      • Data mocking tasks
      • Asynchronous tasks
    • Session management
    • Database objects
      • Table objects
        • Overview
        • Create a table
        • Table list
        • Manage table attributes
        • Manage table data
      • View objects
        • Overview
        • Create a view
        • Manage views
      • Function objects
        • Overview
        • Create a function
        • Manage functions
      • Stored procedure objects
        • Overview
        • Create a stored procedure
        • Manage stored procedures
      • Sequence objects
        • Overview
        • Create a sequence
        • Manage sequences
      • Package objects
        • Overview
        • Create a program package
        • Manage program packages
      • Trigger objects
        • Overview
        • Create a trigger
        • Manage triggers
      • Type objects
        • Overview
        • Create a type
        • Manage types
      • Synonym objects
        • Overview
        • Create a synonym
        • Manage synonyms
    • Help center
    • Revision note
  • User Guide (Client ODC)
    • Install ODC
    • ODC homepage
    • Connect to a database
      • Create a connection
      • Manage connections
    • Use the workspace
      • Overview
      • SQL window
      • Anonymous block window
      • Command-line window
      • Stored scripts
      • Snippet
    • Use tools
      • Data export and import
        • Overview
        • Export and import formats
        • Batch export and import
        • Single table export and import
      • Data mocking
      • Asynchronous execution
    • Recycle bin
    • Task management
      • Overview
      • Import tasks
      • Export tasks
      • Data mocking tasks
      • Asynchronous tasks
    • Session management
    • Database objects
      • Table objects
        • Overview
        • Create a table
        • Table list
        • Manage table attributes
        • Manage table data
      • View objects
        • Overview
        • Create a view
        • Manage views
      • Function objects
        • Overview
        • Create a function
        • Manage functions
      • Stored procedure objects
        • Overview
        • Create a stored procedure
        • Manage stored procedures
      • Sequence objects
        • Overview
        • Create a sequence
        • Manage sequences
      • Package objects
        • Overview
        • Create a program package
        • Manage program packages
      • Trigger objects
        • Overview
        • Create a trigger
        • Manage triggers
      • Type objects
        • Overview
        • Create a type
        • Manage types
      • Synonym objects
        • Overview
        • Create a synonym
        • Manage synonyms
    • Help center
    • Revision note
  • Deployment Guide
    • Deployment overview
    • Preparations before deployment
    • Deploy a single ODC node
      • Deployment process
      • Load and run an ODC image
    • Deploy ODC in high availability mode
      • Deployment process
      • Load and run an ODC image
      • Deploy SSL certificate
      • Deploy the NGINX proxy
      • Configure certificate trust
    • Deployment verification
    • Revision note
  • Upgrade Guide
    • Overview
    • Preparation for upgrade
    • Upgrade single-node ODC
      • Upgrade process
      • Stop ODC of the earlier version
      • Load and run an ODC image
    • Upgrade high-availability
      • Upgrade process
      • Stop ODC of the earlier version
      • Load and run an ODC image
      • Upgrade NGINX image
    • Upgrade verification
    • Rollback after upgrade failed
    • Revision note
  • FAQ

Download PDF

OceanBase Developer Center DocumentationProduct updates What is ODC? Benefits Architecture Features Limits Overview Install ODC Log on to ODC with an account Create a private connection Tips on the SQL Console Create a connection Export data Import data Debug a stored procedure View the performance of an SQL statement Log on to ODC with an account Change the password ODC homepage Create a private connection Manage private connections Overview System settings Overview SQL window Anonymous block window Command-line window Stored scripts Snippet Data mocking Asynchronous execution Recycle bin Overview Import tasks Export tasks Data mocking tasks Asynchronous tasks Session management Help center Revision note Install ODC ODC homepage Create a connection Manage connections Overview SQL window Anonymous block window Command-line window Stored scripts Snippet Data mocking Asynchronous execution Recycle bin Overview Import tasks Export tasks Data mocking tasks Asynchronous tasks Session management Help center Revision note Deployment overview Preparations before deployment Deployment process Load and run an ODC image Deployment process Load and run an ODC image Deploy SSL certificate Deploy the NGINX proxy Configure certificate trust Deployment verification Revision note Overview Preparation for upgrade Upgrade process Stop ODC of the earlier version Load and run an ODC image Upgrade process Stop ODC of the earlier version Load and run an ODC image Upgrade NGINX image Upgrade verification Rollback after upgrade failed Revision note FAQ
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Developer Center
  3. V3.2.2
iconOceanBase Developer Center
V 3.2.2Community Edition
  • V 4.4.2
  • V 4.4.1
  • V 4.4.0
  • V 4.3.4
  • V 4.3.3
  • V 4.3.2
  • V 4.3.1
  • V 4.3.0
  • V 4.2.4
  • V 4.2.3
  • V 4.2.2
  • V 4.2.1
  • V 4.2.0
  • V 4.1.3 and earlier
Community Edition
  • V 4.1.0
  • V 4.0.0
  • V 3.3.2
  • V 3.2.2
Enterprise Edition
  • V 4.1.3
  • V 3.4.0

Create a table

Last Updated:2026-04-13 07:35:39  Updated
share
What is on this page
Overview
Procedure
Step 1: set the basic information
Step 2: set columns
Step 3: set partitioning rules
Step 4: set the index
Step 5: set constraints

folded

share

Overview

Log on to OceanBase Developer Center (ODC) and click the name of the target connection to go to the corresponding connection management page. You can click Table in the left-side navigation pane to get a list of tables. To create a table, click + in the upper-right corner of the table list or click Create in the top navigation bar.

Create a table

You can create a table in six steps, as shown in the preceding figure.

  1. Set the basic information.

  2. Set columns.

  3. Set partitioning rules.

  4. Set the index.

  5. Set constraints.

  6. Click Commit and wait for the table to be generated.

Procedure

Step 1: set the basic information

Specify the table name and description for the table. The description is optional. Note

In MySQL mode, you also need to specify Default Character Set and Default Sorting Rule .

Step 2: set columns

The following figure and table show the information that you need to specify when you add a column.

image

Parameter Description
Field Name Specifies the name of the column.
Data Type Specifies the data type of the column.
Non-empty Specifies whether the value of the column must be specified.
Auto-increment Specifies whether to set the column to an auto-increment column. This parameter is valid in MySQL mode.
Default Value Specifies the default value of the column.
Comment Provides additional information about the column.

The column setting section also provides three buttons.

Button Description
Create Click this button to add a field.
Edit Click this button to edit the selected field. You can also directly double-click a cell to edit it.
Delete Click this button to delete the selected field.

Step 3: set partitioning rules

image

  • In MySQL mode, OceanBase Database supports the following six partitioning methods: Key , Hash , Range , Range_columns , List , and List_columns .

  • In Oracle mode, OceanBase Database supports the following three partitioning methods: List , Range , and Hash .

    The definition of partition in MySQL mode is different from that in Oracle mode. So, the values of the following parameters vary in different modes. You need to specify the following parameters based on the partitioning method that you selected.

    Parameter Description
    Partitioning Method Specifies the partitioning method. The partitioning methods supported in MySQL mode are different from those in Oracle mode.
    Field Specifies the field that contains the partition key.
    Expression Partitions are divided based on the return value of the expression. The partition expression is not supported in Oracle mode.
    Partition Based on the value specified for Partitioning Method , you may need to specify information such as Partition Name , Partition Quantity , Upper limit of the range , and Enumeration Value . You can add multiple partitions and drag the partitions to adjust their order.

Step 4: set the index

The following figure and table show the information that you need to specify when you set the index.

image

Parameter Description
Index Name Specifies the name of the index.
Index Range The default value is GLOBAL , indicating a global index. You can set this parameter to LOCAL only for tables with partitions. The value LOCAL indicates a local index.
Index Type Only B-tree is supported.
Optional Field Specifies the columns to be indexed. Pay attention to the order of the indexed columns.
Unique Specifies whether the index is unique. In other words, the index is used to ensure that the constraint is unique.

The index setting section also provides three buttons.

Button Description
+Create Click this button to add an index.
Edit Click this button to edit the selected index. You can also directly double-click a cell to edit it.
Delete Click this button to delete the selected index.

Step 5: set constraints

image

ODC supports the following four table constraints:

  • Primary Key Constraint : defines a primary key to uniquely identify each row of data in the table. A primary key constraint can be a field or a group of fields. You can set only one primary key constraint for a table, and you cannot edit the constraint after it is configured.

  • Unique Constraint : ensures that the data in a field or a group of fields is unique in the table. You can set multiple unique constraints in one table.

  • Foreign Key Constraint : connects one or more columns in two tables. A foreign key constraint is used to maintain the data consistency and integrity between associated tables. After you complete the setting of foreign key constraints, you cannot create new constraints or edit existing constraints.

  • Check Constraints : checks the data in the database based on the configured check rules when you edit the data. Data modification is allowed only after the check is passed. Check Constraints is supported only in Oracle mode.OceanBase Database supports different constraints in MySQL and Oracle modes, and different constraints require different information. Therefore, you need to specify the required information based on the constraint you selected and the requirements on the page.

    Parameter Description
    Constraint Name Specifies the name of the constraint.
    Column Information Specifies one field or a group of fields as the constraint.
    Enabled Specifies whether to enable the created constraint. In some cases, you may need to temporarily disable the constraints. For example, when you import a large amount of data, you can disable constraints to improve the import efficiency.
    Deferrable Supports three types of delay status. Valid values: Verify Now , Non-deferrable , and Delayed Verification .
    Associated Schema Specifies the schema where the associated table is located when Foreign Key Constraint is used. The associated table is the parent table. This parameter is valid in Oracle mode.
    Associated Database Specifies the database where the associated table is located when Foreign Key Constraint is used. The associated table is the parent table. This parameter is valid in MySQL mode.
    Associated Table Specifies the associated table when Foreign Key Constraint is used. The associated table is the parent table.
    Associated Field Specifies the associated table when Foreign Key Constraint is used. The associated table is the parent table.
    Delete Specifies the action to be performed on the current table when the data in the associated table is deleted. The current table is the child table, and the associated table is the parent table. The following four types of action are supported: CASCADE , NO ACTION , RESTRICT , and SET NULL . The actions supported in MySQL mode are different from those in Oracle mode. * In MySQL mode, you can specify CASCADE, NO ACTION, RESTRICT, and SET NULL. * In Oracle mode, you can specify CASCADE, NO ACTION, and SET NULL. Notice At present, OceanBase Database does not support SET NULL . For more information about the syntax, see CREATE TABLE, or the official documentation of MySQL or Oracle.
    Update Specifies the action to be performed on the current table when the data in the associated table is updated. The current table is the child table, and the associated table is the parent table. The following four types of action are supported: CASCADE , NO ACTION , RESTRICT , and SET NULL . The actions supported in MySQL mode are different from those in Oracle mode. * In MySQL mode, you can specify CASCADE, NO ACTION, RESTRICT, and SET NULL. * In Oracle mode, you can specify NO ACTION. Notice At present, OceanBase Database does not support SET NULL . For more information about the syntax, see CREATE TABLE, or the official documentation of MySQL or Oracle.
    Check Condition Specifies the check rules for data verification when Check Constraints is enabled.

    The constraint setting section also provides three buttons.

    Button Description
    Create Click this button to add a constraint.
    Edit Click this button to edit the selected constraint. You can also directly double-click a cell to edit it.
    Delete Click this button to delete the selected constraint.

Previous topic

Overview
Last

Next topic

Table list
Next
What is on this page
Overview
Procedure
Step 1: set the basic information
Step 2: set columns
Step 3: set partitioning rules
Step 4: set the index
Step 5: set constraints