跳到主要内容
版本：V1.1.0

createDatabase - 创建数据库

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

信息

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

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

前提条件​

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

  • 您已经安装了 seekdb 服务器模式，有关安装 seekdb 服务器模式的详细信息，参见 通过 yum install 部署 seekdb。

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

  • 请确保连接的用户具备 CREATE 权限。查看当前用户权限的相关操作请参见 查看用户权限。如果不具备该权限，请联系管理员为您授权，用户授权的相关操作请参见 直接授予权限。

创建数据库的限制​

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

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

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

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

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

创建数据库的建议​

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

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

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

请求参数​

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

请求示例​

import { SeekdbAdminClient } from "seekdb";

// 远程服务器模式 - 数据库管理 (seekdb Server)
const admin = new SeekdbAdminClient({
  host: "127.0.0.1",
  port: 2881,
  user: "root",
  password: ""
});

await admin.createDatabase("my_database");

返回参数​

无

相关操作​

Contents

编辑此页