Connecteur JSON Schema

Modifié le : Mar, 25 Mars, 2025 à 11:58 H

Cet article explique comment utiliser le connecteur JSON Schema pour DataGalaxy.

Ce connecteur est disponible dans les modes suivants :

Mode SaaS Online ❌

Qu'est-ce que JSON Schema ?

Un fichier JSON Schema permet de décrire les métadonnées et spécifier des règles sur la structure d'un autre fichier JSON. Un fichier JSON Schema peut par exemple être utilisé pour décrire et contrôler le contenu d'un topic Kafka.

La syntaxe JSON Schema est définie par la spécification disponible sur le site https://json-schema.org/specification.html .

Par exemple, pour spécifier le format du fichier suivant :

{
  "productId": 1,
  "productName": "A green door",
  "price": 12.50,
  "tags": [ "home", "green" ]
}

Il est possible d'utiliser le JSON Schema ci-dessous :

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.com/product.schema.json",
  "title": "Product",
  "description": "A product from Acme's catalog",
  "type": "object",
  "properties": {
    "productId": {
      "description": "The unique identifier for a product",
      "type": "integer"
    },
    "productName": {
      "description": "Name of the product",
      "type": "string"
    },
    "price": {
      "description": "The price of the product",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "tags": {
      "description": "Tags for the product",
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "uniqueItems": true
    }
  },
  "required": [ "productId", "productName", "price" ]
}

Pour plus d'exemples, vous pouvez consulter la page suivante : https://json-schema.org/learn/getting-started-step-by-step.html .

Présentation du connecteur

⚠ Le connecteur ne permet pas de déterminer automatiquement le schéma de n'importe quel fichier JSON. Les fichiers JSON à scanner avec ce connecteur doivent respecter la spécification JSON Schema décrite ci-dessus.

Le connecteur permet d'importer des objets dans une source de type NoSQL à partir d'un ou plusieurs fichiers JSON Schema (extension .json par défaut) stockés dans un répertoire accessible par le connecteur. Les objets récupérés et leurs correspondances dans DataGalaxy sont détaillés dans le tableau suivant :

Objet JSON Schema	Objet DataGalaxy	Commentaires
Object	Document	Objet défini par le fichier JSON Schema
Properties	Champ / Sous-Structure	Propriétés de l'objet Si la propriété est un objet complexe contenant des propriétés enfants, une sous-structure sera créée dans DataGalaxy
Object ref	Sous-structure	Les référencées à des objets sont résolues et représentées à l'aide d'une sous-structure. Les propriétés de l'objet référencé sont représentées en tant qu'enfants de cette sous-structure.

Etape 1 : Installation

Télécharger le connecteur DataGalaxy depuis le portail (voir ici)
Extraire l'archive du connecteur dans le répertoire de votre choix
Télécharger le plug-in JSON Schema depuis le portail et le copier dans le répertoire /lib du connecteur

Etape 2 : Exécution du connecteur JSON Schema

Après avoir démarré le connecteur, accéder aux connecteurs du Dictionnaire :

S'il a été correctement installé, le plug-in JSON Schema apparaît dans la liste
L'information suivante est demandée :

Paramètre	Obligatoire	Description
Chemin	Oui	Chemin du répertoire qui contient les fichiers JSON Schema
Extensions	Non	Liste d'extensions (séparées par des virgules) à détecter par le connecteur en plus de l'extension par défaut .json Par exemple : json-schema, jsonschema

Une fois cette information renseignée, vous pouvez lancer la procédure d'import.

Plus d'informations sur le mode opératoire du connecteur disponibles ici

Informations techniques

Lien vers la documentation de JSON Schema : https://json-schema.org/

Releases

Date	Plugin Version	DataGalaxy release	Desktop connector version (minimum)	Description
26/07/2024	3.0.0	v3.62.0	5.0.3	Migrated from java 11 to java 17

French