[Mulgara-dev] Re: Relational Resolver Documentation

[Andrae Muys]

On 22/07/2007, at 7:11 AM, David Wood wrote:

> Hi Andrae,
>
> A company in DC has been asking me for documentation for the  
> Mulgara relational resolver.  I think the relational resolver is  
> interesting enough that it should be highlighted on the Mulgara  
> home page - which can't happen without documentation either.
>
> What documentation did you create for it?  Was any of it licensed  
> under a GFDL or CC?  Can you provide any written directions on the  
> configuration, use and troubleshooting of the resolver?  Thanks!!

There was some basic documentation I thought I sent to the list.   
However the documentation doesn't cover D2RQ, which is the mapping  
definition format I used.

Using the relational resolver is reasonably straight forward.

1. Make sure the relevant jdbc driver is in/on the classpath

2. Make sure the RelationalResolverFactory is being loaded by  
ensuring the line
       <ResolverFactory  
class="org.mulgara.resolver.relational.RelationalResolverFactory"/>
      is included in the config file you are using (the default  
configuration file already has this line included)

3. Create model of type rmi://mulgara.org/mulgara#RelationalModel

4. Create your D2RQ mapping file (see data/ISWC-d2rq.rdf for an example)

5. Load the mapping file into the ?def model associated with your  
relational model
      This model is automatically created when you create the  
relational model in step 3.
      This is identical to the way views are defined and managed.

6. Perform queries against the model created in step 3.

I'll have a hunt around and see if I can't find the document I wrote  
before.  It does look like I need to sit down and write more  
comprehensive documentation.

Andrae

-- 
Andrae Muys
andrae at netymon.com
Mulgara Consultant
Netymon Pty Ltd