Help:Format debug
| 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:
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
| ID | select_type | table | type | possible_keys | key | key_len | ref | rows | filtered | Extra |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | SIMPLE | t5 | ALL | PRIMARY | 2 | Using temporary; Using filesort | ||||
| 1 | SIMPLE | t4 | ref | s_id, o_id, p_id, s_id_2, s_id_3, o_id_2, o_id_3 | o_id_3 | 9 | const, DB9907220070920.t5.id | 1 | ||
| 1 | SIMPLE | t2 | ref | s_id, o_id, s_id_2, o_id_2 | s_id_2 | 4 | DB9907220070920.t4.s_id | 1 | Using where; Using index | |
| 1 | SIMPLE | t3 | eq_ref | PRIMARY | PRIMARY | 4 | DB9907220070920.t2.o_id | 1 | ||
| 1 | SIMPLE | t0 | eq_ref | PRIMARY, smw_id, smw_iw, smw_iw_2 | PRIMARY | 4 | DB9907220070920.t4.s_id | 1 | Using where |
- 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-Depth:1
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.
