数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载gel database create是 Gel原 EdgeDB命令行工具中用于创建新数据库的终端命令其行为与 EdgeQL 语句create database完全等价。本文以 docs/reference/using/cli/gel_database/gel_database_create.rst 为骨架结合仓库源码edb/schema/database.py、edb/edgeql/parser/grammar/ddl.py与 CLI 连接选项文档完整讲解命令语法、参数含义、底层实现原理并给出 EdgeDB 5.0 引入 branches 后如何平滑迁移到gel branch create的实战方案。一、命令概览与弃用说明gel database create用于创建新的数据库命令完整语法如下gel database create [options] name其中name是新数据库的名称。该命令运行在你所连接到的 Gel 实例上因此与连接目标相关的参数如实例名、主机、端口、用户名等全部适用详见下文连接选项一节。重要该命令在 Gel 中已被弃用deprecated。官方建议改用gel branch create对应文档为 docs/reference/using/cli/gel_branch/gel_branch_create.rst。原因是 EdgeDB 5.0 引入了branches分支概念来取代 databases数据库相关背景可参见 docs/reference/datamodel/branches.rst 与 docs/intro/branches.rst。适用版本边界gel database create仅适用于EdgeDB 5.0 之前的实例版本如果你运行的是新版 GelEdgeDB 5.0 及以后请改用gel branch create交互式 shellgel中的\database create NAME反斜杠命令同样仅适用于旧版本实例5.0 及以后版本应使用\branch create NAME参见 docs/reference/using/cli/gel.rst 中的 Database 与 Branch 小节。二、功能说明与create database语句等价根据原文档的明确描述gel database create是create databaseEdgeQL 语句的终端命令等价形式。也就是说下面的两种方式在旧版本实例上效果相同# 方式一CLI 命令 gel database create mydb # 方式二EdgeQL 语句通过 shell 管道或交互式执行 cat EOF | gel create database mydb; EOF这种CLI 命令 ↔ EdgeQL 语句的对应关系在源码中可以得到印证。在 edb/schema/database.py 中模式层通过CreateBranch命令类处理数据库/分支创建class CreateBranch(BranchCommand, sd.CreateExternalObject[Branch]): astnode qlast.CreateDatabase # 对应 EdgeQL 的 CreateDatabase AST 节点 template struct.Field(str, defaultNone) branch_type struct.Field( qlast.BranchType, defaultqlast.BranchType.EMPTY)从源码结构看EdgeQL 语法层面的CREATE DATABASE语句在 edb/edgeql/parser/grammar/ddl.py 中由CreateDatabaseStmt非终结符解析归约为qlast.CreateDatabaseAST 节点再交由上述命令类执行。这从实现层面验证了文档所述终端命令等价于create database语句的说法。三、参数详解位置参数namegel database create namename是要创建的新数据库的名称为必填位置参数数据库名称需遵循 Gel 的命名规范且长度不得超过MAX_NAME_LENGTH。该限制在 edb/schema/database.py 的_validate_name方法中强制校验def _validate_name(self, schema, context) - None: name self.get_attribute_value(name) if len(str(name)) s_def.MAX_NAME_LENGTH: span self.get_attribute_span(name) raise errors.SchemaDefinitionError( fBranch names longer than {s_def.MAX_NAME_LENGTH} fcharacters are not supported, spanspan, )从源码看超出长度限制的命名会抛出SchemaDefinitionError校验逻辑同时复用于CreateBranch与AlterBranch两个命令类。四、连接选项Connection Optionsgel database create在被连接的 Gel 实例上执行因此需要先建立连接。原文档明确指出连接目标的指定方式参见 CLI 的 connection optionsdocs/reference/using/cli/gel.rst。常用连接参数整理如下选项说明-I name, --instancename连接指定名称的实例实际连接参数存储在gel_config_dir/credentials中通常由gel instance create等命令生成。覆盖 host 和 port。运行gel info可查看配置目录位置--dsndsn通过 DSN 字符串连接覆盖除密码外的所有其他选项--credentials-file /path/to/file使用 JSON 凭据文件连接-H hostname, --hosthostname服务器主机名默认取GEL_HOST环境变量-P port, --portport服务器 TCP 端口默认取GEL_PORT环境变量未设置时为5656-u username, --userusername连接用户名默认取GEL_USER环境变量或当前系统登录名-b branch-name, --branchbranch-name要连接的数据库分支名。旧版本实例使用-d dbname, --databasedbname--password / --no-password强制提示密码 / 禁用密码提示--password-from-stdin将标准输入的第一行作为密码--tls-ca-file /path/to/cert用于校验服务器的证书文件--tls-security modeTLS 安全模式default、strict、no_host_verification、insecure--wait-until-availablewait_time连接失败时持续重试直到超过指定时长如30s--connect-timeouttimeout连接超时时间默认10s需带时间单位如hr、min、sec、ms典型用法示例# 在默认本地实例上创建数据库 gel database create mydb # 连接指定实例后创建数据库 gel -I my_instance database create mydb # 通过主机与端口连接后创建 gel -H 127.0.0.1 -P 5656 -u admin database create mydb注意gel database create在当前 Gel 5.0 版本中已弃用以上示例适用于运行 EdgeDB 5.0 之前版本的实例。五、交互式 shell 中的对应命令除独立的 CLI 命令外Gel 交互式 shellgel同样提供了对应的反斜杠命令。在旧版本实例上可用\database create NAME该命令创建名为NAME的数据库语义与gel database create一致。而在 EdgeDB 5.0 及以后版本中应改用\branch create NAME后者镜像了gel branch create的全部选项详见 docs/reference/using/cli/gel.rst 的 Branch 小节。shell 中还可以用\l列出实例上的所有分支5.0或数据库旧版本便于创建前后核对。六、从gel database create迁移到gel branch create由于 EdgeDB 5.0 起 databases 已被 branches 取代新建环境或升级后应直接使用gel branch create。其语法为gel branch create [options] name根据 docs/reference/using/cli/gel_branch/gel_branch_create.rstbranch create在无任何选项时等价于create schema branchEdgeQL 语句其参数比旧的database create更丰富选项说明name新分支的名称必填--from oldbranch可选的基础分支新分支基于其创建。默认取$CONFIG/credentials中指定的当前分支-e, --empty创建无 schema、无数据的分支--copy-data将基础分支的数据复制到新分支使用示例# 基于当前分支创建新分支继承当前分支的 schema gel branch create mybranch # 基于指定分支创建 gel branch create mybranch --from main # 创建空分支无 schema、无数据 gel branch create scratch -e # 复制基础分支的数据创建新分支 gel branch create backup --copy-data从源码实现看CreateBranch命令类的branch_type字段qlast.BranchType.EMPTY等正是-e/--empty选项在模式层的落点当分支类型为TEMPLATE且不在测试模式下时会抛出EdgeQLSyntaxError而普通创建默认使用EMPTY类型edb/schema/database.py 中的逻辑保证了这一点。对于旧版gel database create的所有使用场景gel branch create配合--from、-e、--copy-data都能提供对等的甚至更灵活的能力因此官方将其作为替代方案。七、相关命令与进一步阅读gel database命令组还包含其他数据库管理工具docs/reference/using/cli/gel_database/index.rstgel database drop— 删除数据库gel database wipe— 清空数据库内容对应的分支版命令为gel branch drop、gel branch wipe位于 docs/reference/using/cli/gel_branch/ 目录。此外DropBranch命令类在源码层面还保护了EDGEDB_SPECIAL_DBS中的系统数据库禁止删除这一点在 edb/schema/database.py 的_validate_legal_command方法中有明确校验。如需深入理解数据库/分支的底层实现建议阅读edb/schema/database.py —Branch、CreateBranch、DropBranch等命令类的模式层实现edb/edgeql/parser/grammar/ddl.py —CreateDatabaseStmt等 DDL 语法解析规则docs/reference/using/cli/gel.rst — 完整的 CLI 连接选项与反斜杠命令参考docs/intro/branches.rst — branches 概念的入门介绍。八、总结gel database create是旧版 EdgeDB5.0 之前上创建数据库的标准命令语法简单、与create databaseEdgeQL 语句等价并在源码层通过CreateDatabaseAST 节点与CreateBranch命令类实现。由于 EdgeDB 5.0 用 branches 取代了 databases该命令已被弃用官方与源码均指向功能更强大的gel branch create作为替代——后者在保留创建语义的同时额外提供了--from、-e/--empty、--copy-data等选项能够覆盖并超越旧命令的全部使用场景。理解两者的关系与迁移路径有助于你在新旧版本 Gel 实例上正确、高效地管理数据空间。赞分享数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载相关推荐Gel gel migration extract 命令详解从数据库恢复迁移历史到 dbschema/migrationsGel gel migration extract 命令详解从数据库恢复迁移历史到 dbschema/migrations gel migration ext数据库图数据库关系型数据库Gel CLI gel database 命令组详解兼容旧版数据库管理命令的完整使用指南Gel CLI gel database 命令组详解兼容旧版数据库管理命令的完整使用指南 导读 gel database 是 Gel前身 EdgeDB命令数据库图数据库关系型数据库Gel 分支管理命令完整指南gel branch 实战手册Gel 分支管理命令完整指南gel branch 实战手册 GelEdgeDB 的下一代名称通过内置的 分支branch 机制将 Git 风格的版本数据库图数据库关系型数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考