https://github.com/datafabricrus/datastudio-sparql-connector

SPARQL Connector for Google Data Studio
https://github.com/datafabricrus/datastudio-sparql-connector

data-studio linked-data rdf sparql

Last synced: 2 months ago
JSON representation

SPARQL Connector for Google Data Studio

• Host: GitHub
• URL: https://github.com/datafabricrus/datastudio-sparql-connector
• Owner: DataFabricRus
• License: mit
• Created: 2018-10-09T09:00:37.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-01-10T09:22:46.000Z (over 6 years ago)
• Last Synced: 2025-03-24T18:52:34.188Z (3 months ago)
• Topics: data-studio, linked-data, rdf, sparql
• Language: JavaScript
• Homepage:
• Size: 151 KB
• Stars: 5
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SPARQL Connector for Google Data Studio

It allows to load data from a SPARQL endpoint using SELECT queries.

![Connector in the gallery](screenshot_ingallery.png)

## Example report

![Example report on Google Datastudio](screenshot_examplereport.png)

Here is [link](https://datastudio.google.com/open/1Mbwa4VUue5Z9Ke4TsN6FcsQMiQX2uDPC) to the example report.

## Getting started

1. Open the [link](https://datastudio.google.com/datasources/create?connectorId=AKfycbzDHEBN9qHXPni4xO4P2cIZtyQ3rnYmzkCnVsnh9oEJrnhGe4MntBF-t1zAu2Lm-Vjc) to create a new Data Source.

1. Once authorization has successfully completed, you're ready to configure the parameters. You should see the form:

    ![Screenshot of the configuration page](screenshot_parameters.png)

1. Enter the SPARQL endpoint URL, e.g. http://dbpedia.org/sparql

1. Enter your SELECT query, e.g.

    ```

    PREFIX dbr: 

    PREFIX dbo: 

    PREFIX foaf: 

    PREFIX xsd: 

    SELECT ?name ?gender ?birthDate WHERE {

      ?person dbo:birthPlace dbr:Berlin ;

              dbo:birthDate ?birthDate ;

              foaf:name ?name ;

              foaf:gender ?gender .

       FILTER (?birthDate > "{dateRange.startDate}"^^xsd:date && ?birthDate < "{dateRange.endDate}"^^xsd:date) .

    }

    ```

    The following variables are supported:

    * `dateRange.startDate` - format `YYYY-MM-DD`, e.g. 2018-10-01,

    * `dateRange.endDate` - format `YYYY-MM-DD`, e.g. 2018-10-01,

    * `dateRange.numDays` - it's a positive integer value.

    If you don't use `dateRange.startDate` or `dateRange.endDate`, then **Date range** filter won't be able to control the date range.

1. Enter the schema of projections, e.g.

    ```

    [

        {"name": "name", "dataType": "STRING"},

        {"name": "gender", "dataType": "STRING"},

        {"name": "birtDate", "dataType": "STRING"}

    ]

    ```

    At this step is enough to set only data types for each projection, at the next step you'll be able to refine it. More about the schema elements, data types you can read in https://developers.google.com/datastudio/connector/semantics.

1. Press **Connect** button and the next page is the same for all connectors.

## Supported data type conversions

Google Data Studio uses it's own formats for some of the data types. Therefore the connector automatically converts them. The following data types are supported:

* `xsd:date` is converted to `YYYYMMDD`,

* `xsd:dateTime` is converted to `YYYYMMDDHH`,

* `xsd:duration` is converted to an integer corresponding to the number of seconds.

## Default values

The connector may apply default values in query results which don't a value for a requested field. The default values:

Datatype   | Default value

-----------|--------------

`NUMBER`   | `0`

`BOOLEAN`  | `false`

`STRING`   | `""`

If you don't like these defaults, then write your query in a way when it can't have missing/empty values, especially in case of `GROUP BY`.

## License

MIT License