Apache Doris 数据库创建指南：CREATE DATABASE 详解

概述

在 Apache Doris 分布式分析数据库中，数据库(DATABASE)是组织和管理表(TABLE)的基本单位。本文将详细介绍如何使用 CREATE DATABASE 语句创建新的数据库，并深入解析相关参数和注意事项。

CREATE DATABASE 基础语法

创建数据库的基本语法如下：

CREATE DATABASE [IF NOT EXISTS] <db_name>
    [PROPERTIES ("<key>"="<value>"[, ... ])];

参数说明

1. 必选参数：

   • <db_name>：要创建的数据库名称，需遵循标识符命名规则

2. 可选参数：

   • IF NOT EXISTS：如果数据库已存在，则不会报错
   • PROPERTIES：数据库的附加属性配置

权限要求

执行 CREATE DATABASE 命令需要用户具备以下权限：

权限类型	作用对象	说明
CREATE_PRIV	目标数据库	对目标数据库的创建权限

高级属性配置

副本分布策略

在分布式环境中，可以指定数据库的默认副本分布策略：

CREATE DATABASE `db_test`
PROPERTIES (
    "replication_allocation" = "tag.location.group_1:3"
);

注意：如果在表级别指定了副本分布策略，表的设置会覆盖数据库级别的默认设置。

存储仓库设置

从 Apache Doris 3.0.5 版本开始，支持在数据库级别设置默认存储仓库：

CREATE DATABASE `db_test`
PROPERTIES (
    "storage_vault_name" = "hdfs_demo_vault"
);

优先级说明：与副本分布策略类似，表级别的存储仓库设置会覆盖数据库级别的默认设置。

实际应用示例

基础创建示例

创建一个名为 sales 的简单数据库：

CREATE DATABASE sales;

带容错机制的创建

防止重复创建导致的错误：

CREATE DATABASE IF NOT EXISTS sales;

完整配置示例

创建一个配置了副本分布和存储仓库的数据库：

CREATE DATABASE `production_db`
PROPERTIES (
    "replication_allocation" = "tag.location.default:3",
    "storage_vault_name" = "hdfs_prod_vault"
);

最佳实践建议

1. 命名规范：

   • 使用有意义的名称，反映数据库用途
   • 避免使用特殊字符和保留关键字
   • 保持命名风格一致（如全小写或驼峰式）

2. 权限管理：

   • 创建数据库后立即设置适当的访问权限
   • 遵循最小权限原则分配用户权限

3. 资源配置：

   • 根据数据重要性和访问频率设置合理的副本数
   • 考虑数据冷热分离策略，合理配置存储仓库

4. 环境隔离：

   • 为开发、测试和生产环境创建不同的数据库
   • 使用前缀或后缀区分不同环境的数据库

常见问题解答

Q：创建数据库后如何修改属性？ A：可以使用 ALTER DATABASE 语句修改数据库属性。

Q：数据库名称是否有长度限制？ A：通常限制在64个字符内，具体取决于系统配置。

Q：是否可以重命名数据库？ A：Apache Doris 不支持直接重命名数据库，需要创建新库后迁移数据。

Q：如何查看已创建的数据库？ A：使用 SHOW DATABASES 命令可以列出所有数据库。

通过本文的介绍，您应该已经掌握了在 Apache Doris 中创建数据库的各种方法和技巧。合理规划数据库结构是构建高效数据分析系统的重要基础，建议在实际应用中结合业务需求进行设计。