---
title: "SERVICE_NAME - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: "SERVICE_NAME 描述 ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE ... 语句用于维护 SERVICE_NAME （服务名），控制 SERVICE_NAME 的创建、删除、启动和停止等操作。 说明 通过 OCP 进行服务名管理和主备切换操作，参…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS

# SERVICE_NAME

更新时间：2026-04-15 23:07:34

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/3650.service-name.md)  

## 描述

`ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE ...` 语句用于维护 `SERVICE_NAME`（服务名），控制 `SERVICE_NAME` 的创建、删除、启动和停止等操作。

#### 说明

通过 OCP 进行服务名管理和主备切换操作，参见 [主备租户日常切换](https://www.oceanbase.com/docs/common-ocp-1000000001127007)。

## 使用限制及注意事项

- `META`/`SYS` 租户不支持 `SERVICE_NAME` 功能。
 - OceanBase 云平台（OceanBase Cloud Platform，OCP）保证了在其管理的集群范围内，一个 `SERVICE_NAME` 下只能有一个主租户，用户黑屏设置 `SERVICE_NAME` 需要自行保证。
 - `FAILOVER` 操作自动删除租户下所有 `SERVICE_NAME`。
 - 一个租户最多有一个 `SERVICE_NAME`。
 - 通过 `SERVICE_NAME` 建立的连接，不允许执行 `SERVICE_NAME` 和租户主备角色转换有关运维命令，否则会报 `OB_OP_NOT_ALLOW` 错误。

## 权限要求

执行该语句的用户需要拥有 `ALTER SYSTEM` 权限。有关 OceanBase 数据库权限的详细介绍，请参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016100) 和 [Oracle 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016087)。

## 语法

```sql
ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE service_name [tenant = 'tenant_name'];

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| CREATE | 创建服务。创建服务后，自动启动服务。 |
| DELETE | 删除服务。删除服务前，服务需要已经被停止。 |
| START | 启动服务。启动服务后，可以通过本 `SERVICE_NAME` 建 Session 或者允许请求。 |
| STOP | 停止服务。停止服务后，既不存在通过该 `SERVICE_NAME` 启动的 Session，也不能通过该 `SERVICE_NAME` 建立新的 Session。 |
| service_name | 指定服务名称。 |
| tenant_name | 可选项，指定待操作的租户。如果不显式指定待操作的租户，则默认租户名为当前租户。   #### 注意    系统租户不支持 `SERVICE_NAME` 功能，即在系统租户下执行时该语句时，必须指定 `TENANT = tenant_name` 子句。 |

## 示例

为租户 `mysql001` 创建服务 `service_mysql001`。

```sql
ALTER SYSTEM CREATE SERVICE service_mysql001 TENANT = 'mysql001';

```

## 相关文档

- 使用视图查询租户的 `SERVICE_NAME` 及其状态的信息，参见 [DBA_OB_SERVICES](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014441) 或 [oceanbase.CDB_OB_SERVICES](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014624)。
 - 使用视图指定 `MODULE` 为 `SERVICE NAME` 查询 `SERVICE_NAME` 有关运维命令的执行情况，参见 [DBA_OB_TENANT_EVENT_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014229) 或 [oceanbase.CDB_OB_TENANT_EVENT_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014729)。
 - 有关 `SERVICE_NAME` 运维命令的介绍信息，参见 [创建服务](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013585)。
 - 使用 `SERVICE_NAME` 连接到租户的介绍信息，参见 [通过 OBClient 连接 OceanBase 租户（MySQL 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013251) 或 [通过 OBClient 连接 OceanBase 租户（Oracle 模式）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013208)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线