V$OB_PARAMETERS

2026-01-09 08:58:56  Updated

Note

This view is introduced since OceanBase Database V4.0.0.

Purpose

The V$OB_PARAMETERS view displays the parameters on the current OBServer node, including hidden parameters whose names start with an underscore.

Columns

Column Type Nullable? Description
SVR_IP varchar(46) NO The IP address of the OBServer node.
SVR_PORT bigint(20) NO The port number of the OBServer node.
ZONE varchar(128) NO The name of the zone.
SCOPE varchar(64) NO The scope of the parameter. Valid values:
  • CLUSTER: indicates a cluster-level parameter.
  • TENANT: indicates a tenant-level parameter.
  • TENANT_ID bigint(20) YES The ID of the tenant. Valid values:
  • NULL: indicates that the parameter does not belong to any tenant.
  • Other valid values: indicates the ID of the tenant.
  • NAME varchar(128) NO The name of the parameter.
    DATA_TYPE varchar(128) YES The type of the parameter value.

    Note

    The value of this column has been changed from NULL to a specific data type since OceanBase Database V4.3.0.

    VALUE varchar(65536) NO The value of the parameter.
    INFO varchar(4096) NO The description of the parameter.
    SECTION varchar(128) NO The module to which the parameter belongs.
    EDIT_LEVEL varchar(128) NO The way for the parameter modification to take effect. Valid values:
  • READONLY: The parameter is read-only and cannot be modified.
  • STATIC_EFFECTIVE: The parameter modification takes effect upon a restart.
  • DYNAMIC_EFFECTIVE: The parameter modification takes effect dynamically.
  • DEFAULT_VALUE varchar(65536) NO The default value of the parameter.

    Note

    • For OceanBase Database V4.3.x, this column was introduced in OceanBase Database V4.3.1.
    • For OceanBase Database V4.2.x, this column was introduced in OceanBase Database V4.2.2.
    ISDEFAULT varchar(3) NO Indicates whether the current value is the default value. Valid values:
    • NO: The current value is not the default value.
    • YES: The current value is the default value.

    Note

    • For OceanBase Database V4.3.x, this column was introduced in OceanBase Database V4.3.1.
    • For OceanBase Database V4.2.x, this column was introduced in OceanBase Database V4.2.2.

    The following table describes the valid values of the DATA_TYPE column.

    Column value Description Example (in the NAME=VALUE format)
    BOOL A Boolean value. enable_ddl=True
    INT An integer. log_disk_percentage=1
    DOUBLE A floating-point number. server_cpu_quota_min=1.0
    STRING A string. leak_mod_to_check='NONE'
    STR_LIST A list of strings separated with semicolons (;). config_additional_dir='etc2;etc3'
    TIME A period of time. merger_check_interval='10m'
    MOMENT A point in time. major_freeze_duty_time='02:00'
    CAPACITY A capacity, for example, 3M or 5G. log_disk_size='0M'
    VERSION A version. compatible='4.3.0.0'
    MODE Indicates whether certain features of OBKV are enabled or disabled. _obkv_feature_mode = 'ttl=off, rerouting=on'

    Sample query

    Query the large_query_threshold parameter on all OBServer nodes of the current tenant.

    obclient [oceanbase]> SELECT * FROM oceanbase.V$OB_PARAMETERS WHERE NAME LIKE '%large_query_threshold%'\G
    

    The query result is as follows:

    *************************** 1. row ***************************
           SVR_IP: 11.xx.xx.xx
         SVR_PORT: 12615
             ZONE: z1
            SCOPE: CLUSTER
        TENANT_ID: NULL
             NAME: large_query_threshold
        DATA_TYPE: TIME
            VALUE: 5s
             INFO: threshold for execution time beyond which a request may be paused and rescheduled as a \'large request\', 0ms means disable \'large request\'. Range: [0ms, +∞)
          SECTION: TENANT
       EDIT_LEVEL: DYNAMIC_EFFECTIVE
    DEFAULT_VALUE: 5s
        ISDEFAULT: NO
    1 row in set
    

    References

    Contact Us