Help:Format debug

From semantic-mediawiki.org
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[edit]

Il n'y a pas de paramètres spécifiques au format debug pour les requêtes intégrées. Ce format de résultat ne met pas particulèrement en forme les paramètres.

Exemple[edit]

{{#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_sort
FROM
  `smw_object_ids` AS t0
INNER JOIN
  (`smw_fpt_inst` AS t2
INNER JOIN
  `t3` AS t3 ON t2.o_id=t3.id
INNER JOIN
  (`smw_di_wikipage` AS t4
INNER JOIN
  `t5` AS t5 ON t4.p_id=t5.id) ON t2.s_id=t4.s_id) ON t0.smw_id=t2.s_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_sort ASC
LIMIT
  55
OFFSET
  0
SQL Explain
IDselect_typetabletypepossible_keyskeykey_lenrefrowsExtra
1SIMPLEt5ALLPRIMARY2Using temporary; Using filesort
1SIMPLEt4refs_id,o_id,p_id,s_id_2,s_id_3,o_id_2,o_id_3o_id_39const,DB0231020151216.t5.id2
1SIMPLEt0eq_refPRIMARY,smw_id,smw_iw,smw_iw_2PRIMARY4DB0231020151216.t4.s_id1Using where
1SIMPLEt2refs_id,o_id,s_id_2,o_id_2s_id_24DB0231020151216.t4.s_id1Using where; Using index; Distinct
1SIMPLEt3eq_refPRIMARYPRIMARY4DB0231020151216.t2.o_id1Distinct
Auxilliary Tables
  • Temporary table t3
      Recursively computed hierarchy for element(s) ('148509').
      SELECT s_id FROM `smw_fpt_subc` WHERE o_id='148509' LIMIT 1
  • Temporary table t5
      Recursively computed hierarchy for element(s) ('148244').
      SELECT s_id FROM `smw_fpt_subp` WHERE o_id='148244' LIMIT 1
Query Metrics
Query-Size:3
Query-Depth:1
Errors and Warnings
None

Comment lire les informations de sortie du Debug[edit]

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[edit]

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