⌘+k ctrl+k
1.4 (LTS)
搜索快捷键 cmd + k | ctrl + k
扩展故障排除

您可能是通过 DuckDB 的错误消息指引来到此页面的,消息内容类似于

INSTALL non_existing;
HTTP Error:
Failed to download extension "non_existing" at URL "http://extensions.duckdb.org/v1.4.0/osx_arm64/non_existing.duckdb_extension.gz" (HTTP 404)

Candidate extensions: "inet", "encodings", "core_functions", "sqlite_scanner", "postgres_scanner"
For more info, visit https://duckdb.org.cn/docs/stable/extensions/troubleshooting?version=v1.4.0&platform=osx_arm64&extension=non_existing

在特定时间,某个扩展程序可能无法在给定的扩展仓库中获取,原因有多种:

  • 扩展程序尚未上传。在发布日期之后,可能需要一段等待时间。请考虑查看 duckdb/duckdbduckdb/community-extensions 的 issue,或自行创建一个。
  • 扩展程序可用,但在不同的仓库中。例如,尝试使用 INSTALL name FROM core;INSTALL name FROM community;INSTALL name FROM core_nightly;(请参阅安装扩展程序页面)。
  • 网络问题,即扩展程序存在于端点,但您的本地 DuckDB 无法访问。您可以尝试直接在浏览器搜索栏中粘贴错误消息中提供的链接,访问该 URL。

如果您使用的是 DuckDB 的开发版本(即运行 PRAGMA versionlibrary_version 不以 v 开头的版本),那么默认扩展仓库中可能不再提供扩展程序。

如有疑问,请考虑在 duckdb/duckdb 中提出 issue。

通过浏览器手动下载扩展程序的流程

要检查扩展程序是否可用,可以尝试下载相关的扩展资源,例如通过浏览器访问 https://extensions.duckdb.org/v1.4.4/osx_arm64/spatial.duckdb_extension.gz 或提供的任何其他链接。请注意,http:// 已被弃用,现已改为使用 https://

如果下载成功,这会将扩展程序下载并解压到默认的 Downloads(下载)文件夹中,以便您可以在 SQL 中运行

INSTALL '~/Downloads/spatial.duckdb_extension';
-- or
FORCE INSTALL '~/Downloads/spatial.duckdb_extension';

执行此命令后,扩展程序即会正常安装。

© 2025 DuckDB 基金会,阿姆斯特丹,荷兰
行为准则 商标使用指南