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

@rubensworks
Copy link
Author

rubensworks commented Jan 10, 2019

@elf-pavlik Yep, @reverse on properties is fully supported!

@almereyda
Copy link

almereyda commented Apr 3, 2019

There is an open issue about how to use @reverse in rubensworks/graphql-to-sparql.js#22

@Rakeshjdev
Copy link

Rakeshjdev commented Jul 17, 2019

I have jsonld and my requirement is to map jsonld to Grapql schema so that i can do get and post operation with graphql . how will i achieve this. please suggest. please give a reference so that i can achieve this task.

@pebran
Copy link

pebran commented Aug 30, 2022

I haven’t found - in any article about GraphQL-LD - a mentioning about using a GraphQL-replacement for prefixes. Like using ‘foaf_Person’ or ‘skos_prefLabel’ to represent foaf:Person and skos:prefLabel respectively.
Is there a preferred way, a convention to do this?
It would be nice/practical if we could agree on a pattern.

@rubensworks
Copy link
Author

rubensworks commented Aug 30, 2022

@pebran GraphQL-LD requires users to encode prefixes (or vocabs) via the JSON-LD context.

So rdfs_label would be written as label in the query when the following JSON-LD context is configured:

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

This avoids tight coupling between the schema and query layer.

@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