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

V4.4.0

  • Topics Overview
  • Overview
    • What is ODC?
    • Features
    • Architecture
    • Limitations
    • ODC console
  • Quick Start
    • Client ODC
      • Overview
      • Install Client ODC
      • Use Client ODC
    • Web ODC
      • Overview
      • Deploy Web ODC
      • Use Web ODC
  • Data Source Management
    • Create a data source
    • Data sources and project collaboration
    • Database O&M
      • Session management
      • Global variable management
      • Recycle bin management
  • SQL Development
    • Edit and execute SQL statements
    • Perform PL compilation and debugging
    • Use the command-line window
    • Edit and export the result set of an SQL statement
    • Execution analysis
    • Generate test data
    • System settings
    • Database objects
      • Table objects
        • Overview
        • Create a table
      • View objects
        • Overview
        • Create a view
        • Manage views
      • Materialized view objects
        • Overview
        • Create a materialized view
        • Manage materialized 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
  • Import and Export
    • Import schemas and data
    • Export schemas and data
  • Database Change Management
    • Manage user permissions
      • Users and roles
      • Automatic authorization
      • User permission management
    • Project collaboration management
    • Risk levels, risk identification rules, and approval processes
    • SQL check specifications
    • SQL window specification
    • Database change management
    • Manage changes to logical databases
    • Batch database change management
    • Online schema changes
    • Synchronize shadow tables
    • Schema comparison
  • Data Lifecycle Management
    • Data archiving
    • Data cleanup
    • Manage partitioning plans
      • Manage partitioning plans
      • Set partitioning strategies
      • Examples of partitioning strategies
    • SQL plan task
  • Data Masking and Auditing
    • Desensitize data
    • Operation records
  • Notification Management
    • Overview
    • View notification records
    • Manage notification channels
      • Create a notification channel
      • View, edit, and delete a notification channel
      • Configure a custom channel
    • Manage notification rules
  • System Integration
    • Login integration
    • Approval integration
    • SQL approval integration
    • Bastion host integration
  • Deployment Guide
    • Deployment overview
    • Preparations before deployment
    • Deploy ODC in single-node mode
    • Deploy ODC in high-availability mode
    • Deployment verification
  • Upgrade Guide
    • Upgrade Overview
    • Preparations before upgrade
    • Update single-node ODC
    • Update high-avaliability ODC
    • Upgrade verification
    • Rollback after upgrade failed
  • Best Practices
    • Tips for SQL development
    • Explore ODC team workspaces
    • Understanding real-time SQL diagnostics for OceanBase AP
    • OceanBase historical database solutions
    • ODC SQL check for automatic identification of high-risk operations
    • Integration with ODC enterprise-level account system
    • Manage and modify sharded databases and tables via ODC
    • Data masking and control practices
    • Enterprise-level control and collaboration: Safeguard every database change
  • Troubleshooting
    • ODC troubleshooting process
    • Collect message
      • View the runtime environment and version information
      • View web ODC logs
      • View client ODC logs
      • View end-to-end ODC-related logs
      • View ODC MetaDB data
      • Query the index status in OceanBase Database V4.x
      • Query the index status in OceanBase Database V1.4.x to V3.2.x
      • Collect JVM runtime information
      • Use tcpdump to capture packets
    • FAQ
      • Installation of client ODC
      • Web ODC deployment and startup
      • Connection Information
      • Command-line window
      • DDL statement display
  • Common features
  • Release Notes
    • V4.4
      • ODC V4.4.0
    • V4.3
      • ODC V4.3.4
      • ODC V4.3.3
      • ODC V4.3.2
      • ODC V4.3.1
      • ODC V4.3.0
    • V4.2
      • ODC V4.2.4
      • ODC V4.2.3
      • ODC V4.2.2
      • ODC V4.2.1
      • ODC V4.2.0
    • V4.1
      • ODC V4.1.3
      • ODC V4.1.2
      • ODC V4.1.1
      • ODC V4.1.0
    • V4.0
      • ODC V4.0.2
      • ODC V4.0.0
    • V3.4
      • ODC V3.4.0
    • V3.3
      • ODC V3.3.3
      • ODC V3.3.2
      • ODC V3.3.1
      • ODC V3.3.0
    • V3.2
      • ODC V3.2.3
      • ODC V3.2.2
      • ODC V3.2.1
      • ODC V3.2.0

Download PDF

Topics Overview What is ODC? Features Architecture Limitations ODC console Overview Install Client ODC Use Client ODC Overview Deploy Web ODC Use Web ODC Create a data source Data sources and project collaboration Session management Global variable management Recycle bin management Edit and execute SQL statements Perform PL compilation and debugging Use the command-line window Edit and export the result set of an SQL statement Execution analysis Generate test data System settings Import schemas and data Export schemas and data Users and roles Automatic authorization User permission management Project collaboration management Risk levels, risk identification rules, and approval processes SQL check specifications SQL window specification Database change management Manage changes to logical databases Batch database change management Online schema changes Synchronize shadow tables Schema comparison Data archiving Data cleanup Manage partitioning plans Set partitioning strategies Examples of partitioning strategies SQL plan task Desensitize data Operation records Overview View notification records Create a notification channel View, edit, and delete a notification channel Configure a custom channel Manage notification rules Login integration Approval integration SQL approval integration Bastion host integration Deployment overview Preparations before deployment Deploy ODC in single-node mode Deploy ODC in high-availability mode Deployment verification Upgrade Overview Preparations before upgrade Update single-node ODC Update high-avaliability ODC Upgrade verification Rollback after upgrade failed Tips for SQL development Explore ODC team workspaces Understanding real-time SQL diagnostics for OceanBase AP OceanBase historical database solutions ODC SQL check for automatic identification of high-risk operations Integration with ODC enterprise-level account system Manage and modify sharded databases and tables via ODC Data masking and control practices Enterprise-level control and collaboration: Safeguard every database change ODC troubleshooting process View the runtime environment and version information View web ODC logs View client ODC logs View end-to-end ODC-related logs View ODC MetaDB data Query the index status in OceanBase Database V4.x Query the index status in OceanBase Database V1.4.x to V3.2.x Collect JVM runtime information Use tcpdump to capture packets Installation of client ODC Web ODC deployment and startup Connection Information Command-line window DDL statement display Common features ODC V4.4.0 ODC V4.3.4 ODC V4.3.3 ODC V4.3.2 ODC V4.3.1 ODC V4.3.0 ODC V4.2.4
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. V4.4.0
iconOceanBase Developer Center
V 4.4.0
  • 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

Explore ODC team workspaces

Last Updated:2026-04-07 10:00:35  Updated
share
What is on this page
Understand the workspaces: Personal vs. Team
The value of team workspaces
Overcoming DevOps collaboration challenges
Recommended scenarios for using team workspaces
Six steps to activate a team workspace
Key applications of team workspaces
Stable development: SQL development and change approvals
Standardized development: SQL checks
Database optimization: Historical database
Security and compliance: data masking
Structural consistency assurance: multi-database changes
Sharded database management: logical database changes
Related information

folded

share

This guide helps you quickly unlock the full power of ODC team workspaces, including detailed workspace introduction, activation steps, and application scenarios.

Understand the workspaces: Personal vs. Team

To meet diverse development needs, ODC offers two types of workspaces: personal workspaces and team workspaces, catering to different user groups.

  • Personal workspace: Designed for individual use, offering basic SQL development and 12 common ticket types to support typical development tasks.

  • Team workspace: A collaborative platform for multiple users. In addition to basic SQL development and 12 common ticket types, it also offers advanced capabilities such as multi-database changes, logical database changes, development standards enforcement, and data masking.

Comparison of capabilities between personal and team workspaces:

Feature Personal workspace Team workspace
SQL Development Supported Supported
12 Common Ticket Types Supported Supported
More Ticket Types (Multi-Database Changes, Logical Database Changes) Not supported Supported
User Permission Management Not supported Supported
Project Management Not supported Supported
Notification and Messaging Not supported Supported
Development Standards Not supported Supported
Data Masking Not supported Supported
Approval Workflow Not supported Supported

Pros and cons of personal and team workspaces:

Item Personal workspace Team workspace
Advantages Easy to get started and flexible. Supports team collaboration, enforces standardized development, offers rich features, and ensures data compliance. Only administrators need to manage database credentials; other collaborators do not need to handle credentials.
Disadvantages Cannot support team collaboration, fewer features compared to team workspaces. Requires database account and password for development. Requires higher initial setup cost for administrators, who need to understand basic team workspace concepts.

The value of team workspaces

Overcoming DevOps collaboration challenges

In most companies, there is a significant imbalance between the size of the DBA (Database Administrator) team and the development team. A single DBA may need to support hundreds or even thousands of developers across various business units, with highly diverse requirements.

At each key project phase (development, testing, and production release), DBAs must deeply participate in the database change process, including table structure design, adjustment, and data modification. If the entire process relies solely on ad hoc communication and manual operations, it severely impacts both the DBA and developer experience, and greatly increases the risk of production incidents, posing a threat to the business.

ODC team workspaces are designed to address these pain points. As the saying goes, "If you want to go fast, go alone; if you want to go far, go together". ODC acts as a powerful partner, enabling DBAs and developers to collaborate efficiently and securely, ensuring steady project delivery and achieving the goal of "going fast and far together".

Recommended scenarios for using team workspaces

  1. The ratio of DBAs to developers is less than 1:20, and frequent database change requests are expected.

  2. The business requires SQL development standards (e.g., naming conventions for tables and columns, prohibition of SELECT * queries).

  3. The business demands high stability (e.g., limiting the number of query results, recognizing offline DDL for non-blocking changes, restricting data exports).

  4. The business involves sensitive data requiring encryption and secure management.

  5. The business handles large data volumes and requires regular data cleanup or archiving.

  6. There is a need to ensure consistent database schemas across development, testing, and production environments.

  7. The business involves sharded databases and requires regular structure maintenance.

  8. Notifications and alerts are needed for abnormal activities within the workspace.

Six steps to activate a team workspace

Starting from ODC V4.3.4, the Quick Start module in the workspace provides a quick path to activate a team workspace. Before activation, it is important to understand the relationships between different concepts within a project.

1

Follow these six steps to activate your team workspace:

  1. Add a data source

    By default, only system admins (system_admin role) can create data sources. However, if the administrator has delegated data source management permissions to specific roles via the User Permissions module, those roles can also manage data sources. A data source must be added before it can be assigned to a project.

    2

  2. Create a project

    Similarly, only system admins (or roles with project management permissions) can create projects. When creating a project, you must assign a project admin and a DBA. These roles default to the project creator. Collaboration in a team workspace is project-based, so creating a project is the first step.

    3

  3. Add business databases

    Databases from the data source must be added to the project before project members can access them. Only project admins with edit permissions on the data source can perform this operation. You can also bind the entire data source to a project to automatically synchronize new databases.

    4

  4. Manage team members

    After adding databases, add team members to the project and assign appropriate roles. Role permissions are detailed in the role descriptions. Note that Admins, DBAs, and Developers have access to all project databases by default, while Security Admins and Participants do not. They can apply for access or be granted permissions by project admins.

    5

  5. Adjust development standards

    ODC provides 50+ SQL check rules and 8 SQL window rules. Some development standards are enabled by default. To adjust them, system admins can go to the Security module. Common adjustments include:

    • Disabling certain standards for the development environment.

    • Adjusting standards for specific data source types in different environments.

      6

  6. Configure approval workflows

    ODC offers four risk levels: high, medium, low, and default. If a change does not match high, medium, or low risk rules, it defaults to the default risk level and usually auto-approves. If multiple risk levels are matched, the highest one applies. Admins can adjust rules and workflows in the Security module.

    7

Once completed, your team workspace is fully activated and ready for database development operations.

Key applications of team workspaces

Stable development: SQL development and change approvals

Once activated, you can start database development. From the homepage, click SQL Console or navigate via Recently Accessed Databases to the SQL development page.

In the SQL development page, you can write SQL queries. Features include code snippets, autocomplete, and script saving. For tips, refer to Tips for SQL development. After execution, you can view real-time analysis, edit results, and export result sets. For real-time analysis, see Understanding real-time SQL diagnostics for OceanBase AP.

9

To submit a change request, right-click a database in the resource tree and select a ticket type. ODC supports 12 ticket types including online schema changes, SQL execution plans, partition plans, etc. For details, see Online Schema Changes.

10

After filling in the ticket parameters, click Submit. The system will perform a development standards check and risk assessment. Changes matching approval workflows will require approver confirmation before execution.

11

Standardized development: SQL checks

ODC offers a robust set of 50+ SQL rules covering DDL, DML, and DQL, ensuring performance, standardization, and security. Standards can vary by environment to meet different production, test, and development requirements.

12

SQL checks can be triggered before or during change submission. The pre-submission check entry is shown below:

13

For more on SQL checks, see ODC SQL check for automatic identification of high-risk operations.

Database optimization: Historical database

As a business database runs over time, the data volume grows continuously, leading to rising storage costs, declining database performance, and increasing database maintenance complexity.

To address these challenges, ODC introduces the historical database feature. Historical databases are designed to archive obsolete or infrequently accessed tables separately, enabling efficient data management and significantly reducing the load on business databases.

ODC supports data archiving and cleanup to support this scenario. Currently, supported archiving links are:

  • OceanBase MySQL compatible, MySQL -> OceanBase MySQL compatible
  • OceanBase Oracle compatible, Oracle -> OceanBase Oracle compatible
  • OceanBase MySQL compatible, MySQL -> MySQL
  • OceanBase Oracle compatible, Oracle -> Oracle
  • PostgreSQL -> OceanBase MySQL compatible
  • OceanBase MySQL compatible, OceanBase Oracle compatible, MySQL, Oracle, PostgreSQL -> Object Storage (OSS, COS, OBS, S3)

For more information, refer to OceanBase historical database solutions.

14

Security and compliance: data masking

During routine operations such as maintenance, development, and data analysis, enterprises often need to perform database queries. These databases may contain sensitive data that is critical to the business and cannot be separated. Directly querying this data can pose privacy risks, but fully restricting access could lead to inefficiency or even make some tasks impossible.

To address this challenge, ODC provides a data masking solution that allows you to access and use database information without exposing sensitive data. ODC can mask sensitive data during SQL queries, data exports, and other scenarios where data leaves the database, ensuring both accessibility and privacy. ODC currently supports more than 20 masking algorithms, including full masking, hash masking, default masking, and masking for fields with specific business meanings. You only need to configure the fields that require masking within the corresponding project. For more information, see Data masking and control practices.

15

Structural consistency assurance: multi-database changes

In daily operations, it is essential to ensure consistent database structures across development, testing, and production environments for the same business application. For structural changes, you must apply them across different environments. Without platform support, you would have to manually execute the same change in multiple environments, leading to inefficiencies and a higher risk of errors.

To solve this problem, ODC offers multi-database change capabilities. You can orchestrate changes across multiple databases of the same type within a single project through one change ticket, ensuring structural consistency across environments. For frequently used change workflows, you can save them as templates for reuse in future operations. For more information, see Batch database change management.

16

Sharded database management: logical database changes

In the era of big data, many enterprises use scalable distributed databases like OceanBase or sharding technologies to handle and manage massive amounts of data. For new businesses, distributed databases are often preferred due to their stronger scalability and lower management costs.

Sharding is a horizontal partitioning strategy that distributes data across multiple database instances or tables to improve processing capacity and query performance. Although sharding addresses business needs, managing a large number of shards can become a significant challenge for DBAs and developers.

To address this, ODC supports logical databases. Logical databases not only ease the burden of managing shards but also lay the foundation for migrating to distributed databases in the future (ODC will later support archiving logical database data to OceanBase databases).

You can configure a logical database with just a few simple steps. Once configured, ODC will regularly inspect the structural consistency of logical tables within the logical database. ODC currently supports GUI-based creation of logical tables and the initiation of DDL change tickets for logical databases, helping you manage and maintain sharded structures more easily. For more information, see Manage and modify sharded databases and tables via ODC.

17

Related information

  • Tips for SQL development
  • ODC SQL check for automatic identification of high-risk operations
  • Understanding real-time SQL diagnostics for OceanBase AP
  • OceanBase historical database solutions
  • Data masking and control practices
  • Manage and modify sharded databases and tables via ODC

Previous topic

Tips for SQL development
Last

Next topic

Understanding real-time SQL diagnostics for OceanBase AP
Next
What is on this page
Understand the workspaces: Personal vs. Team
The value of team workspaces
Overcoming DevOps collaboration challenges
Recommended scenarios for using team workspaces
Six steps to activate a team workspace
Key applications of team workspaces
Stable development: SQL development and change approvals
Standardized development: SQL checks
Database optimization: Historical database
Security and compliance: data masking
Structural consistency assurance: multi-database changes
Sharded database management: logical database changes
Related information