Principle:Mage ai Mage ai JSON Schema Loading
| Knowledge Sources | |
|---|---|
| Domains | Data_Integration, Schema_Management |
| Last Updated | 2026-02-09 00:00 GMT |
Overview
A convention-based schema loading mechanism that reads JSON Schema Draft 4 files from a connector's schemas directory to define stream data structures.
Description
JSON Schema Loading provides the schema foundation for API and file-based source connectors. Rather than discovering schemas dynamically from a database, these connectors define their stream schemas as static JSON files. Each file name (minus .json extension) becomes the stream ID, and its contents define the JSON Schema properties, types, and formats. The loading mechanism uses the connector class's file location to resolve the schemas directory path.
Usage
Use this principle for any source connector that cannot introspect schemas at runtime. Define one JSON file per stream in the schemas/ directory within the connector package.
Theoretical Basis
JSON Schema Draft 4 property types used in Singer:
- string - text values, optionally with format "date-time" or "uuid"
- integer - whole numbers
- number - floating point numbers
- boolean - true/false values
- object - nested JSON objects
- array - JSON arrays
- null - nullable indicator (used in type arrays like ["null", "string"])