Help:Format debug

From semantic-mediawiki.org
Jump to: navigation, search
Format debug
Sujet :
Informations de Debug pour l'analyse des problèmes dans les réponses aux requêtes.
Fourni par :
Semantic MediaWiki
Ajouté dans la version :
0.7
Retiré depuis la version :
toujours supporté
Nécessite en plus :
rien
Nom du format :
debug
Auteurs :
Markus Krötzsch
Catégories :
Divers

Le format de résultat debug est utilisé pour obtenir des informations d'arrière plan sur la manière dont Semantic MediaWiki a exécuté une requête. Ces informations aident à comprendre pourquoi une requête aurait pu retourner des résultats inattendus, et ceci est vital quand les développeurs doivent corriger des bogues présents dans les resultats des requêtes.

Paramètres

Il n'y a pas de paramètres spécifiques au format debug pour les requêtes intégrées.

Paramètre Type Par défaut Description
sep texte vide Le séparateur de valeurs
template texte vide Le nom d'un modèle qui servira à afficher les résultats
template arguments texte vide Sets how the named arguments are passed to the template
named args oui/non no Nommez les arguments transmis au modèle
userparam texte vide Une valeur passée dans chaque appel de modèle, si un modèle est utilisé
introtemplate texte vide Le nom d'un modèle à afficher avant les résultats de requête, s'il y en a
outrotemplate texte vide Le nom d'un modèle à afficher après les résultats de la requête, s'il y en a
import-annotation oui/non no Les données supplémentaires annotées sont copiées lors de l’analyse d’un sujet

Exemple

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population
| ?area#km² = Size in km²
| format=debug
}}

Produit la sortie suivante:

SQLStore debug output
ASK Query
[[Category:City]] [[Located in::Germany]]
SQL Query
SELECT DISTINCT
  t0.smw_id AS id,
  t0.smw_title AS t,
  t0.smw_namespace AS ns,
  t0.smw_iw AS iw,
  t0.smw_subobject AS so,
  t0.smw_sortkey AS sortkey, t0.smw_sortkey
FROM
  `smw_object_ids` AS t0
INNER JOIN
  `smw_fpt_inst` AS t2 ON t0.smw_id=t2.s_id
INNER JOIN
  `t3` AS t3 ON t2.o_id=t3.id
INNER JOIN
  `smw_di_wikipage` AS t4 ON t2.s_id=t4.s_id
INNER JOIN
  `t5` AS t5 ON t4.p_id=t5.id
WHERE
  (
   (t4.o_id='779')
  )
  AND t0.smw_iw!=':smw'
  AND t0.smw_iw!=':smw-delete'
  AND t0.smw_iw!=':smw-redi'
ORDER BY
  t0.smw_sortkey ASC
LIMIT
  55
OFFSET
  0
SQL Explain
IDselect_typetabletypepossible_keyskeykey_lenrefrowsExtra
1SIMPLEt5ALLPRIMARY2Using temporary; Using filesort
1SIMPLEt4refs_id,p_id,o_idp_id9DB0231020151216.t5.id,const4
1SIMPLEt0eq_refPRIMARY,smw_id,smw_iwPRIMARY4DB0231020151216.t4.s_id1Using where
1SIMPLEt2refs_id,o_ids_id4DB0231020151216.t4.s_id2Using where; Distinct
1SIMPLEt3eq_refPRIMARYPRIMARY4DB0231020151216.t2.o_id1Distinct
Auxilliary Tables
  • Temporary table t3
      Recursively computed hierarchy for element(s) ('490').
  • Temporary table t5
      Recursively computed hierarchy for element(s) ('86').
Query Metrics
Query-Size:3
Query-Depth:1
Errors and Warnings
None

Comment lire les informations de sortie du Debug

La sortie du debug contient certaines informations qui ne sont utiles qu'aux développeurs, mais aussi d'autres informations qui peuvent être instructives pour les éditeurs du wiki pour déboguer une requête.

Les parties les plus lisibles se trouvent au début. C'est habituellement une version de la requête wiki telle que SMW la comprend. La requête affichée pourrait être différente de ce que l'utilisateur a entré. Cela serait dû au fait que SMW exprime simplement certaines requêtes sous différentes formes (différentes façons d'écrire) mais cela pourrait aussi montrer que certains aspects de la requête n'ont pas été compris ou ont mal été interprétés par SMW.

On donne aussi quelques informations d'ordre statistique sur la taille de la requête et la profondeur de la requête, ainsi que les messages d'erreurs qui sont apparus. La taille et la profondeur sont des paramètres internes utilisés par SMW pour limiter la complexité des requêtes. L'administrateur du wiki peut restreindre les requêtes à une taille maximale ou une profondeur maximale (cela sera ensuite signalé comme une erreur si ça pose problème), et ce message pourra aider à comprendre comment la taille et la profondeur interagissent dans certaines requêtes.

Le reste des informations de debug concerne habituellement les fonctions internes de stockage exécutées par SMW pour répondre à la requête. Cette partie dépend aussi de l'implémentation particulière de l'archivage et de la version de SMW, et habituellement les développeurs seront les seuls pour qui cela sera utile.

Remarques

Le détail des informations sorties par le debug dépend de la version de SMW et du moteur de stockage utilisés. Cette information devrait se retrouver dans les comptes rendus du debug.



Cette page de documentation concerne toutes les versions de SMW depuis la 0.7 jusqu'à la version la plus récente.
      Autres langues : deenzh-hans

Help:Debug format fr 0.7