Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ex2_1: add yarrrrml to get r2rml file #244

Merged
merged 1 commit into from
Mar 23, 2022
Merged

ex2_1: add yarrrrml to get r2rml file #244

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
157 changes: 95 additions & 62 deletions dat/student_sport.r2rml.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,63 +1,96 @@
@prefix rr: <http://www.w3.org/ns/r2rml#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix ex: <http://example.com/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@base <http://example.com/base/> .
@prefix rr: <http://www.w3.org/ns/r2rml#>.
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
@prefix fnml: <http://semweb.mmlab.be/ns/fnml#>.
@prefix fno: <https://w3id.org/function/ontology#>.
@prefix d2rq: <http://www.wiwiss.fu-berlin.de/suhl/bizer/D2RQ/0.1#>.
@prefix void: <http://rdfs.org/ns/void#>.
@prefix dc: <http://purl.org/dc/terms/>.
@prefix foaf: <http://xmlns.com/foaf/0.1/>.
@prefix : <http://mapping.example.com/>.
@prefix ns1: <http://example.com/>.

<TriplesMap1>
a rr:TriplesMap;

rr:logicalTable [ rr:tableName "Student"; ] ;

rr:subjectMap [
rr:template "http://example.com/student/{ID}";
rr:class ex:Student;
];

rr:predicateObjectMap
[
rr:predicate ex:firstName ;
rr:objectMap [ rr:column "FirstName" ]
];

rr:predicateObjectMap
[
rr:predicate ex:lastName ;
rr:objectMap [ rr:column "LastName" ]
]
.

<TriplesMap2>
a rr:TriplesMap;

rr:logicalTable [ rr:tableName "Sport"; ] ;

rr:subjectMap [
rr:template "http://example.com/sport/{ID}";
rr:class ex:Sport;
];

rr:predicateObjectMap
[
rr:predicate ex:id ;
rr:objectMap [ rr:column "ID"; ]
];

rr:predicateObjectMap
[
rr:predicate ex:description ;
rr:objectMap [ rr:column "Description" ]
]
.

<LinkMap_1_2>
a rr:TriplesMap;

rr:logicalTable [ rr:tableName "Student_Sport" ];

rr:subjectMap [ rr:template "http://example.com/student/{ID_Student}" ];

rr:predicateObjectMap [
rr:predicate ex:plays ;
rr:objectMap [ rr:template "http://example.com/sport/{ID_Sport}" ];
].
:rules_000 a void:Dataset.
:source_000 a rr:LogicalTable;
rdfs:label "students";
rr:sqlQuery "select * from Student left join Student_Sport on Student.ID = Student_Sport.ID_Student left join Sport on Sport.ID = Student_Sport.ID_Sport;";
rr:sqlVersion rr:MySQL.
:rules_000 void:exampleResource :map_student_000.
:map_student_000 rr:logicalTable :source_000;
a rr:TriplesMap;
rdfs:label "student".
:s_000 a rr:SubjectMap.
:map_student_000 rr:subjectMap :s_000.
:s_000 rr:template "http://example.com/{ID_Student}".
:pom_000 a rr:PredicateObjectMap.
:map_student_000 rr:predicateObjectMap :pom_000.
:pm_000 a rr:PredicateMap.
:pom_000 rr:predicateMap :pm_000.
:pm_000 rr:constant rdf:type.
:pom_000 rr:objectMap :om_000.
:om_000 a rr:ObjectMap;
rr:constant "http://example.com/Student";
rr:termType rr:IRI.
:pom_001 a rr:PredicateObjectMap.
:map_student_000 rr:predicateObjectMap :pom_001.
:pm_001 a rr:PredicateMap.
:pom_001 rr:predicateMap :pm_001.
:pm_001 rr:constant ns1:firstName.
:pom_001 rr:objectMap :om_001.
:om_001 a rr:ObjectMap;
rr:column "FirstName";
rr:termType rr:Literal.
:pom_002 a rr:PredicateObjectMap.
:map_student_000 rr:predicateObjectMap :pom_002.
:pm_002 a rr:PredicateMap.
:pom_002 rr:predicateMap :pm_002.
:pm_002 rr:constant ns1:lastName.
:pom_002 rr:objectMap :om_002.
:om_002 a rr:ObjectMap;
rr:column "LastName";
rr:termType rr:Literal.
:pom_003 a rr:PredicateObjectMap.
:map_student_000 rr:predicateObjectMap :pom_003.
:pm_003 a rr:PredicateMap.
:pom_003 rr:predicateMap :pm_003.
:pm_003 rr:constant ns1:plays.
:pom_003 rr:objectMap :om_003.
:rules_000 void:exampleResource :map_sport_000.
:map_sport_000 rr:logicalTable :source_000;
a rr:TriplesMap;
rdfs:label "sport".
:s_001 a rr:SubjectMap.
:map_sport_000 rr:subjectMap :s_001.
:s_001 rr:template "http://example.com/{ID_Sport}".
:pom_004 a rr:PredicateObjectMap.
:map_sport_000 rr:predicateObjectMap :pom_004.
:pm_004 a rr:PredicateMap.
:pom_004 rr:predicateMap :pm_004.
:pm_004 rr:constant rdf:type.
:pom_004 rr:objectMap :om_004.
:om_004 a rr:ObjectMap;
rr:constant "http://example.com/Sport";
rr:termType rr:IRI.
:pom_005 a rr:PredicateObjectMap.
:map_sport_000 rr:predicateObjectMap :pom_005.
:pm_005 a rr:PredicateMap.
:pom_005 rr:predicateMap :pm_005.
:pm_005 rr:constant ns1:description.
:pom_005 rr:objectMap :om_005.
:om_005 a rr:ObjectMap;
rr:column "Description";
rr:termType rr:Literal.
:pom_006 a rr:PredicateObjectMap.
:map_sport_000 rr:predicateObjectMap :pom_006.
:pm_006 a rr:PredicateMap.
:pom_006 rr:predicateMap :pm_006.
:pm_006 rr:constant ns1:id.
:pom_006 rr:objectMap :om_006.
:om_006 a rr:ObjectMap;
rr:column "ID_Sport";
rr:termType rr:Literal.
:om_003 a rr:ObjectMap;
rr:parentTriplesMap :map_sport_000;
rr:joinCondition :jc_000.
:jc_000 rr:child "ID_Sport";
rr:parent "ID_Sport".
31 changes: 31 additions & 0 deletions dat/student_sport.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
prefixes:
ns1: "http://example.com/"

sources:
students:
queryFormulation: mysql
query: select * from Student left join Student_Sport on Student.ID = Student_Sport.ID_Student left join Sport on Sport.ID = Student_Sport.ID_Sport;

mappings:
student:
sources: students
s: http://example.com/$(ID_Student)
po:
- [a, ns1:Student]
- [ns1:firstName, $(FirstName)]
- [ns1:lastName, $(LastName)]
- p: ns1:plays
o:
- mapping: sport
condition:
function: equal
parameters:
- [str1, $(ID_Sport)]
- [str2, $(ID_Sport)]
sport:
sources: students
s: http://example.com/$(ID_Sport)
po:
- [a, ns1:Sport]
- [ns1:description, $(Description)]
- [ns1:id, $(ID_Sport)]
76 changes: 63 additions & 13 deletions examples/ex2_1.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "code",
"execution_count": 1,
"execution_count": 9,
"metadata": {},
"outputs": [],
"source": [
Expand Down Expand Up @@ -78,7 +78,7 @@
},
{
"cell_type": "code",
"execution_count": 2,
"execution_count": 16,
"metadata": {},
"outputs": [],
"source": [
Expand All @@ -103,6 +103,56 @@
"```"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This config references a `R2RML` mapping (`student_sport.r2rml.ttl`) that is applied to the input data. One way to create such a mapping is [YARRRML](https://rml.io/yarrrml/), \"a human-friendly text-based representation of RML rules\". You write the rules in YAML and then transform it with a yarrrml-parser to a `RML` or `R2RML` file. There is a [browser-based version](https://rml.io/yarrrml/matey/#) to get an idea how it works.\n",
"\n",
"The YARRRML file needed for this example can be found in `dat/` to use on the sample database:\n",
"\n",
"```YML\n",
"prefixes:\n",
" ns1: \"http://example.com/\"\n",
"\n",
"sources:\n",
" students:\n",
" queryFormulation: mysql\n",
" query: select * from Student left join Student_Sport on Student.ID = Student_Sport.ID_Student left join Sport on Sport.ID = Student_Sport.ID_Sport;\n",
"\n",
"mappings:\n",
" student:\n",
" sources: students\n",
" s: http://example.com/$(ID_Student)\n",
" po:\n",
" - [a, ns1:Student]\n",
" - [ns1:firstName, $(FirstName)]\n",
" - [ns1:lastName, $(LastName)]\n",
" - p: ns1:plays\n",
" o: \n",
" - mapping: sport\n",
" condition:\n",
" function: equal\n",
" parameters:\n",
" - [str1, $(ID_Sport)]\n",
" - [str2, $(ID_Sport)]\n",
" sport:\n",
" sources: students\n",
" s: http://example.com/$(ID_Sport)\n",
" po:\n",
" - [a, ns1:Sport]\n",
" - [ns1:description, $(Description)]\n",
" - [ns1:id, $(ID_Sport)]\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"After using the yarrrml-parser with `yarrrml-parser -i student_sport.yml -o student_sport.r2rml.ttl -f R2RML` you get `students_sport.r2rml.ttl`. This is the file you refer in the configuration for `Morph-KGC`."
]
},
{
"cell_type": "markdown",
"metadata": {},
Expand All @@ -112,18 +162,18 @@
},
{
"cell_type": "code",
"execution_count": 3,
"execution_count": 17,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"INFO | 2022-02-27 12:15:21,403 | 7 mapping rules retrieved.\n",
"INFO | 2022-02-27 12:15:21,418 | Mapping partition with 1 groups generated.\n",
"INFO | 2022-02-27 12:15:21,419 | Maximum number of rules within mapping group: 7.\n",
"INFO | 2022-02-27 12:15:21,420 | Mappings processed in 1.739 seconds.\n",
"INFO | 2022-02-27 12:15:21,523 | Number of triples generated in total: 22.\n"
"INFO | 2022-03-22 10:14:42,617 | 7 mapping rules retrieved.\n",
"INFO | 2022-03-22 10:14:42,622 | Mapping partition with 1 groups generated.\n",
"INFO | 2022-03-22 10:14:42,622 | Maximum number of rules within mapping group: 7.\n",
"INFO | 2022-03-22 10:14:42,623 | Mappings processed in 0.131 seconds.\n",
"INFO | 2022-03-22 10:14:42,709 | Number of triples generated in total: 22.\n"
]
}
],
Expand Down Expand Up @@ -159,7 +209,7 @@
},
{
"cell_type": "code",
"execution_count": 4,
"execution_count": 18,
"metadata": {
"scrolled": true
},
Expand All @@ -168,10 +218,10 @@
"name": "stderr",
"output_type": "stream",
"text": [
"ic| student_name: 'Venus', sport_desc: 'Tennis'\n",
"ic| student_name: 'David', sport_desc: 'Football'\n",
"ic| student_name: 'Fernando', sport_desc: 'Formula1'\n",
"ic| student_name: 'Fernando', sport_desc: 'Football'\n",
"ic| student_name: 'Fernando', sport_desc: 'Formula1'\n"
"ic| student_name: 'David', sport_desc: 'Football'\n",
"ic| student_name: 'Venus', sport_desc: 'Tennis'\n"
]
}
],
Expand Down Expand Up @@ -211,7 +261,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.7.4"
"version": "3.9.10"
}
},
"nbformat": 4,
Expand Down