QuerySparql - Versionsgeschichte

Mschypula: /* Zugehörige Evaluatoren */

2024-04-17T08:02:47Z

Zugehörige Evaluatoren

← Nächstältere Version		Version vom 17. April 2024, 10:02 Uhr
Zeile 1:		Zeile 1:
	==Zugehörige Evaluatoren==		===Zugehörige Evaluatoren===
	*'''MathEvaluator'''		*'''MathEvaluator'''

	=== Beschreibung ===		=== Beschreibung ===
	Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings und gibt je nach Ergebnis der Anfrage einen String oder eine Liste zurück.		Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings und gibt je nach Ergebnis der Anfrage einen String oder eine Liste zurück.

Striewe: /* Hinweise */

2019-11-15T15:19:18Z

Hinweise

← Nächstältere Version		Version vom 15. November 2019, 17:19 Uhr
Zeile 114:		Zeile 114:

	=== Hinweise ===		=== Hinweise ===
			Bei Abfragen mit Zufallsbestandteilen kann es passieren, dass statt einer erwarteten Menge von mehreren Treffern mit mehreren Spalten (die zu einer Liste von Listen als Rückgabe führen) nur ein Treffer mit mehreren Spalten zurückgegeben wird (der als einfache Liste in der Rückgabe erscheint). Um die Rückgabe zu prüfen, kann [[isSet]] verwendet werden, um für ein beliebiges Element der Rückgabeliste zu prüfen, ob es sich selber wiederum um eine Liste handelt. Falls nicht, kann man die Rückgabe selber in eine zusätzliche Liste verpacken, um die nachfolgende Behandlung für alle Fälle identisch zu gestalten:

			<option name="allTuples" value="querySparql(...)" />
			<option name="testTuple" value="getRandomFromList([var=allTuples])" />
			<option name="tuples" value="ifthenelse(isSet([var=testTuple]),[var=allTuples],list([var=allTuples]))" />
			... weitere Operationen auf [var=tuples] ...

	[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Sparqlfunktionen]]		[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Sparqlfunktionen]]

Striewe: /* Beispiele */

2019-11-15T15:14:32Z

Beispiele

@@ Zeile 18: / Zeile 18: @@
 === Beispiele ===
-  querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; PREFIX wdt: &lt;http://www.wikidata.org/prop/direct/&gt; PREFIX wikibase: &lt;http://wikiba.se/ontology#&gt; PREFIX wd: &lt;http://www.wikidata.org/entity/&gt; PREFIX bd: &lt;http://www.bigdata.com/rdf#&gt; SELECT DISTINCT ?cityLabel ?provLabel ?prov ?city WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), &quot;de&quot; ) ) FILTER (langMatches( lang(?cityL), &quot;de&quot; ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language &quot;de&quot;. }}')
+==== Eine einfache Anfrage an Wikidata ====
-====JUnit Tests====
+==== Eine Abfrage an Sophox (OSM-SPARQL-Endpoint), die zwei vorher bestimmte Variablen berücksichtigt ====
 <span class="mw-customtoggle-myDivision">[Anzeigen]</span>
 <syntaxhighlight lang="java" class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision">

PRanz am 10. Dezember 2018 um 11:10 Uhr

2018-12-10T11:10:41Z

← Nächstältere Version		Version vom 10. Dezember 2018, 13:10 Uhr
Zeile 1:		Zeile 1:
			==Zugehörige Evaluatoren==
			*'''MathEvaluator'''
	=== Beschreibung ===		=== Beschreibung ===
	Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings und gibt je nach Ergebnis der Anfrage einen String oder eine Liste zurück.		Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings und gibt je nach Ergebnis der Anfrage einen String oder eine Liste zurück.

PRanz am 4. Dezember 2018 um 14:26 Uhr

2018-12-04T14:26:39Z

← Nächstältere Version		Version vom 4. Dezember 2018, 16:26 Uhr
Zeile 74:		Zeile 74:
	=== Hinweise ===		=== Hinweise ===

	[[Kategorie:Evaluatorfunktion]][[Kategorie:Sparqlfunktionen]]		[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Sparqlfunktionen]]

Striewe: Die Seite wurde neu angelegt: „=== Beschreibung === Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings u…“

2017-11-24T12:39:08Z

Die Seite wurde neu angelegt: „=== Beschreibung === Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings u…“

Neue Seite

=== Beschreibung ===
Die Funktion ''querySparql'' führt eine SPARQL-Anfrage gegen einen gegebenen Service Endpoint durch. Die Funktion erwartet zwei Strings und gibt je nach Ergebnis der Anfrage einen String oder eine Liste zurück.

=== Syntax ===
querySparql([[Zeichenkette]] endpoint, [[Zeichenkette]] query)

=== Parameter ===
* '''endpoint''' - [[Zeichenkette]] für den zu verwendenden Service Endpoint. Dieser muss mit "http://" oder "https://" angesprochen werden. Beispiel: "https://query.wikidata.org/sparql"
* '''query''' - [[Zeichenkette]] für die Query. Diese muss in gültiger SPARQL-Syntax vorliegen. XML-Entities müssen escaped werden!

=== Return Value ===
* Enthält die SELECT-Klausel der Abfrage genau einen Key und die Abfrage ergibt nur einen Treffer, gibt die Methode eine [[Zeichenkette]] zurück.
* Enthält die SELECT-Klausel der Abfrage mehrere Keys und die Abfrage ergibt nur einen Treffer, gibt die Methode eine [[List]]e von [[Zeichenkette]]n zurück, in der jeder Eintrag für einen des Keys steht.
* Enthält die SELECT-Klausel der Abfrage genau einen Key und die Abfrage ergibt mehrere Treffer, gibt die Methode eine [[List]]e von [[Zeichenkette]]n zurück, in der jeder Eintrag für einen der Treffer steht.
* Enthält die SELECT-Klausel der Abfrage mehrere Keys und die Abfrage ergibt mehrere Treffer, gibt die Methode eine [[List]]e von [[List]]en von [[Zeichenkette]]n zurück. Jeder Eintrag der äußeren Liste steht dann für einen Treffer und jeder Eintrag der inneren Liste für einen der Keys.

=== Beispiele ===
querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX wikibase: <http://wikiba.se/ontology#> PREFIX wd: <http://www.wikidata.org/entity/> PREFIX bd: <http://www.bigdata.com/rdf#> SELECT DISTINCT ?cityLabel ?provLabel ?prov ?city WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), "de" ) ) FILTER (langMatches( lang(?cityL), "de" ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language "de". }}')

====JUnit Tests====
<span class="mw-customtoggle-myDivision">[Anzeigen]</span>
<syntaxhighlight lang="java" class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision">
@Test
public void testQuerySparqlTupleList() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX wikibase: <http://wikiba.se/ontology#> PREFIX wd: <http://www.wikidata.org/entity/> PREFIX bd: <http://www.bigdata.com/rdf#> SELECT DISTINCT ?cityLabel ?prov ?city WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), \"de\" ) ) FILTER (langMatches( lang(?cityL), \"de\" ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language \"de\". }}')", null, null);
Object result = OMToResultVisitor.getInstance().visit(omobj);
assertEquals(true, OMTypeChecker.isOMAWithSymbol(result,OMSymbol.LIST1_LIST));
OMA resultList = (OMA)result;
for (Object o : new ArrayList<>(resultList.getOmel().subList(1, resultList.getOmel().size()))) {
assertEquals(true, OMTypeChecker.isOMAWithSymbol(o, OMSymbol.LIST1_LIST));
}
}

@Test
public void testQuerySparqlSingleTuple() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX wikibase: <http://wikiba.se/ontology#> PREFIX wd: <http://www.wikidata.org/entity/> PREFIX bd: <http://www.bigdata.com/rdf#> SELECT DISTINCT ?cityLabel ?prov ?city WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), \"de\" ) ) FILTER (langMatches( lang(?cityL), \"de\" ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language \"de\". }} LIMIT 1')", null, null);
Object result = OMToResultVisitor.getInstance().visit(omobj);
assertEquals(true, OMTypeChecker.isOMAWithSymbol(result, OMSymbol.LIST1_LIST));
}

@Test
public void testQuerySparqlStringList() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX wikibase: <http://wikiba.se/ontology#> PREFIX wd: <http://www.wikidata.org/entity/> PREFIX bd: <http://www.bigdata.com/rdf#> SELECT ?cityLabel WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), \"de\" ) ) FILTER (langMatches( lang(?cityL), \"de\" ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language \"de\". }}')", null, null);
Object result = OMToResultVisitor.getInstance().visit(omobj);
assertEquals(true, OMTypeChecker.isOMAWithSymbol(result, OMSymbol.LIST1_LIST));
OMA resultList = (OMA)result;
for (Object o : new ArrayList<>(resultList.getOmel().subList(1, resultList.getOmel().size()))) {
assertEquals(true, OMTypeChecker.isOMSTR(o));
}
}

@Test
public void testQuerySparqlSingleString() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql('https://query.wikidata.org/sparql', 'PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX wdt: <http://www.wikidata.org/prop/direct/> PREFIX wikibase: <http://wikiba.se/ontology#> PREFIX wd: <http://www.wikidata.org/entity/> PREFIX bd: <http://www.bigdata.com/rdf#> SELECT ?cityLabel WHERE {{?city wdt:P31 wd:Q515.} UNION {?city wdt:P31 wd:Q839954.} ?city wdt:P131 ?prov. ?prov wdt:P31 wd:Q182547. ?prov rdfs:label ?provL. ?city rdfs:label ?cityL. FILTER (langMatches( lang(?provL), \"de\" ) ) FILTER (langMatches( lang(?cityL), \"de\" ) ) SERVICE wikibase:label { bd:serviceParam wikibase:language \"de\". }} LIMIT 1')", null, null);
Object result = OMToResultVisitor.getInstance().visit(omobj);
assertEquals(true, OMTypeChecker.isOMSTR(result));
}

@Test(expected = FunctionInvalidNumberOfArgumentsException.class)
public void testDeterminantWithZeroParam() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql()", null, null);
OMToResultVisitor.getInstance().visit(omobj);
fail();
}

@Test(expected = FunctionInvalidArgumentTypeException.class)
public void testDeterminantWithWrongArguments() throws OpenMathException, EvaluatorException {
OMOBJ omobj = ExpressionParser.parse("querySparql(1,2)", null, null);
OMToResultVisitor.getInstance().visit(omobj);
fail();
}
</syntaxhighlight>

=== Hinweise ===

[[Kategorie:Evaluatorfunktion]][[Kategorie:Sparqlfunktionen]]