a ; ; "2026-06-16T20:33:36.794Z"^^; ; "Step by step guide to importing RDF data"; "Import RDF data"; ; . a ; "
\n

Step by step guide to importing RDF data

\n
\n

This guide is for importing larger amounts of data (e.g. more than a few thousands of RDF triples) asynchronously.\n For smaller data, it is simpler to add data synchronously.

\n
\n

Read more on how RDF imports work.

\n

There are 3 main components that comprise an RDF import:

\n
\n
RDF file
\n
The file containing the RDF data (can be in any RDF syntax)
\n
Transformation query (optional)
\n
SPARQL CONSTRUCT query that maps RDF to another RDF represenation
\n
Graph (optional)
\n
The document that the import results will be stored in, if no mapping query is specified
\n
RDF import
\n
Combines the file with the corresponding query
\n
\n

Either query or graph have to be specified, not both.

\n
\n

Without transformation

\n

This method asynchronously appends RDF data to a document (see how to create a document).

\n
\n \n
\n
\n
\n

LinkedDataHub allows all the import components be created from a single dialogue, but we will go through the process in separate\n steps:

\n
    \n
  1. First, create a container for the data to be imported. This will be the import's target container
    2. \n
  2. Upload a RDF file. Click on the Create dropdown in the top left-hand corner and select\n File. This will open a new form.
    3. \n
  3. Fill out Item fields
    4. \n
  4. \n Fill in the mandatory File fields:\n
    \n
    Filename
    \n
    Click on Choose file and select a RDF file from your computer
    \n
    Title
    \n
    File title
    \n
    \n
    5. \n
  5. Once all the fields have been filled in, click Save
    6. \n
  6. Click on the Create dropdown button at the top left-hand corner and select RDF Import.\n This will open a new form.
    7. \n
  7. Fill out Item fields
    8. \n
  8. \n Fill out the mandatory RDF Import fields:\n
    \n
    File
    \n
    Start typing the name of your RDF file and select it from the typeahead.
    \n
    Name
    \n
    Select the target graph (document) using the typeahead.
    \n
    Title
    \n
    Import title
    \n
    \n
    9. \n
  9. Click Save and you will be redirected the newly created import document.
    10. \n
  10. Refresh the document after a couple of moments to see the import progress. In case of success, the amount of data\n imported will be displayed. In case of failure, constraint violation(s) or other import issues will be displayed.
    11. \n
  11. Go back to the target document to see the newly imported data items.
    12. \n
\n
\n
\n
\n
\n

Checkout the Command line interface (CLI) scripts into a folder on your machine. Provide a list of arguments to the import-rdf script and execute it. For example:

\n 
import-rdf.sh \\\n    -b \"https://localhost:4443/\" \\\n    -f ./ssl/owner/cert.pem \\\n    -p \"$owner_cert_password\" \\\n    --title \"Concepts\" \\\n    --rdf-file concepts.ttl \\\n    --content-type \"text/turtle\" \\\n    --graph \"${base}skos/\"
\n
\n
\n
\n
\n
\n
\n

With transformation

\n
\n \n
\n
\n
\n

LinkedDataHub allows all the import components be created from a single dialogue, but we will go through the process in separate\n steps:

\n
    \n
  1. First, create a container for the data to be imported. This will be the import's target container
    2. \n
  2. Upload a RDF file. Click on the Create dropdown in the top left-hand corner and select\n File. This will open a new form.
    3. \n
  3. Fill out Item fields
    4. \n
  4. \n Fill in the mandatory File fields:\n
    \n
    Filename
    \n
    Click on Choose file and select a RDF file from your computer
    \n
    Title
    \n
    File title
    \n
    \n
    5. \n
  5. Once all the fields have been filled in, click Save
    6. \n
  6. The browser will open your imported file
    7. \n
  7. Create a transformation query that will\n transform the uploaded RDF to a new RDF structure. Click on the Create dropdown in the top left-hand corner and\n select CONSTRUCT. This will open a new form.
    8. \n
  8. Fill out Item fields
    9. \n
  9. \n Fill out the mandatory CONSTRUCT fields:\n
    \n
    Text
    \n
    SPARQL CONSTRUCT query string
    \n
    You will not be able to save the query if its syntax is not valid SPARQL 1.1.
    \n
    Title
    \n
    Query title
    \n
    \n
    10. \n
  10. Once all the fields have been filled in click Save. You can find this saved under\n Queries container in left navigation.
    11. \n
  11. Click on the Create dropdown button at the top left-hand corner and select RDF Import.\n This will open a new form.
    12. \n
  12. Fill out Item fields
    13. \n
  13. \n Fill out the mandatory RDF Import fields:\n
    \n
    File
    \n
    Start typing the name of your RDF file and select it from the typeahead.
    \n
    Query
    \n
    Select the transformation query using the typeahead.
    \n
    Title
    \n
    Import title
    \n
    \n
    14. \n
  14. Click Save and you will be redirected the newly created import document.
    15. \n
  15. Refresh the document after a couple of moments to see the import progress. In case of success, the amount of data\n imported will be displayed. In case of failure, constraint violation(s) or other import issues will be displayed.
    16. \n
\n
\n
\n
\n
\n

Checkout the Command line interface (CLI) scripts into a folder on your machine. Provide a list of arguments to the import-rdf script and execute it. For example:

\n 
import-rdf.sh \\\n    -b \"https://localhost:4443/\" \\\n    -f ./ssl/owner/cert.pem \\\n    -p \"$owner_cert_password\" \\\n    --title \"Concepts\" \\\n    --rdf-file concepts.ttl \\\n    --content-type \"text/turtle\" \\\n    --query-file concepts.rq
\n
\n
\n
\n
\n
\n
"^^ .