|
23 | 23 | .dfn-panel.docked{position:fixed;left:.5em;top:unset;bottom:2em;margin:0 auto;max-width:calc(100vw - .75em * 2 - .5em - .2em * 2);max-height:30vh;overflow:auto} |
24 | 24 | </style> |
25 | 25 |
|
26 | | -<title>Source & Target</title> |
| 26 | +<title>RML-IO</title> |
27 | 27 |
|
28 | 28 |
|
29 | 29 | <link rel="stylesheet" type="text/css" href="./20230509/resources/css/extras.css"> |
|
391 | 391 | <link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2021/cg-draft"></head> |
392 | 392 | <body class="h-entry"><div class="head"> |
393 | 393 |
|
394 | | - <h1 id="title" class="title">Source & Target</h1> |
| 394 | + <h1 id="title" class="title">RML-IO</h1> |
395 | 395 | <p id="w3c-state"> |
396 | 396 | <a href="https://www.w3.org/standards/types#reports">Draft Community Group Report</a> |
397 | 397 | <time class="dt-published" datetime="2023-05-09">09 May 2023</time> |
@@ -421,7 +421,7 @@ <h1 id="title" class="title">Source & Target</h1> |
421 | 421 | © |
422 | 422 | 2021-2023 |
423 | 423 |
|
424 | | - the Contributors to the Source & Target |
| 424 | + the Contributors to the RML-IO |
425 | 425 | Specification, published by the |
426 | 426 | <a href="https://www.w3.org/groups/cg/kg-construct">Knowledge Graph Construction Community Group</a> under the |
427 | 427 | <a href="https://www.w3.org/community/about/agreements/cla/">W3C Community Contributor License Agreement (CLA)</a>. A human-readable |
@@ -456,11 +456,7 @@ <h1 id="title" class="title">Source & Target</h1> |
456 | 456 |
|
457 | 457 | Learn more about |
458 | 458 | <a href="https://www.w3.org/community/">W3C Community and Business Groups</a>. |
459 | | - </p> |
460 | | - <p data-format="markdown"><p>This is an early draft, |
461 | | -yet efforts are made to keep things stable.</p> |
462 | | -</p> |
463 | | -</section><nav id="toc"><h2 class="introductory" id="table-of-contents">Table of Contents</h2><ol class="toc"><li class="tocline"><a class="tocxref" href="#abstract">Abstract</a></li><li class="tocline"><a class="tocxref" href="#sotd">Status of This Document</a></li><li class="tocline"><a class="tocxref" href="#conformance"><bdi class="secno">1. </bdi>Conformance</a></li><li class="tocline"><a class="tocxref" href="#overview"><bdi class="secno">2. </bdi>Overview</a></li><li class="tocline"><a class="tocxref" href="#source-vocabulary"><bdi class="secno">3. </bdi>Logical Source vocabulary</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#defining-logical-sources"><bdi class="secno">3.1 </bdi>Defining Logical Sources</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#reference-formulations"><bdi class="secno">3.1.1 </bdi>Reference formulations</a></li></ol></li><li class="tocline"><a class="tocxref" href="#source"><bdi class="secno">3.2 </bdi>Source</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#null-values"><bdi class="secno">3.2.1 </bdi>NULL values</a></li><li class="tocline"><a class="tocxref" href="#query"><bdi class="secno">3.2.2 </bdi>Query</a></li><li class="tocline"><a class="tocxref" href="#compression-formats"><bdi class="secno">3.2.3 </bdi>Compression formats</a></li><li class="tocline"><a class="tocxref" href="#encoding-formats"><bdi class="secno">3.2.4 </bdi>Encoding formats</a></li><li class="tocline"><a class="tocxref" href="#source-examples"><bdi class="secno">3.2.5 </bdi>Examples</a></li></ol></li></ol></li><li class="tocline"><a class="tocxref" href="#target-vocabulary"><bdi class="secno">4. </bdi>Logical Target vocabulary</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#defining-targets"><bdi class="secno">4.1 </bdi>Defining Logical Targets</a></li><li class="tocline"><a class="tocxref" href="#target"><bdi class="secno">4.2 </bdi>Target</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#serialization-formats"><bdi class="secno">4.2.1 </bdi>Serialization formats</a></li><li class="tocline"><a class="tocxref" href="#compression-formats-0"><bdi class="secno">4.2.2 </bdi>Compression formats</a></li><li class="tocline"><a class="tocxref" href="#encoding-formats-0"><bdi class="secno">4.2.3 </bdi>Encoding formats</a></li><li class="tocline"><a class="tocxref" href="#target-examples"><bdi class="secno">4.2.4 </bdi>Examples</a></li></ol></li></ol></li><li class="tocline"><a class="tocxref" href="#logical-source-in-rml"><bdi class="secno">5. </bdi>Logical Source in RML</a></li><li class="tocline"><a class="tocxref" href="#logical-target-in-rml"><bdi class="secno">6. </bdi>Logical Target in RML</a></li><li class="tocline"><a class="tocxref" href="#single-targets"><bdi class="secno">7. </bdi>Single targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#subject-map"><bdi class="secno">7.1 </bdi>Subject Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-map"><bdi class="secno">7.2 </bdi>Predicate Map</a></li><li class="tocline"><a class="tocxref" href="#object-map"><bdi class="secno">7.3 </bdi>Object Map</a></li><li class="tocline"><a class="tocxref" href="#graph-map"><bdi class="secno">7.4 </bdi>Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-map"><bdi class="secno">7.5 </bdi>Language Map</a></li></ol></li><li class="tocline"><a class="tocxref" href="#multiple-targets"><bdi class="secno">8. </bdi>Combining multiple Targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#multiple-targets-same-term-map"><bdi class="secno">8.1 </bdi>Multiple Targets in the same Term Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-predicate-map"><bdi class="secno">8.2 </bdi>Subject Map and Predicate Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-object-map"><bdi class="secno">8.3 </bdi>Subject Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-and-object-map"><bdi class="secno">8.4 </bdi>Predicate Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#subject-predicate-and-object-map"><bdi class="secno">8.5 </bdi>Subject Map, Predicate Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-graph-map"><bdi class="secno">8.6 </bdi>Subject Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-and-graph-map"><bdi class="secno">8.7 </bdi>Predicate Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#object-and-graph-map"><bdi class="secno">8.8 </bdi>Object Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-and-graph-map"><bdi class="secno">8.9 </bdi>Language Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-and-object-map"><bdi class="secno">8.10 </bdi>Language Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#multiple-predicate-map"><bdi class="secno">8.11 </bdi>Multiple Predicate Maps</a></li><li class="tocline"><a class="tocxref" href="#multiple-object-map"><bdi class="secno">8.12 </bdi>Multiple Object Maps</a></li><li class="tocline"><a class="tocxref" href="#multiple-graph-map"><bdi class="secno">8.13 </bdi>Multiple Graph Maps</a></li></ol></li><li class="tocline"><a class="tocxref" href="#overriding-targets"><bdi class="secno">9. </bdi>Overriding Targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#seperate-triples-map"><bdi class="secno">9.1 </bdi>Separate Triples Map</a></li><li class="tocline"><a class="tocxref" href="#conditions"><bdi class="secno">9.2 </bdi>Conditions</a></li></ol></li><li class="tocline"><a class="tocxref" href="#references"><bdi class="secno">A. </bdi>References</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#normative-references"><bdi class="secno">A.1 </bdi>Normative references</a></li></ol></li></ol></nav> |
| 459 | + </p></section><nav id="toc"><h2 class="introductory" id="table-of-contents">Table of Contents</h2><ol class="toc"><li class="tocline"><a class="tocxref" href="#abstract">Abstract</a></li><li class="tocline"><a class="tocxref" href="#sotd">Status of This Document</a></li><li class="tocline"><a class="tocxref" href="#conformance"><bdi class="secno">1. </bdi>Conformance</a></li><li class="tocline"><a class="tocxref" href="#overview"><bdi class="secno">2. </bdi>Overview</a></li><li class="tocline"><a class="tocxref" href="#source-vocabulary"><bdi class="secno">3. </bdi>Logical Source vocabulary</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#defining-logical-sources"><bdi class="secno">3.1 </bdi>Defining Logical Sources</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#reference-formulations"><bdi class="secno">3.1.1 </bdi>Reference formulations</a></li></ol></li><li class="tocline"><a class="tocxref" href="#source"><bdi class="secno">3.2 </bdi>Source</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#null-values"><bdi class="secno">3.2.1 </bdi>NULL values</a></li><li class="tocline"><a class="tocxref" href="#query"><bdi class="secno">3.2.2 </bdi>Query</a></li><li class="tocline"><a class="tocxref" href="#compression-formats"><bdi class="secno">3.2.3 </bdi>Compression formats</a></li><li class="tocline"><a class="tocxref" href="#encoding-formats"><bdi class="secno">3.2.4 </bdi>Encoding formats</a></li></ol></li><li class="tocline"><a class="tocxref" href="#source-examples"><bdi class="secno">3.3 </bdi>Examples</a></li></ol></li><li class="tocline"><a class="tocxref" href="#target-vocabulary"><bdi class="secno">4. </bdi>Logical Target vocabulary</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#defining-targets"><bdi class="secno">4.1 </bdi>Defining Logical Targets</a></li><li class="tocline"><a class="tocxref" href="#target"><bdi class="secno">4.2 </bdi>Target</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#serialization-formats"><bdi class="secno">4.2.1 </bdi>Serialization formats</a></li><li class="tocline"><a class="tocxref" href="#compression-formats-0"><bdi class="secno">4.2.2 </bdi>Compression formats</a></li><li class="tocline"><a class="tocxref" href="#encoding-formats-0"><bdi class="secno">4.2.3 </bdi>Encoding formats</a></li></ol></li><li class="tocline"><a class="tocxref" href="#target-examples"><bdi class="secno">4.3 </bdi>Examples</a></li></ol></li><li class="tocline"><a class="tocxref" href="#logical-source-in-rml"><bdi class="secno">5. </bdi>Logical Source in RML</a></li><li class="tocline"><a class="tocxref" href="#logical-target-in-rml"><bdi class="secno">6. </bdi>Logical Target in RML</a></li><li class="tocline"><a class="tocxref" href="#single-targets"><bdi class="secno">7. </bdi>Single targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#subject-map"><bdi class="secno">7.1 </bdi>Subject Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-map"><bdi class="secno">7.2 </bdi>Predicate Map</a></li><li class="tocline"><a class="tocxref" href="#object-map"><bdi class="secno">7.3 </bdi>Object Map</a></li><li class="tocline"><a class="tocxref" href="#graph-map"><bdi class="secno">7.4 </bdi>Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-map"><bdi class="secno">7.5 </bdi>Language Map</a></li></ol></li><li class="tocline"><a class="tocxref" href="#multiple-targets"><bdi class="secno">8. </bdi>Combining multiple Targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#multiple-targets-same-term-map"><bdi class="secno">8.1 </bdi>Multiple Targets in the same Term Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-predicate-map"><bdi class="secno">8.2 </bdi>Subject Map and Predicate Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-object-map"><bdi class="secno">8.3 </bdi>Subject Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-and-object-map"><bdi class="secno">8.4 </bdi>Predicate Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#subject-predicate-and-object-map"><bdi class="secno">8.5 </bdi>Subject Map, Predicate Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#subject-and-graph-map"><bdi class="secno">8.6 </bdi>Subject Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#predicate-and-graph-map"><bdi class="secno">8.7 </bdi>Predicate Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#object-and-graph-map"><bdi class="secno">8.8 </bdi>Object Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-and-graph-map"><bdi class="secno">8.9 </bdi>Language Map and Graph Map</a></li><li class="tocline"><a class="tocxref" href="#language-and-object-map"><bdi class="secno">8.10 </bdi>Language Map and Object Map</a></li><li class="tocline"><a class="tocxref" href="#multiple-predicate-map"><bdi class="secno">8.11 </bdi>Multiple Predicate Maps</a></li><li class="tocline"><a class="tocxref" href="#multiple-object-map"><bdi class="secno">8.12 </bdi>Multiple Object Maps</a></li><li class="tocline"><a class="tocxref" href="#multiple-graph-map"><bdi class="secno">8.13 </bdi>Multiple Graph Maps</a></li></ol></li><li class="tocline"><a class="tocxref" href="#overriding-targets"><bdi class="secno">9. </bdi>Overriding Targets</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#seperate-triples-map"><bdi class="secno">9.1 </bdi>Separate Triples Map</a></li><li class="tocline"><a class="tocxref" href="#conditions"><bdi class="secno">9.2 </bdi>Conditions</a></li></ol></li><li class="tocline"><a class="tocxref" href="#references"><bdi class="secno">A. </bdi>References</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#normative-references"><bdi class="secno">A.1 </bdi>Normative references</a></li></ol></li></ol></nav> |
464 | 460 |
|
465 | 461 | <section id="conformance"><div class="header-wrapper"><h2 id="x1-conformance"><bdi class="secno">1. </bdi>Conformance</h2><a class="self-link" href="#conformance" aria-label="Permalink for Section 1."></a></div><p>As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.</p><p> |
466 | 462 | The key words <em class="rfc2119">MAY</em>, <em class="rfc2119">MUST</em>, and <em class="rfc2119">MUST NOT</em> in this document |
@@ -753,7 +749,7 @@ <h1 id="title" class="title">Source & Target</h1> |
753 | 749 | <p>If unspecified, the default value is UTF-8. |
754 | 750 | This namespace is NOT limited to the listed compression formats |
755 | 751 | and <em class="rfc2119">MAY</em> be extended in the future.</p> |
756 | | -</section><section id="examples"><div class="header-wrapper"><h4 id="source-examples"><bdi class="secno">3.2.5 </bdi>Examples</h4><a class="self-link" href="#source-examples" aria-label="Permalink for Section 3.2.5"></a></div><p>The following example show a Source of an CSV file.</p> |
| 752 | +</section></section><section id="examples"><div class="header-wrapper"><h3 id="source-examples"><bdi class="secno">3.3 </bdi>Examples</h3><a class="self-link" href="#source-examples" aria-label="Permalink for Section 3.3"></a></div><p>The following example show a Source of an CSV file.</p> |
757 | 753 | <pre class="ex-source" aria-busy="false"><code class="hljs"><#CSV> a rml:LogicalSource; |
758 | 754 | rml:source [ a rml:Source, a csvw:Table |
759 | 755 | csvw:url "/path/to/data.csv"; |
@@ -909,7 +905,7 @@ <h1 id="title" class="title">Source & Target</h1> |
909 | 905 | ]; |
910 | 906 | rml:referenceFormulation ql:XPath; |
911 | 907 | rml:iterator "/my/xpath"; |
912 | | -.</code></pre></section></section></section> |
| 908 | +.</code></pre></section></section> |
913 | 909 |
|
914 | 910 | <section id="logical-target-vocabulary"><div class="header-wrapper"><h2 id="target-vocabulary"><bdi class="secno">4. </bdi>Logical Target vocabulary</h2><a class="self-link" href="#target-vocabulary" aria-label="Permalink for Section 4."></a></div><p>The LogicalTarget vocabulary namespace is <a href="http://w3id.org/rml/">http://w3id.org/rml/</a> |
915 | 911 | and it's prefix is <code>rml</code>.</p> |
@@ -1018,7 +1014,7 @@ <h1 id="title" class="title">Source & Target</h1> |
1018 | 1014 | <p>If unspecified, the default value is UTF-8. |
1019 | 1015 | This namespace is NOT limited to the listed compression formats |
1020 | 1016 | and <em class="rfc2119">MAY</em> be extended in the future.</p> |
1021 | | -</section><section id="examples-0"><div class="header-wrapper"><h4 id="target-examples"><bdi class="secno">4.2.4 </bdi>Examples</h4><a class="self-link" href="#target-examples" aria-label="Permalink for Section 4.2.4"></a></div><p>The following example show a Target of an RDF dump in Turtle [<cite><a class="bibref" data-link-type="biblio" href="#bib-turtle" title="RDF 1.1 Turtle">Turtle</a></cite>] |
| 1017 | +</section></section><section id="examples-0"><div class="header-wrapper"><h3 id="target-examples"><bdi class="secno">4.3 </bdi>Examples</h3><a class="self-link" href="#target-examples" aria-label="Permalink for Section 4.3"></a></div><p>The following example show a Target of an RDF dump in Turtle [<cite><a class="bibref" data-link-type="biblio" href="#bib-turtle" title="RDF 1.1 Turtle">Turtle</a></cite>] |
1022 | 1018 | format with GZip compression and UTF-8 encoding:</p> |
1023 | 1019 | <pre class="ex-target" aria-busy="false"><code class="hljs"><#VoIDDump> a rml:LogicalTarget; |
1024 | 1020 | rml:target [ a rml:Target, void:Dataset; |
@@ -1148,7 +1144,7 @@ <h1 id="title" class="title">Source & Target</h1> |
1148 | 1144 | ]; |
1149 | 1145 | ]; |
1150 | 1146 | rml:serialization formats:N-Quads; |
1151 | | -.</code></pre></section></section></section> |
| 1147 | +.</code></pre></section></section> |
1152 | 1148 |
|
1153 | 1149 |
|
1154 | 1150 | <section id="logical-source-in-rml-0"><div class="header-wrapper"><h2 id="logical-source-in-rml"><bdi class="secno">5. </bdi>Logical Source in RML</h2><a class="self-link" href="#logical-source-in-rml" aria-label="Permalink for Section 5."></a></div><p>RML is aligned with the Logical Source vocabulary |
|
0 commit comments