Skip to content

Instantly share code, notes, and snippets.

@rubensworks
Last active September 28, 2023 15:50
Show Gist options
  • Save rubensworks/9d6eccce996317677d71944ed1087ea6 to your computer and use it in GitHub Desktop.
Save rubensworks/9d6eccce996317677d71944ed1087ea6 to your computer and use it in GitHub Desktop.

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

@mrkvon
Copy link

mrkvon commented Feb 23, 2023

➡️ Edit: I'm sorry, i think my example is wrong. Just tried it out, and it doesn't really seem to filter

Hi, is there a filter option available? For example, to filter saying the language of a label to be German?

{ movie { name (lang="de") } }

@AnasShahab

One possible way may be to specify the language in the @context:

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

and then you'd use it

{ movie { label_de } }

Check out the examples on Comunica website.

I'm completely new to graphql-ld, so there might be other ways, idk... hope this helps, anyways...

@AnasShahab
Copy link

➡️ Edit: I'm sorry, i think my example is wrong. Just tried it out, and it doesn't really seem to filter

Hi, is there a filter option available? For example, to filter saying the language of a label to be German?
{ movie { name (lang="de") } }

@AnasShahab

One possible way may be to specify the language in the @context:

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

and then you'd use it

{ movie { label_de } }

Check out the examples on Comunica website.

I'm completely new to graphql-ld, so there might be other ways, idk... hope this helps, anyways...

@mrkvon
It provides a lang tag to an item when that item is passed as an argument. However, it does not work with variables.

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