summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/intro_to_sparql.rst29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/intro_to_sparql.rst b/docs/intro_to_sparql.rst
index 5ab34287..97c7f281 100644
--- a/docs/intro_to_sparql.rst
+++ b/docs/intro_to_sparql.rst
@@ -71,6 +71,35 @@ Variables can also be pre-bound, using ``initBindings`` kwarg can be
used to pass in a ``dict`` of initial bindings, this is particularly
useful for prepared queries, as described below.
+Query a Remote Service
+^^^^^^^^^^^^^^^^^^^^^^
+
+The SERVICE keyword of SPARQL 1.1 can send a query to a remote SPARQL endpoint.
+
+.. code-block:: python
+
+ import rdflib
+
+ g = rdflib.Graph()
+ qres = g.query('''
+ SELECT ?s
+ WHERE {
+ SERVICE <http://dbpedia.org/sparql> {
+ ?s <http://purl.org/linguistics/gold/hypernym> <http://dbpedia.org/resource/Leveller> .
+ }
+ } LIMIT 3''')
+ for row in qres:
+ print(row.s)
+
+This example sends a query to `DBPedia
+<https://dbpedia.org/>`_'s SPARQL endpoint service so that it can run the query and then send back the result:
+
+.. code-block:: text
+
+ http://dbpedia.org/resource/Elizabeth_Lilburne
+ http://dbpedia.org/resource/Thomas_Prince_(Leveller)
+ http://dbpedia.org/resource/John_Lilburne
+
Prepared Queries
^^^^^^^^^^^^^^^^