跳到主要内容

create_database - 创建数据库

create_database() 用于创建一个新的数据库。

信息

  • 仅支持在使用 AdminClient 连接时，才能使用该接口。关于 AdminClient 的详细介绍，参见 Admin Client。

  • 当前通过 create_database 创建数据库，暂不支持指定数据库的属性，会根据各类属性的默认值来创建。如果您希望创建指定属性的数据库，可以尝试通过 SQL 的方式创建。有关通过 SQL 创建数据库的详细介绍，参见 创建数据库。

前提条件​

  • 您已经安装了 pyseekdb，有关安装 pyseekdb 的详细信息，参见 快速开始。

  • 您已经连接到数据库。有关连接的详细操作参见 Admin Client。

  • 如果您使用的是服务器模式的 seekdb 或者 OceanBase 数据库，请确保连接的用户具备 CREATE 权限。查看当前用户权限的相关操作请参见 查看用户权限。如果不具备该权限，请联系管理员为您授权，用户授权的相关操作请参见 直接授予权限。

创建数据库的限制​

  • 在 seekdb 实例/OceanBase 数据库中，每个数据库的名称必须保证全局唯一。

  • 数据库名长度限制不超过 128 个字符。

  • 只包含大小写字母、数字、下划线、美元符号和中文字符。

  • 避免使用保留关键字作为数据库名。

    有关保留关键字的详细信息，请参见 预留关键字。

创建数据库的建议​

  • 建议给数据库起一个有意义的名字，尽量能够反映其用途和内容。例如，使用 应用标识_子应用名（可选）_db 作为数据库名称。

  • 建议使用 root 用户创建数据库和相关用户，并且只赋予必要的权限，以确保数据库的安全性和可控性。

  • 可以通过使用反引号 (`) 包围的方式来创建以纯数字命名的数据库名，但这种做法并不推荐，因为纯数字命名无较明显意义，且查询使用都需要加反引号 (`)，这也将导致在使用时出现不必要的复杂性，易引起混淆。

请求参数​

create_database(name, tenant=DEFAULT_TENANT)
参数取值类型是否必选描述取值示例
namestring必选指定要创建的数据库的名称。my_database
tenantstring可选
  • 当使用嵌入式 seekdb 和服务器模式 seekdb 时，不需要填写该参数。
  • 当使用 OceanBase 数据库时，该参数必选。
指定所创建的数据库归属的租户。test_tenant

请求示例​

import pyseekdb

# Embedded mode
admin = pyseekdb.AdminClient(path="./seekdb")

# Create database
admin.create_database("my_database")

返回参数​

无

相关操作​

Contents

编辑此页