<docbook><section><title>VirtTipsAndTricksGuideTrblLinkedDataViews</title><para> </para>
<title> Troubleshooting Linked Data Views generated from a Relational Database</title> Troubleshooting Linked Data Views generated from a Relational Database
<bridgehead class="http://www.w3.org/1999/xhtml:h2">What?</bridgehead>
<para>Virtuoso provides powerful options for generating 5-Star Linked Data from ODBC and JDBC accessible RDBMS based data sources.
 It provides you with the ability to produce transient and materialized Linked Data views using its native Metaschema Language or the W3C&#39;s R2RML.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Why?</bridgehead>
<para>Being able to diagnose problems associated with Linked Data views generation is vital for sustainable usage of this powerful Virtuoso feature.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">How?</bridgehead>
<para>The following steps guide you through the process of generating Linked Data Views and isolating problems that might arise during the process:</para>
<orderedlist spacing="compact"><listitem>Pick an example script building your view, in this case we use one that builds <ulink url="VirtTipsAndTricksLinkedDataViewsDB2Script">Linked Data Views from the DB2 hosted data</ulink>.
</listitem>
<listitem>It might happen that while running the script you receive <ulink url="VirtTipsAndTricksLinkedDataViewsDB2ScriptOutput">output</ulink> errors such as: <programlisting>22023 The quad storage &quot;http://www.openlinksw.com/schemas/virtrdf#DefaultQuadStorage&quot; is edited by other client, started 2011-12-19 16:20:48
</programlisting></listitem>
<listitem>The error above means that a manipulation was started at 2011-12-19 16:20:48, but it never completed.
 The default remedy is to use Virtuoso&#39;s <ulink url="http://docs.openlinksw.com/virtuoso/fn_rdf_audit_metadata.html">DB.DBA.RDF_AUDIT_METADATA()</ulink> function, as follows: <programlisting>SQL&gt; DB.DBA.RDF_AUDIT_METADATA(1, &#39;*&#39;);
</programlisting></listitem>
<listitem>The resulting output should contain no errors.
</listitem>
<listitem>Some demo links from the created Linked Data Views:  <itemizedlist mark="bullet" spacing="compact"><listitem>Instance Data Named Graph <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://demo.openlinksw.com/DB2HUGH#">http://demo.openlinksw.com/DB2HUGH#</ulink>  </listitem>
</itemizedlist></listitem>
<listitem>Metadata Data (<ulink url="http://www.w3.org/TR/void/">VoID</ulink>) <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/stat#">http://demo.openlinksw.com/DB2HUGH/stat#</ulink>  </listitem>
</itemizedlist></listitem>
<listitem>Ontology Data Named Graph <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/">http://demo.openlinksw.com/schemas/DB2HUGH/</ulink>  </listitem>
</itemizedlist></listitem>
<listitem>Quad Maps <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-cl_sched">http://demo.openlinksw.com/schemas/DB2HUGH/qm-cl_sched</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-department">http://demo.openlinksw.com/schemas/DB2HUGH/qm-department</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-employee">http://demo.openlinksw.com/schemas/DB2HUGH/qm-employee</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_act">http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_act</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_photo">http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_photo</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_resume">http://demo.openlinksw.com/schemas/DB2HUGH/qm-emp_resume</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-in_tray">http://demo.openlinksw.com/schemas/DB2HUGH/qm-in_tray</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-org">http://demo.openlinksw.com/schemas/DB2HUGH/qm-org</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-project">http://demo.openlinksw.com/schemas/DB2HUGH/qm-project</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-sales">http://demo.openlinksw.com/schemas/DB2HUGH/qm-sales</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-staff">http://demo.openlinksw.com/schemas/DB2HUGH/qm-staff</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/schemas/DB2HUGH/qm-VoidStatistics">http://demo.openlinksw.com/schemas/DB2HUGH/qm-VoidStatistics</ulink>  </listitem>
</itemizedlist></listitem>
<listitem>Sample URIs <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/department/DEPTNO/A00#this">http://demo.openlinksw.com/DB2HUGH/department/DEPTNO/A00#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/employee/EMPNO/000010#this">http://demo.openlinksw.com/DB2HUGH/employee/EMPNO/000010#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/emp_act/EMPNO/000010/PROJNO/MA2100/ACTNO/10#this">http://demo.openlinksw.com/DB2HUGH/emp_act/EMPNO/000010/PROJNO/MA2100/ACTNO/10#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/emp_photo/EMPNO/000130/PHOTO_FORMAT/bitmap#this">http://demo.openlinksw.com/DB2HUGH/emp_photo/EMPNO/000130/PHOTO_FORMAT/bitmap#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/emp_resume/EMPNO/000130/RESUME_FORMAT/ascii#this">http://demo.openlinksw.com/DB2HUGH/emp_resume/EMPNO/000130/RESUME_FORMAT/ascii#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/org/DEPTNUMB/10/MANAGER/160#this">http://demo.openlinksw.com/DB2HUGH/org/DEPTNUMB/10/MANAGER/160#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/project/PROJNO/AD3100#this">http://demo.openlinksw.com/DB2HUGH/project/PROJNO/AD3100#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/sales/SALES_DATE/1995-12-31T05:00:00Z/SALES_PERSON/LUCCHESSI/REGION/Ontario-South/SALES/1#this">http://demo.openlinksw.com/DB2HUGH/sales/SALES_DATE/1995-12-31T05:00:00Z/SALES_PERSON/LUCCHESSI/REGION/Ontario-South/SALES/1#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/staff/ID/10#this">http://demo.openlinksw.com/DB2HUGH/staff/ID/10#this</ulink> </listitem>
<listitem><ulink url="http://demo.openlinksw.com/DB2HUGH/stat#">http://demo.openlinksw.com/DB2HUGH/stat#</ulink></listitem>
</itemizedlist></listitem>
</itemizedlist></listitem>
</orderedlist><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Related</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="VirtTipsAndTricksGuide">Virtuoso Tips and Tricks Collection</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksRDFTriggers">&quot;Generate RDB2RDF triggers&quot; and &quot;Enable Data Syncs with Physical Quad Store&quot; Linked Data Views options</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksGuideConductorR2RML">Generate Transient and/or Persistent Linked Data Views atop ODBC or JDBC accessible Relational Data Sources</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksGuideOWLIinfLinkedVocab">Using OWL based inference to exploit the power of Linked Vocabularies</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksImportLinkedDataCreateFeature">Import Linked Data using the Briefcase &quot;Create&quot; feature</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksInstallPattern">Simple Linked Data Deployment using Virtuoso&#39;s HTTP Re-write Rules</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksGuideReificationAltern">Reification alternatives usage for Linked Data publishing</ulink> </listitem>
<listitem><ulink url="VirtTipsAndTricksGuideLinkedDataSimpleGuide">Virtuoso Linked Data Deployment In 3 Simple Steps</ulink> </listitem>
<listitem><ulink url="VirtXMLAODBCExplorerLinkedDataViews">Expose Linked Data View URIs associated with &quot;References&quot; on a given Table</ulink> </listitem>
<listitem><ulink url="VirtLinkedDataPresCollection">Manage Linked (Open) Data</ulink></listitem>
</itemizedlist><para> </para>
</section></docbook>