rdf

RDF lesen und schreiben, mit SPARQL abfragen

Maintainer: nonodename

Installation und Laden

INSTALL rdf FROM community;
LOAD rdf;

Beispiel

-- 0. Assuming the extension is already installed and loaded

-- 1. Get number of ntriples in a directory
SELECT COUNT(*) FROM read_rdf('data/shards/*.nt');

-- 2. Get subjects and predicates of a turtle file
SELECT subject, predicate FROM read_rdf('test/rdf/tests.ttl');

-- 3. Write a query to turtle RDF, using R2RML mapping
COPY (SELECT empno, ename, deptno FROM emp)
TO 'output.nt'
(FORMAT r2rml, mapping 'mapping.ttl');

-- 4. Execute a full R2RML mapping (with embedded queries) to write RDF
COPY (SELECT 1) TO 'output.nt' (FORMAT r2rml, mapping 'mapping.ttl');

-- 5. Check if an R2RML mapping is valid
SELECT is_valid_r2rml('mapping.ttl');

-- 6. Pivot RDF to a wide table
SELECT * FROM pivot_rdf('data.ttl');

-- 7. Read a SPARQL endpoint
SELECT * FROM read_sparql(
         'https://query.wikidata.org/sparql',
         'SELECT (COUNT(*) AS ?count) WHERE { ?item wdt:P31 wd:Q5 .}'
     );

-- 8. Execute a SPARQL query using against DuckDB tables using an R2RML mapping
SELECT * FROM execute_sparql(
         'PREFIX ex: <http://example.com/ns#> SELECT ?e ?name WHERE { ?e ex:name ?name }',
         'full_r2rml_mapping.ttl'
     );

Über rdf

Die Erweiterung duck_rdf ermöglicht DuckDB, RDF-Daten (Resource Description Framework) direkt zu lesen und zu schreiben, unter Verwendung der Bibliothek SERD für Parsing und Serialisierung.

Unterstützte Formate

Lesen: Turtle (.ttl), NTriples (.nt), NQuads (.nq), TriG (.trig) und RDF/XML (.rdf/.xml).

Schreiben: NTriples, Turtle, NQuads (über R2RML-Mapping).

RDF lesen

read_rdf() gibt sechs Spalten zurück: subject, predicate, object (immer gefüllt) sowie graph, language_tag, datatype (nullable). Sie akzeptiert einen Dateipfad oder ein Glob-Muster; mehrere passende Dateien werden parallel gescannt. .gz- und .zst-komprimierte Dateien werden unterstützt (Hinweis: Sie müssen die parquet-Erweiterung laden, damit die libzstd-Bibliothek geladen wird). Das RDF-Format wird anhand der Dateiendung automatisch erkannt, kann aber mit dem Parameter file_type überschrieben werden.

SELECT subject, predicate FROM read_rdf('data.ttl');
SELECT COUNT(*) FROM read_rdf('data/shards/*.nt');
SELECT * FROM read_rdf('data/*.dat', file_type = 'ttl', strict_parsing = false);

Optionale Parameter:

pivot_rdf() nimmt dasselbe Pfad-/Glob-Argument wie read_rdf() entgegen und gibt eine pivotierte Tabelle zurück, eine Spalte pro Prädikat, mindestens eine Zeile pro Subjekt. (Um beliebige Dateigrößen zu verarbeiten, können Subjekte wiederholt werden, wenn sie außer der Reihenfolge auftreten.) Ein Pivot ist auch in der SQL-Domäne möglich, unterliegt aber Speichergrenzen; diese Funktion vermeidet das durch zwei Durchläufe über das RDF, wobei der erste die Datenform mit profile_rdf() profiliert.

Die Funktion read_sparql(endpoint, query) sendet eine SPARQL-SELECT-Abfrage an einen entfernten Endpunkt und gibt die Ergebnismenge als DuckDB-Tabelle zurück. Spaltennamen werden aus den SPARQL-Variablennamen abgeleitet; alle Spalten sind VARCHAR. Ungebundene Variablen werden als leere Zeichenketten zurückgegeben.

-- Count number of humans in wikidata
SELECT * FROM read_sparql(
            'https://query.wikidata.org/sparql',
            'SELECT (COUNT(*) AS ?count) WHERE {   ?item wdt:P31 wd:Q5 .}'
        );

Sie können auch eine SPARQL-1.1-Abfrage execute_sparql(query, mapping) gegen DuckDB-Tabellen ausführen und dabei eine R2RML-Mapping-Datei verwenden, um die Abbildung zwischen relationalen Daten und RDF zu definieren. Die SPARQL- Abfrage wird zur Abfragezeit mit einem regelbasierten Optimizer nach SQL umgewandelt. Die Funktion gibt die Ergebnismenge als DuckDB-Tabelle zurück. Ein guter Teil von SPARQL wird unterstützt. Weitere Informationen finden Sie in der Dokumentation.

Um die Abfrage zu sehen, die ausgeführt würde, verwenden Sie sparql_to_sql(sparql, mapping).

RDF schreiben (R2RML)

Schreiben Sie RDF mit R2RML-Mapping-Dateien über DuckDBs COPY TO- Syntax. Zwei Modi werden unterstützt:

Inside-out-Modus — DuckDB steuert die Abfrage; das Mapping hat kein rr:logicalTable:

COPY (SELECT empno, ename, deptno FROM emp)
TO 'output.nt' (FORMAT r2rml, mapping 'mapping.ttl');

Vollständiger R2RML-Modus — das Mapping definiert eigene Abfragen:

COPY (SELECT 1) TO 'output.nt' (FORMAT r2rml, mapping 'mapping.ttl');

Schreiboptionen:

Validierungshelfer

SELECT is_valid_r2rml('mapping.ttl');      -- validate an R2RML mapping file
SELECT can_call_inside_out('mapping.ttl'); -- check if inside-out mode is supported

Hinzugefügte Funktionen

Überladene Funktionen

Diese Erweiterung fügt keine Funktionsüberladungen hinzu.

Hinzugefügte Typen

Diese Erweiterung fügt keine Typen hinzu.

Hinzugefügte Einstellungen

Diese Erweiterung fügt keine Einstellungen hinzu.