Additional db updates (#198)

* Fix Blazegraph configuration instructions * Update config parameters for Gremlin-Server/Fuseki/DBPedia Co-authored-by: Michael Chin <[email protected]>
aws · Sep 20, 2021 · 480127f · 480127f
1 parent 7e8677e
commit 480127f
Show file tree

Hide file tree

Showing 4 changed files with 35 additions and 26 deletions.
diff --git a/additional-databases/blazegraph/README.md b/additional-databases/blazegraph/README.md
@@ -1,18 +1,39 @@
 ## Connecting graph notebook to Blazegraph SPARQL Endpoint
 
-The official SPARQL endpoint for DBPedia is available from https://dbpedia.org/sparql and is based on a Virtuoso engine.
+[Blazegraph](https://blazegraph.com/) is an open-source, high-performance RDF triple/quadstore graph-database that can be queried via a SPARQL endpoint.
 
-It is possible to connect to this endpoint using the following configuration:
+For instructions on setting up and running Blazegraph locally, refer to the [Blazegraph Quickstart](https://github.com/blazegraph/database/wiki/Quick_Start) guide.
+
+After local setup of Blazegraph is complete, set the following configuration to connect from graph-notebook:
 
 ```
 %%graph_notebook_config
+
 {
-  "host": "dbpedia.org",
-  "port": 443,
-  "auth_mode": "DEFAULT",
-  "iam_credentials_provider_type": "ROLE",
-  "load_from_s3_arn": "",
-  "ssl": true,
-  "aws_region": ""
+  "host": "localhost",
+  "port": 9999,
+  "ssl": false
 }
 ```
+
+Blazegraph also supports use of namespaces, which are used to refer to multiple triple or quad stores that are hosted in the same Blazegraph instance, and can be queried independently.
+
+To direct SPARQL queries executed from `graph-notebook` to a specific namespace, you can specify the namespace path in your config:
+
+```
+%%graph_notebook_config
+
+{
+  "host": "localhost",
+  "port": 9999,
+  "ssl": false,
+  "sparql": {
+    "path": "blazegraph/namespace/foo/sparql"
+  }
+}
+```
+
+This will result in the url `localhost:9999/blazegraph/namespace/foo/sparql` being used when executing any `%%sparql` magic commands.
+
+
+
diff --git a/additional-databases/dbpedia/README.md b/additional-databases/dbpedia/README.md
@@ -9,10 +9,6 @@ It is possible to connect to this endpoint using the following configuration:
 {
   "host": "dbpedia.org",
   "port": 443,
-  "auth_mode": "DEFAULT",
-  "iam_credentials_provider_type": "ROLE",
-  "load_from_s3_arn": "",
-  "ssl": true,
-  "aws_region": ""
+  "ssl": true
 }
 ```
diff --git a/additional-databases/fuseki/README.md b/additional-databases/fuseki/README.md
@@ -12,11 +12,7 @@ like in the following example that connects to `http://localhost:3030/ds/sparql`
 {
   "host": "localhost",
   "port": 3030,
-  "auth_mode": "DEFAULT",
-  "iam_credentials_provider_type": "ROLE",
-  "load_from_s3_arn": "",
   "ssl": false,
-  "aws_region": "",
   "sparql": {
     "path": "ds/sparql"
   }

diff --git a/additional-databases/gremlin-server/README.md b/additional-databases/gremlin-server/README.md
@@ -31,18 +31,14 @@ Several of the steps below are optional but please read each step carefully and
 
 ### Connecting to a local Gremlin Server from Jupyter
 1. In the Jupyter Notebook disable SSL using `%%graph_notebook_config` and change the host to `localhost`. Keep the other defaults even though they are not used for configuring the Gremlin Server.
-  ```
-  %%graph_notebook_config
+```
+%%graph_notebook_config
 {
   "host": "localhost",
   "port": 8182,
-  "auth_mode": "DEFAULT",
-  "iam_credentials_provider_type": "ROLE",
-  "load_from_s3_arn": "",
-  "ssl": false,
-  "aws_region": "us-east-1"
+  "ssl": false
 }
-  ```
+```
 If the Gremlin Server you wish to connect to is remote,  replacing `localhost` with the IP address or DNS of the remote server should work. This assumes you have access to that server from your local machine.
 
 ### Using `%seed` with Gremlin Server