Help:Ergebnisformat debug
| Ergebnisformat debug | |
|---|---|
| Gibt anstatt eines Ergebnisses Informationen zur Abfrage für die Fehlersuche und -analyse aus | |
| Weitere Informationen | |
| Software: | Semantic MediaWiki |
| Verfügbar seit: | 0.7 |
| Verfügbar bis: | aktuell unterstützt |
| Voraussetzungen: | keine |
| Name: | debug |
| Standardmäßig aktiviert:info.pngGibt an, ob das Ergebnisformat standardmäßig mit Installation der betreffenden Softwareerweiterung aktiviert ist. | ja |
| Autoren: | Markus Krötzsch |
| Kategorie(n): | Sonstige |
| Inhaltsverzeichnis | |
Das Ergebnisformat debug wird dazu eingesetzt, anstatt eines Ergebnisses zu einer eingebetteten Abfrage, Informationen zur ihr für die Fehlersuche und -analyse auszugeben. Diese Informationen helfen dabei nachzuvollziehen, warum eine Abfrage möglicherweise unerwartete Ergebnisse ausgibt. Sei sind somit unerlässlich für die Softwareentwickler bei der Beseitigung von Programmfehlern.
Parameter
Die folgende Tabelle gibt einen Überblick über die verfügbaren Parameter, beschreibt sie kurz und gibt deren Standardwerte mitsamt dem zugehörigen Eingabetyp an.
| Parameter | Type | Default | Description |
|---|---|---|---|
| intro | Text | empty | The text to display before the query results, if there are any |
| outro | Text | empty | The text to display after the query results, if there are any |
| default | Text | empty | The text to display if there are no query results |
| sep | Text | empty | The separator for values |
| template | Text | empty | The name of a template with which to display the printouts |
| named args | Yes/no | no | Name the arguments passed to the template |
| userparam | Text | empty | A value passed into each template call, if a template is used |
| introtemplate | Text | empty | The name of a template to display before the query results, if there are any |
| outrotemplate | Text | empty | The name of a template to display after the query results, if there are any |
Beispiel
{{#ask: [[Kategorie:Stadt]] [[Liegt in::Deutschland]]
| ?Bevölkerung
| ?Fläche#km² = Größe in km²
| format=debug
}}
Ergebnis:
Debug Output by SMWSQLStore2
Generated Wiki-Query
[[Category:City]] [[Located in::Germany]]
Query Metrics
Query-Size:3Query-Depth:1
SQL Query
SELECT DISTINCT t6.smw_title AS t,t6.smw_namespace AS ns FROM `smw_ids` AS t6 INNER JOIN `smw_inst2` AS t1 ON t6.smw_id=t1.s_id INNER JOIN `t2` AS t2 ON t1.o_id=t2.id INNER JOIN `smw_rels2` AS t3 ON t1.s_id=t3.s_id WHERE ((t3.p_id='421' AND t3.o_id='103')) ORDER BY t6.smw_sortkey ASC LIMIT 51 OFFSET 0;Auxilliary Tables Used
- Temporary table t2
Recursively computed hierarchy for element(s) ('104').
Errors and Warnings
NoneInterpretation der Ausgabe
Die Informationen zur Fehlersuche und -analyse sind lediglich für Softwareentwickler nützlich, zeigt aber auch Informationen an, die einem Benutzern eines Wikis dabei helfen eine Abfrage zu bereinigen.
Die allgemein verständlicheren Informationen „Generated Wiki-Query“ werden oben angezeigt. Dies ist üblicherweise die Abfragebeschreibungen wie sie von SMW verstanden wird. Die angezeigte Abfragebeschreibung kann sich dabei von der Angabe des Benutzers unterscheiden. Dies kann zum einen daran liegen, dass SMW die Abfrage anders im Sinn einer alternativen Abfragebeschreibung ausdrückt. Zum anderen kann dies auch daran liegen, dass Teile der Abfragebeschreibung nicht oder falsch von SMW verstanden wird.
Es folgen die statistischen Informationen „Query Metrics“ zu ‚Query-Size‘ (Größe) und ‚Query-Depth‘ (Tiefe) zusammen mit den aufgetretenen Fehlermeldungen. Bei Größe und Tiefe handelt es sich um von SMW intern genutzte Parameter, die die Komplexität von Abfragen festlegen. Der Administrator eines Wikis kann diese Parameter (Größe und Tiefe) zentral einstellen. Sofern diese Einstellungen ein Problem verursachen, wird dies angezeigt und trägt so zudem dazu bei das Zusammenspiel von Größe und Tiefe im Zusammenhang mit bestimmten Abfragen zu verstehen.
Die restlichen Informationen „SQL Query“ beziehen sich auf die internen Speicherfunktionen, die von SMW ausgeführt werden, um die Abfrage zu beantworten. Dies ist abhängig von der genutzten Standarddatenablage sowie der Version von SMW. Diese Informationen sind lediglich für Softwareentwickler aufschlussreich.
Hinweis
Die Einzelheiten der Informationen zur Fehlersuche und -analyse sind abhängig von der genutzten Standarddatenablage sowie von der Version von SMW. Beide Informationen sollten im Rahmen von Fehlerberichten an den Softwareentwickler mit weitergegeben werden.
