Zum Inhalt springen

Fehlerbehebung bei Erweiterungen

Möglicherweise kommen Sie auf diese Seite über eine DuckDB-Fehlermeldung, ähnlich wie:

INSTALL non_existing;
Terminal window
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/docs/stable/extensions/troubleshooting?version=v1.4.0&platform=osx_arm64&extension=non_existing

Es gibt mehrere Szenarien, in denen eine Erweiterung zu einem bestimmten Zeitpunkt in einem gegebenen Erweiterungs-Repository nicht verfügbar sein kann:

  • Die Erweiterung wurde noch nicht hochgeladen; nach einem Release-Datum kann eine gewisse Verzögerung erwartet werden. Schauen Sie in die Issues von duckdb/duckdb oder duckdb/community-extensions, oder legen Sie selbst eines an.
  • Die Erweiterung ist verfügbar, aber in einem anderen Repository; versuchen Sie beispielsweise INSTALL ⟨name⟩ FROM core;{:.language-sql .highlight} oder INSTALL ⟨name⟩ FROM community;{:.language-sql .highlight} oder INSTALL ⟨name⟩ FROM core_nightly;{:.language-sql .highlight} (siehe die Seite Erweiterungen installieren).
  • Netzwerkprobleme: Die Erweiterung existiert am Endpunkt, ist aber von Ihrem lokalen DuckDB aus nicht erreichbar. Hier können Sie versuchen, die angegebene URL direkt im Browser aufzurufen, indem Sie den Link aus der Fehlermeldung in die Adresszeile einfügen.

Wenn Sie eine Entwicklungsversion von DuckDB verwenden, also eine Version, bei der PRAGMA version eine library_version zurückgibt, die nicht mit v beginnt, sind Erweiterungen im Standard-Erweiterungs-Repository möglicherweise nicht mehr verfügbar.

Im Zweifel können Sie ein Issue in duckdb/duckdb eröffnen.

Manuelles Herunterladen von Erweiterungen über den Browser

Um zu prüfen, ob eine Erweiterung verfügbar ist, versuchen Sie, die entsprechende Erweiterungsressource herunterzuladen, beispielsweise indem Sie im Browser https://extensions.duckdb.org/v1.4.4/osx_arm64/spatial.duckdb_extension.gz oder einen anderen angegebenen Link aufrufen. Beachten Sie, dass http:// zugunsten von https:// veraltet ist.

Bei Erfolg wird die Erweiterung heruntergeladen und in den Standardordner Downloads entpackt, sodass Sie in SQL ausführen können:

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

Nach diesem Befehl ist die Erweiterung regulär installiert.