尧图网站建设 
数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载本篇技术指南围绕 Gel 官方 CLI 的gel extension install命令展开系统讲解如何为本地项目管理的实例安装独立扩展包standalone extension覆盖命令语法、参数、全局连接选项、完整工作流查询可用扩展 → 安装 → 重启实例 → 在 schema 中声明以及底层源码实现原理。读完本文你将能够熟练管理postgis等独立扩展包并理解扩展版本解析、ext::模块约束等内部机制。命令概述一条命令安装独立扩展gel extension install是 Gel CLI 中gel extension命令组命令组索引的子命令之一用于在本地项目管理的实例上安装独立扩展包。与edgeql_http、graphql、auth、ai、pg_trgm、pg_unaccent、pgcrypto、pgvector等随服务器内置的扩展不同独立扩展以**独立的包package**形式存在需要通过 CLI 从扩展仓库下载并安装到本地实例上postgis是最典型的代表详见 Extensions 文档 中 Standalone extensions 一节。gel extension命令组共包含四个子命令构成完整的生命周期管理能力子命令作用gel extension list列出已安装的扩展参考文档gel extension list-available列出当前可安装的扩展参考文档gel extension install安装扩展参考文档gel extension uninstall卸载扩展参考文档命令语法与参数gel extension install的命令形式如下install.rstgel extension install extension [options]位置参数extensionextension是要安装的扩展名称为必填参数。例如要安装postgis直接将其作为参数传入$ gel extension install postgis Found extension package: postgis version 3.4.36b82d77 00:00:03 [] 22.49 MiB/22.49 MiB Extension postgis installed successfully.命令执行时会依次完成以下动作发现扩展包从扩展仓库解析出指定名称的扩展包及其版本如postgis的3.4.36b82d77下载安装以进度条形式显示下载进度与包体大小示例中为22.49 MiB完成安装输出Extension postgis installed successfully.确认成功。其中版本号3.4.36b82d77是扩展包自身的版本标识3.4.3对应上游 PostgreSQL 扩展PostGIS的版本6b82d77则是扩展包构建对应的提交标识用于精确锁定某个构建产物。选项全局连接选项gel extension install本身没有额外的专属选项但它接受与所有 Gel CLI 命令一致的全局连接选项Connection options用于指定命令所作用的实例目标。这些选项的完整说明见 Connection flags 文档常用选项包括选项说明-I name, --instancename指定要连接的命名实例Gel Cloud 实例名为org-name/instance-name格式--dsndsn指定连接 DSN除密码外覆盖其他所有选项-H hostname, --hosthostname服务器主机名默认取HOST环境变量-P port, --portportTCP 端口默认取PORT环境变量未设置时为5656-b branch_name, --branchbranch_name连接的 branch 名称默认取BRANCH环境变量本地实例默认使用最近切换的 branch 或main-u username, --userusername连接用户名默认取USER环境变量未设置时为管理员用户--password / --no-password强制提示密码 / 禁用密码提示--tls-security modeTLS 安全模式default、strict、no_host_verification、insecure--wait-until-availabletime连接失败时持续重试超时值需带时间单位如30s--connect-timeouttime连接超时默认10s连接目标的解析优先级为显式连接参数flag→ 环境变量 → 当前目录是否处于与实例关联的项目目录内若三者均无法确定命令会失败。例如为指定本地实例安装postgis$ gel extension install postgis -I my_instance完整实战流程从查询到使用独立扩展的安装并非一条命令即告结束完整流程包含以下步骤对应 Extensions 文档 的实操示例。1. 查看当前已安装的扩展$ gel extension list ┌─────────┬───────────────┐ │ Name │ Version │ └─────────┴───────────────┘新实例默认没有安装任何独立扩展因此列表为空。2. 查询可安装的扩展$ gel extension list-available ┌─────────┬───────────────┐ │ Name │ Version │ │ postgis │ 3.4.36b82d77 │ └─────────┴───────────────┘list-available会列出当前实例可用的扩展包及版本可作为安装前的查询手段。3. 安装扩展$ gel extension install postgis Found extension package: postgis version 3.4.36b82d77 00:00:03 [] 22.49 MiB/22.49 MiB Extension postgis installed successfully.4. 验证安装结果$ gel extension list ┌─────────┬───────────────┐ │ Name │ Version │ │ postgis │ 3.4.36b82d77 │ └─────────┴───────────────┘5. 重启实例安装完成后务必重启实例以使扩展生效$ gel instance restart6. 在 schema 中声明扩展独立扩展与内置扩展的声明方式一致在 schema 顶层添加using语句using extension postgis;注意using extension声明必须位于任何 module 块之外因为扩展影响的是整个数据库branch而非某个特定模块。7. 使用扩展安装并声明后扩展提供的类型、标量、函数等即可在 EdgeQL 查询和 schema 定义中使用。以postgis为例它提供地理空间数据类型与函数可用于存储和查询地理信息。卸载扩展如需卸载使用gel extension uninstalluninstall.rst$ gel extension uninstall postgis Extension postgis uninstalled successfully.与 schema 层扩展声明的协同值得强调的是CLI 的gel extension install与 schema 中的扩展机制是两个层面、相辅相成的关系CLI 层包安装gel extension install负责把扩展包二进制下载并安装到本地实例中属于实例级操作Schema 层声明启用using extension postgis;或 DDL 中的create extension graphql;负责在具体 schema 中启用扩展属于schema 级操作。在 Extensions 文档 中可以看到内置扩展如graphql、edgeql_http直接通过using extension或create extension启用即可而独立扩展必须先通过 CLI 完成包安装然后才能在 schema 中声明。文档中明确给出对应的底层 DDL 命令主要用于审查迁移文件create extension graphql; create extension edgeql_http; drop extension graphql;备份恢复注意事项一个重要的运维细节恢复restore使用了独立扩展的 dump 时必须先安装对应的扩展再执行恢复流程。否则恢复过程会因为缺少扩展包而失败Extensions 文档 中的 note 明确指出了这一点。因此在跨环境迁移时应先在目标实例上执行gel extension install ext再执行gel restore。源码级原理扩展包是如何被解析与管理的理解底层实现有助于排查问题。扩展的包管理逻辑集中在 edb/schema/extensions.py 中。扩展包模型版本是核心字段ExtensionPackage是扩展包在 schema 中的表示其核心字段是versionextensions.py 第 47-62 行class ExtensionPackage(...): ... version so.SchemaField( ... )每个扩展包实例都携带独立的版本信息因此同一扩展的不同版本可以在 schema 中以多个包的形式共存。版本解析精确匹配与取最新扩展包解析逻辑位于get_package()函数extensions.py 第 225-264 行。从源码结构可以推断其行为当 schema 中存在指定版本时优先使用精确版本若没有精确匹配则取可用的最新版本若指定版本不存在且没有更旧的可用版本会抛出错误并提示extension package ... version ... does not exist。这意味着gel extension install下载的版本由远程仓库与本地 schema 状态共同决定Found extension package: postgis version 3.4.36b82d77这行输出正是版本解析完成后的结果展示。ext::模块前缀约束扩展包声明了ext_module字段extensions.py 第 86 行表示扩展导出的模块。源码中对模块名有强制约束扩展模块必须以ext::开头extensions.py 第 645-653 行 附近if module_name.get_root_module_name() ! s_schema.EXT_MODULE: raise ... fmodule {module}: fextension modules must begin with ext::这也是为什么postgis等扩展的模块均以ext::前缀暴露给用户。例如内置的pg_trgm、pg_unaccent、pgcrypto、pgvector分别对应ext::pg_trgm、ext::pg_unaccent、ext::pgcrypto、ext::pgvector模块Extensions 文档。卸载时的模块清理卸载扩展gel extension uninstall时schema 层会执行对应的ExtensionPackageCommandextensions.py 第 205 行 附近其删除逻辑extensions.py 第 859-933 行 附近会获取扩展包对应的模块名get_ext_module若扩展携带模块删除该模块及其子模块下的全部对象保留__ext_casts__、__ext_index_matches__等内部模块中由扩展产生的类型转换和索引匹配定义避免误删。这一重手笔的模块级清理策略保证了卸载后 schema 中不会残留扩展遗留的对象。安装前置条件与适用范围在使用gel extension install之前请确认以下前提实例类型独立扩展包目前支持安装在本地项目管理的实例上Extensions 文档 中明确表述为 local project-managed instances连接可达命令通过全局连接选项定位目标实例需确保连接参数正确实例、DSN、host/port、branch 等重启生效安装完成后需执行gel instance restart使扩展可用dump 恢复顺序恢复含独立扩展的 dump 前先安装对应扩展。总结gel extension install extension是 Gel 独立扩展包管理的核心入口它完成了从远程仓库发现包、解析版本、下载安装到本地实例的全过程。将其与list、list-available、uninstall配合使用再加上安装后的实例重启与 schema 中的using extension声明即可完整地管理postgis等独立扩展。在底层edb/schema/extensions.py 通过带版本字段的ExtensionPackage模型、精确/最新版本解析逻辑以及ext::模块前缀约束保证了扩展包在 schema 层的正确表示与生命周期管理。赞分享数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载相关推荐requests库源码解析核心Request和Response结构体探秘requests库源码解析核心Request和Response结构体探秘 在Go语言开发中HTTP客户端库是构建网络应用的基础组件。 requests库 作数据库图数据库关系型数据库Gel CLI gel extension uninstall 命令详解扩展卸载与生命周期管理Gel CLI gel extension uninstall 命令详解扩展卸载与生命周期管理 gel extension uninstall 是 Gel前数据库图数据库关系型数据库Gel 扩展管理深入掌握 gel extension list 命令与独立扩展的安装生命周期Gel 扩展管理深入掌握 gel extension list 命令与独立扩展的安装生命周期 gel extension list 是 Gel 命令行工具数据库图数据库关系型数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gel CLI 扩展安装完全指南：`gel extension install` 命令用法、原理与实战
数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载本篇技术指南围绕 Gel 官方 CLI 的gel extension install命令展开系统讲解如何为本地项目管理的实例安装独立扩展包standalone extension覆盖命令语法、参数、全局连接选项、完整工作流查询可用扩展 → 安装 → 重启实例 → 在 schema 中声明以及底层源码实现原理。读完本文你将能够熟练管理postgis等独立扩展包并理解扩展版本解析、ext::模块约束等内部机制。命令概述一条命令安装独立扩展gel extension install是 Gel CLI 中gel extension命令组命令组索引的子命令之一用于在本地项目管理的实例上安装独立扩展包。与edgeql_http、graphql、auth、ai、pg_trgm、pg_unaccent、pgcrypto、pgvector等随服务器内置的扩展不同独立扩展以**独立的包package**形式存在需要通过 CLI 从扩展仓库下载并安装到本地实例上postgis是最典型的代表详见 Extensions 文档 中 Standalone extensions 一节。gel extension命令组共包含四个子命令构成完整的生命周期管理能力子命令作用gel extension list列出已安装的扩展参考文档gel extension list-available列出当前可安装的扩展参考文档gel extension install安装扩展参考文档gel extension uninstall卸载扩展参考文档命令语法与参数gel extension install的命令形式如下install.rstgel extension install extension [options]位置参数extensionextension是要安装的扩展名称为必填参数。例如要安装postgis直接将其作为参数传入$ gel extension install postgis Found extension package: postgis version 3.4.36b82d77 00:00:03 [] 22.49 MiB/22.49 MiB Extension postgis installed successfully.命令执行时会依次完成以下动作发现扩展包从扩展仓库解析出指定名称的扩展包及其版本如postgis的3.4.36b82d77下载安装以进度条形式显示下载进度与包体大小示例中为22.49 MiB完成安装输出Extension postgis installed successfully.确认成功。其中版本号3.4.36b82d77是扩展包自身的版本标识3.4.3对应上游 PostgreSQL 扩展PostGIS的版本6b82d77则是扩展包构建对应的提交标识用于精确锁定某个构建产物。选项全局连接选项gel extension install本身没有额外的专属选项但它接受与所有 Gel CLI 命令一致的全局连接选项Connection options用于指定命令所作用的实例目标。这些选项的完整说明见 Connection flags 文档常用选项包括选项说明-I name, --instancename指定要连接的命名实例Gel Cloud 实例名为org-name/instance-name格式--dsndsn指定连接 DSN除密码外覆盖其他所有选项-H hostname, --hosthostname服务器主机名默认取HOST环境变量-P port, --portportTCP 端口默认取PORT环境变量未设置时为5656-b branch_name, --branchbranch_name连接的 branch 名称默认取BRANCH环境变量本地实例默认使用最近切换的 branch 或main-u username, --userusername连接用户名默认取USER环境变量未设置时为管理员用户--password / --no-password强制提示密码 / 禁用密码提示--tls-security modeTLS 安全模式default、strict、no_host_verification、insecure--wait-until-availabletime连接失败时持续重试超时值需带时间单位如30s--connect-timeouttime连接超时默认10s连接目标的解析优先级为显式连接参数flag→ 环境变量 → 当前目录是否处于与实例关联的项目目录内若三者均无法确定命令会失败。例如为指定本地实例安装postgis$ gel extension install postgis -I my_instance完整实战流程从查询到使用独立扩展的安装并非一条命令即告结束完整流程包含以下步骤对应 Extensions 文档 的实操示例。1. 查看当前已安装的扩展$ gel extension list ┌─────────┬───────────────┐ │ Name │ Version │ └─────────┴───────────────┘新实例默认没有安装任何独立扩展因此列表为空。2. 查询可安装的扩展$ gel extension list-available ┌─────────┬───────────────┐ │ Name │ Version │ │ postgis │ 3.4.36b82d77 │ └─────────┴───────────────┘list-available会列出当前实例可用的扩展包及版本可作为安装前的查询手段。3. 安装扩展$ gel extension install postgis Found extension package: postgis version 3.4.36b82d77 00:00:03 [] 22.49 MiB/22.49 MiB Extension postgis installed successfully.4. 验证安装结果$ gel extension list ┌─────────┬───────────────┐ │ Name │ Version │ │ postgis │ 3.4.36b82d77 │ └─────────┴───────────────┘5. 重启实例安装完成后务必重启实例以使扩展生效$ gel instance restart6. 在 schema 中声明扩展独立扩展与内置扩展的声明方式一致在 schema 顶层添加using语句using extension postgis;注意using extension声明必须位于任何 module 块之外因为扩展影响的是整个数据库branch而非某个特定模块。7. 使用扩展安装并声明后扩展提供的类型、标量、函数等即可在 EdgeQL 查询和 schema 定义中使用。以postgis为例它提供地理空间数据类型与函数可用于存储和查询地理信息。卸载扩展如需卸载使用gel extension uninstalluninstall.rst$ gel extension uninstall postgis Extension postgis uninstalled successfully.与 schema 层扩展声明的协同值得强调的是CLI 的gel extension install与 schema 中的扩展机制是两个层面、相辅相成的关系CLI 层包安装gel extension install负责把扩展包二进制下载并安装到本地实例中属于实例级操作Schema 层声明启用using extension postgis;或 DDL 中的create extension graphql;负责在具体 schema 中启用扩展属于schema 级操作。在 Extensions 文档 中可以看到内置扩展如graphql、edgeql_http直接通过using extension或create extension启用即可而独立扩展必须先通过 CLI 完成包安装然后才能在 schema 中声明。文档中明确给出对应的底层 DDL 命令主要用于审查迁移文件create extension graphql; create extension edgeql_http; drop extension graphql;备份恢复注意事项一个重要的运维细节恢复restore使用了独立扩展的 dump 时必须先安装对应的扩展再执行恢复流程。否则恢复过程会因为缺少扩展包而失败Extensions 文档 中的 note 明确指出了这一点。因此在跨环境迁移时应先在目标实例上执行gel extension install ext再执行gel restore。源码级原理扩展包是如何被解析与管理的理解底层实现有助于排查问题。扩展的包管理逻辑集中在 edb/schema/extensions.py 中。扩展包模型版本是核心字段ExtensionPackage是扩展包在 schema 中的表示其核心字段是versionextensions.py 第 47-62 行class ExtensionPackage(...): ... version so.SchemaField( ... )每个扩展包实例都携带独立的版本信息因此同一扩展的不同版本可以在 schema 中以多个包的形式共存。版本解析精确匹配与取最新扩展包解析逻辑位于get_package()函数extensions.py 第 225-264 行。从源码结构可以推断其行为当 schema 中存在指定版本时优先使用精确版本若没有精确匹配则取可用的最新版本若指定版本不存在且没有更旧的可用版本会抛出错误并提示extension package ... version ... does not exist。这意味着gel extension install下载的版本由远程仓库与本地 schema 状态共同决定Found extension package: postgis version 3.4.36b82d77这行输出正是版本解析完成后的结果展示。ext::模块前缀约束扩展包声明了ext_module字段extensions.py 第 86 行表示扩展导出的模块。源码中对模块名有强制约束扩展模块必须以ext::开头extensions.py 第 645-653 行 附近if module_name.get_root_module_name() ! s_schema.EXT_MODULE: raise ... fmodule {module}: fextension modules must begin with ext::这也是为什么postgis等扩展的模块均以ext::前缀暴露给用户。例如内置的pg_trgm、pg_unaccent、pgcrypto、pgvector分别对应ext::pg_trgm、ext::pg_unaccent、ext::pgcrypto、ext::pgvector模块Extensions 文档。卸载时的模块清理卸载扩展gel extension uninstall时schema 层会执行对应的ExtensionPackageCommandextensions.py 第 205 行 附近其删除逻辑extensions.py 第 859-933 行 附近会获取扩展包对应的模块名get_ext_module若扩展携带模块删除该模块及其子模块下的全部对象保留__ext_casts__、__ext_index_matches__等内部模块中由扩展产生的类型转换和索引匹配定义避免误删。这一重手笔的模块级清理策略保证了卸载后 schema 中不会残留扩展遗留的对象。安装前置条件与适用范围在使用gel extension install之前请确认以下前提实例类型独立扩展包目前支持安装在本地项目管理的实例上Extensions 文档 中明确表述为 local project-managed instances连接可达命令通过全局连接选项定位目标实例需确保连接参数正确实例、DSN、host/port、branch 等重启生效安装完成后需执行gel instance restart使扩展可用dump 恢复顺序恢复含独立扩展的 dump 前先安装对应扩展。总结gel extension install extension是 Gel 独立扩展包管理的核心入口它完成了从远程仓库发现包、解析版本、下载安装到本地实例的全过程。将其与list、list-available、uninstall配合使用再加上安装后的实例重启与 schema 中的using extension声明即可完整地管理postgis等独立扩展。在底层edb/schema/extensions.py 通过带版本字段的ExtensionPackage模型、精确/最新版本解析逻辑以及ext::模块前缀约束保证了扩展包在 schema 层的正确表示与生命周期管理。赞分享数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载相关推荐requests库源码解析核心Request和Response结构体探秘requests库源码解析核心Request和Response结构体探秘 在Go语言开发中HTTP客户端库是构建网络应用的基础组件。 requests库 作数据库图数据库关系型数据库Gel CLI gel extension uninstall 命令详解扩展卸载与生命周期管理Gel CLI gel extension uninstall 命令详解扩展卸载与生命周期管理 gel extension uninstall 是 Gel前数据库图数据库关系型数据库Gel 扩展管理深入掌握 gel extension list 命令与独立扩展的安装生命周期Gel 扩展管理深入掌握 gel extension list 命令与独立扩展的安装生命周期 gel extension list 是 Gel 命令行工具数据库图数据库关系型数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考