Aller au contenu

Découverte des ensembles de données depuis le WIS2 Global Discovery Catalogue

Objectifs d'apprentissage !

À la fin de cette session pratique, vous serez capable de :

  • utiliser pywiscat pour découvrir des ensembles de données depuis le Global Discovery Catalogue (GDC)

Introduction

Dans cette session, vous apprendrez à découvrir des données depuis le WIS2 Global Discovery Catalogue (GDC) en utilisant pywiscat, un outil en ligne de commande permettant de rechercher et de récupérer des métadonnées depuis un GDC WIS2.

Actuellement, les GDC suivants sont disponibles :

Lors des sessions de formation locale, un GDC local est configuré pour permettre aux participants d'interroger le GDC pour les métadonnées qu'ils ont publiées depuis leurs instances de wis2box. Dans ce cas, les formateurs fourniront l'URL du GDC local.

Préparation

Note

Avant de commencer, veuillez vous connecter à votre machine virtuelle étudiante (VM).

Installation de pywiscat

Utilisez l'installateur de paquets Python pip3 pour installer pywiscat sur votre VM : 

pip3 install pywiscat

Note

Si vous rencontrez l'erreur suivante :

WARNING: The script pywiscat is installed in '/home/username/.local/bin' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

Exécutez alors la commande suivante :

export PATH=$PATH:/home/$USER/.local/bin

...où $USER est votre nom d'utilisateur sur votre VM.

Vérifiez que l'installation a réussi :

pywiscat --version

Recherche de données avec pywiscat

Par défaut, pywiscat se connecte au Global Discovery Catalogue (GDC) hébergé par Environnement et Changement climatique Canada (ECCC).

Changer l'URL du GDC

Si vous effectuez cet exercice lors d'une session de formation locale, vous pouvez configurer pywiscat pour interroger le GDC local en définissant la variable d'environnement PYWISCAT_GDC_URL :

export PYWISCAT_GDC_URL=http://gdc.training.wis2dev.io

Pour voir les options disponibles, exécutez :

pywiscat search --help

Vous pouvez rechercher dans le GDC tous les enregistrements :

pywiscat search

Question

Combien d'enregistrements sont retournés par la recherche ?

Cliquez pour révéler la réponse

Le nombre d'enregistrements dépend du GDC que vous interrogez. Lors de l'utilisation du GDC local de formation, vous devriez constater que le nombre d'enregistrements est égal au nombre d'ensembles de données qui ont été ingérés dans le GDC lors des autres sessions pratiques.

Essayons d'interroger le GDC avec un mot-clé :

pywiscat search -q observations

Question

Quelle est la politique de données des résultats ?

Cliquez pour révéler la réponse

Toutes les données retournées doivent spécifier des données "core".

Essayez des requêtes supplémentaires avec -q.

Tip

Le drapeau -q permet la syntaxe suivante :

  • -q synop : trouver tous les enregistrements contenant le mot "synop"
  • -q temp : trouver tous les enregistrements contenant le mot "temp"
  • -q "observations AND oman" : trouver tous les enregistrements contenant les mots "observations" et "oman"
  • -q "observations NOT oman" : trouver tous les enregistrements contenant le mot "observations" mais pas le mot "oman"
  • -q "synop OR temp" : trouver tous les enregistrements contenant "synop" ou "temp"
  • -q "obs*" : recherche approximative

Lors de la recherche de termes contenant des espaces, utilisez des guillemets doubles.

Obtenons plus de détails sur un résultat de recherche spécifique qui nous intéresse :

pywiscat get <id>

Tip

Utilisez la valeur id obtenue lors de la recherche précédente.

Conclusion

Félicitations !

Lors de cette session pratique, vous avez appris à :

  • utiliser pywiscat pour découvrir des ensembles de données depuis le WIS2 Global Discovery Catalogue