OceanBase logo

OceanBase

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

Product Overview
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

OceanBase

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

Product Overview
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 Database

SQL - V4.3.1

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogWhite PaperLive DemosTraining & CertificationTicket
    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 Database
    3. SQL
    4. V4.3.1
    iconOceanBase Database
    SQL - V 4.3.1
    Databases
    • OceanBase Database
    • OceanBase Cloud
    • OceanBase Tugraph
    • Interactive Tutorials
    • OceanBase Best Practices
    Tools
    • OceanBase Cloud Platform
    • OceanBase Migration Service
    • OceanBase Developer Center
    • OceanBase Migration Assessment
    • OceanBase Admin Tool
    • OceanBase Loader and Dumper
    • OceanBase Deployer
    • Kubernetes operator for OceanBase
    • OceanBase Diagnostic Tool
    • OceanBase Binlog Service
    Connectors and Middleware
    • OceanBase Database Proxy
    • Embedded SQL in C for OceanBase
    • OceanBase Call Interface
    • OceanBase Connector/C
    • OceanBase Connector/J
    • OceanBase Connector/ODBC
    • OceanBase Connector/NET
    SQL
    KV
    • V 4.6.0
    • V 4.4.2
    • V 4.3.5
    • V 4.3.3
    • V 4.3.1
    • V 4.3.0
    • V 4.2.5
    • V 4.2.2
    • V 4.2.1
    • V 4.2.0
    • V 4.1.0
    • V 4.0.0
    • V 3.1.4 and earlier

    Manage DBLinks

    Last Updated:2026-04-15 08:25:15  Updated
    Share
    What is on this page
    Enable or disable the DBLink feature
    Configure the reusability of connections to remote databases over DBLinks

    folded

    Share

    OceanBase Database provides parameters for managing DBLinks. You can enable or disable the DBLink feature based on your business strategies and modify the reusability of connections to remote databases based on your business requirements.

    Enable or disable the DBLink feature

    You can specify the enable_dblink parameter to enable or disable the DBLink feature for a cluster. The default value is True. The value True indicates to enable the DBLink feature. The value False indicates to disable the DBLink feature. If you attempt to use the DBLink feature when this parameter is set to False, the OB_OP_NOT_ALLOW error will be returned, indicating that the operation is not allowed.

    For more information about the enable_dblink parameter, see enable_dblink.

    Here is an example:

    Log on to the sys tenant and specify whether to enable or disable the DBLink feature.

    • Enable the DBLink feature.

      ALTER SYSTEM SET enable_dblink = True;
      
    • Disable the DBLink feature.

      Note

      The enable_dblink parameter takes effect on a cluster. You do need to disable the DBLink feature unless otherwise required.

      ALTER SYSTEM SET enable_dblink = False;
      

    Configure the reusability of connections to remote databases over DBLinks

    You can specify the hidden parameter _enable_dblink_reuse_connection to control the reusability of connections over DBLinks. The value True indicates to allow you to reuse the connection to a remote database within the same session to improve efficiency and performance. In this case, the connection is a persistent connection. When the network environment is unstable or abnormal, you can set this parameter to False to require that a new connection be established for each access to the remote database to avoid connection errors. In this case, the connection is a short-lived connection.

    Attribute
    Description
    Parameter type Integer
    Default value 1, which indicates to enable reuse of connections.
    Value range 0 or 1.
    • 1: indicates to enable reuse of connections.
    • 0: indicates to disable reuse of connections.
    Effective mode Immediate
    Level Tenant level

    Here is an example:

    • Execute the following statement in a user tenant to disable reuse of connections over a DBLink in a session.

      ALTER SYSTEM SET "_enable_dblink_reuse_connection" = 0;
      
    • Execute the following statement in a user tenant to enable reuse of connections over a DBLink in a session.

      ALTER SYSTEM SET "_enable_dblink_reuse_connection" = 1;
      

    Previous topic

    Query existing DBLinks
    Last

    Next topic

    Use a DBLink to access data in a remote database
    Next
    What is on this page
    Enable or disable the DBLink feature
    Configure the reusability of connections to remote databases over DBLinks