バンドルされているjoseki.warをApache TomcatまたはOracle WebLogic Serverにデプロイする手順は次のとおりです。

この項では、SPARQLサービス・エンドポイントをApache Tomcat 7.0にデプロイする方法について説明します。Apache Tomcatは、Java ServletとJavaServer Pages (JSP)を実装するオープンソースのWebサーバーであり、Webアプリケーションを実行するHTTP Webサーバー環境を構築します。Apache Tomcatの詳細とサポートについては、http://tomcat.apache.org/を参照してください。

「Oracle NoSQL Database SPARQL Endpoint Query Results」というタイトルのページが表示されます。問合せ実行に対象となった基盤のセマンティック・モデルによって、結果は表示されることも表示されないこともあります。

この項では、SPARQLサービス・エンドポイントをOracle WebLogic Server 12cにデプロイする方法について説明します。Oracle WebLogic Serverの詳細は、http://www.oracle.com/technology/products/weblogic/を参照してください。

デフォルトでは、joseki-config.ttlファイルにはOracle NoSQL Databaseに格納されているすべてのグラフを使用するoracle-nosql:Datasetの定義が含まれています。次のスニペットは、この構成を示したものです。

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 3;  ## Number of concurrent connections allowed 
                    ## to this dataset.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
oracle-nosql:storeName "mystore";
oracle-nosql:hostPort "5000";
];
oracle-nosql:allGraphs [] .       ## Graph descriptions

oracle-nosql:allGraphs述語では、SPARQLサービス・エンドポイントがOracle NoSQL Databaseに格納されているすべての名前付きグラフ(デフォルトのグラフも含む)を使用して問合せを実行することを指定しています。問合せを実行するときに使用するルールベースも指定できます。次の例では、SPARQLサービス・エンドポイントがすべての名前付きグラフ(表明および推論されたトリプルも含み、これはルールベースID 1でマークされています)を使用して問合せを実行することが、oracle:ruleBaseID述語によって示されています。

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 3;  ## Number of concurrent connections allowed
                    ## to this dataset.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
oracle-nosql:storeName "mystore";
oracle-nosql:hostPort "5000";
];
oracle-nosql:allGraphs [ oracle-nosql:ruleBaseID "1" .  ] . 
## Graph descriptions

SPARQLサービス・エンドポイントで、指定したセットのグラフ名のみを使用して問合せを実行する必要がある場合には、述語としてoracle-nosql:allGraphsではなくoracle-nosql:namedGraphを使用します。この構成の詳細は、「SPARQLサービスの構成: Oracle NoSQL Database」を参照してください。

次のJavaコード・スニペットを使用すると、サンプルのトリプルおよびクワッドをいくつか追加して名前付きグラフ機能をテストできます。

public static void main(String[] args) throws Exception
{
String szStoreName  = args[0];
String szHostName   = args[1];
String szHostPort   = args[2];
    
System.out.println("Create Oracle NoSQL connection");
OracleNoSqlConnection conn  =         
OracleNoSqlConnection.createInstance(szStoreName,
                                     szHostName,   
                                     szHostPort);   
System.out.println("Create Oracle NoSQL graph and dataset ");
OracleGraphNoSql graph = new OracleGraphNoSql(conn);
DatasetGraphNoSql datasetGraph = DatasetGraphNoSql.createFrom(graph);

// Close graph, as it is no longer needed
graph.close();  

// add data to the bob named graph
datasetGraph.add(new Quad(
        Node.createURI("http://example.org/bob"), // graph name
        Node.createURI("urn:bob"),
        Node.createURI("http://xmlns.com/foaf/0.1/name"),
        Node.createLiteral("Bob")));
    
// add data to the alice named graph
datasetGraph.add(new Quad(
        Node.createURI("http://example.org/alice"), // graph name
        Node.createURI("urn:alice"),
        Node.createURI("http://xmlns.com/foaf/0.1/name"),
        Node.createLiteral("Alice")));
ds.close();
conn.dispose();   
}

クワッドを挿入したら、http://<hostname>:7001/joseki (Oracle WebLogic Serverの場合)またはhttp://<hostname>:8080/joseki (Apache Tomcatの場合)に移動し、次のSPARQL問合せを入力して「Submit Query」をクリックします。

SELECT ?g ?s ?p ?o
WHERE 
{ GRAPH ?g 
   { ?s ?p ?o} 
}

結果は、4つの列と2セットの結果バインディングからなるHTML表になります。

このページには、「JSON Output」オプションもあります。このオプションを選択する(有効にする)と、SPARQL問合せの応答がJSON形式に変換されます。

Oracle NoSQL Databaseへの接続を構成するには、/tmp/joseki.warにあるApache Jena Josekiの構成ファイル(joseki-config.ttl)を変更し、Oracle NoSQL Databaseにアクセスする際のストア名、ホスト名、ホスト・ポートを指定する必要があります。この値がSPARQLサービス・エンドポイントで使用され、Oracle NoSQL Databaseへの接続が確立されて更新および問合せの操作が実行されます。

このデータを定義するには、joseki-config.ttlのoracle-nosql:connection述語を参照してください。この述語では、SPARQLサービス・エンドポイントが<store_name>という名前のOracle NoSQLデータベースに接続することを指定しています。アクセスに使用されるホスト名が<host_name>、ポートが<host_port>です。次のスニペットは、この構成を示したものです。

<#oracle> rdf:type oracle-nosql:Dataset;
joseki:poolSize 1;  ## Number of concurrent connections allowed to 
                    ## this data set.
oracle-nosql:connection  ## NoSQL connection
[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName <host_name>;
oracle-nosql:storeName <store_name>;
oracle-nosql:hostPort <host_port>;
];
...

SPARQLサービス・エンドポイントは、指定されたOracle NoSQLデータベースに格納されているすべての名前付きグラフ(デフォルトのグラフも含む)に対して問合せが実行されるものとデフォルトで想定しています。<domain_name>/autodeploy/joseki.warにある構成ファイルjoseki-config.ttlを編集すれば、この設定を変更してデフォルトのグラフのみ、または名前付きグラフのサブセットのみを使用して問合せを実行できます。

用意されているjoseki-config.ttlファイルには、次のようにOracle NoSQL Databaseのデータセットを示すセクションがあります。

#
## Datasets
#
[] ja:loadClass 
"oracle.spatial.rdf.client.jena.assembler.OracleAssemblerVocab" . 

oracle-nosql:Dataset rdfs:subClassOf ja:RDFDataset . 
      
<#oracle> rdf:type oracle-nosql:Dataset;
## Number of concurrent connections allowed to this dataset.
joseki:poolSize 1;  
	
oracle-nosql:connection  ## connection to an Oracle NoSQL Database
 	[ 
rdf:type oracle-nosql:NoSQLConnection;
oracle-nosql:hostName "localhost";
  		oracle-nosql:storeName "mystore";
       oracle-nosql:hostPort "5000";
];

oracle-nosql:allGraphs [] .

ファイルのこのセクションで、次の操作が可能です。