Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?

GraphQL-LD

GraphQL-LD is a way to query Linked Data using GraphQL.

Instead of querying GraphQL interfaces, Linked Data interfaces are queried, such as SPARQL endpoints, TPF interfaces, Linked Data documents, ... This is done by semantifying GraphQL queries using a JSON-LD context.

Try it out from your browser: http://query.linkeddatafragments.org/

Alternatively, install GraphQL-LD or Comunica SPARQL and execute GraphQL-LD queries on your machine

The basics

In order to execute queries, you'll need to parts:

  1. A GraphQL query: to select data
  2. A JSON-LD context: to map query fields to URIs

With this, GraphQL queries can be translated into a SPARQL query, using which any Linked Data source can be queried.

Example

Find all labels in a dataset

GraphQL query:

{
  label
}

JSON-LD context:

{
  "@context": {
    "label": { "@id": "http://www.w3.org/2000/01/rdf-schema#label" }
  }
}

This query will be translated into the following triple pattern:

_:b <http://www.w3.org/2000/01/rdf-schema#label> ?label

More information

If you want more details on how GraphQL-LD works, please refer to our article or our GraphQL-LD tool

Related software

@pebran
Copy link

pebran commented Aug 30, 2022

Thank you for the quick answer.
So a potential conflict between labels given to classes or properties is to be solved in the @context, like:

{
"@context": {
"person_Person": { "@id": "https://www.w3.org/ns/person#Person" },
”foaf_Person” : { "@id": "http://xmlns.com/foaf/0.1/Person" }
}
}

Still hoping for a general agreement to use this kind of notation though ;-)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment