Community-Erweiterungen

Willkommen bei der Dokumentation der DuckDB-Community-Erweiterungen.

Diese Website enthält die gesamte Dokumentation, die speziell für von der Community beigetragene Erweiterungen für DuckDB gedacht ist.

DuckDB ist ein analytisches, prozessinternes SQL-Datenbankmanagementsystem und wird auf der DuckDB-Dokumentationswebsite dokumentiert.

„Community“ bedeutet, dass die Erweiterungen von externen Beitragenden erstellt und nicht von DuckLabs gepflegt werden.

Erweiterungen sind der bevorzugte Weg, zusätzliche Funktionalität für DuckDB bereitzustellen. Allgemeine Erweiterungen sind in der DuckDB-Kerndokumentation dokumentiert.

Eine Community-Erweiterung verwenden

Um eine Community-Erweiterung zu installieren und zu laden, zum Beispiel die Demo-Erweiterung waddle, führen Sie einfach aus:

INSTALL waddle FROM community;
LOAD waddle;

Die Erweiterung waddle ist nun geladen und einsatzbereit

SELECT waddle('world');

Was sind Community-Erweiterungen?

Community-Erweiterungen sind DuckDB-Erweiterungen, die nicht vom DuckDB-Team gepflegt werden.

Sie unterscheiden sich von den Kern-Erweiterungen, die vom DuckDB-Team gepflegt werden, sowie von unsignierten Erweiterungen, also Erweiterungen mit einem leeren oder ungültigen Schlüssel.

Community-Erweiterungen werden über den Community-Extensions-Endpunkt unter http(s)://community-extensions.duckdb.org verteilt und bei INSTALL oder UPDATE EXTENSIONS von dort abgerufen.

Einreichungen und der Build-Prozess von Community-Erweiterungen erfolgen über das Community-Extensions-Repository.

Auf der Seite zur Entwicklung erfahren Sie, wie Sie eine Erweiterung beitragen.

DuckDB-Community-Erweiterungen ähneln konzeptionell einem Paketmanager wie Homebrew: Der Code liegt in Ihrem eigenen Repository, Build und Verteilung sind jedoch zentralisiert.

Sicherheitsaspekte bei der Verwendung von Community-Erweiterungen

DuckDB-Community-Erweiterungen sind signiert, sodass beim LOAD geprüft wird, dass eine gegebene Erweiterung vom CI der Community Extensions gebaut wurde.

Weitere Informationen zu Erweiterungen und ihrer Verwendung finden Sie auf den Seiten „Erweiterungen absichern“ und „Erweiterungen installieren“.

Wenn Sie insbesondere das LOAD von Community-Erweiterungen verbieten möchten, führen Sie aus:

SET allow_community_extensions = false;

Das deaktiviert jedes nachfolgende Laden von Erweiterungen, die mit dem Schlüssel der Community Extensions signiert sind, und sperrt die Konfiguration allow_community_extensions.