Documentation

No results
    gitHub

    Schema design in a schemaless world

    The JSON-based dynamic-schema nature (aka schema-less nature) of document NoSQL databases (MongoDB, DynamoDB, Couchbase, etc...) is a fantastic opportunity for application developers: ability to start storing and accessing data with minimal effort and setup, flexibility, fast and easy evolution.

     

    Some difficulties start appearing with increased complexity of the data and scale.  Typically, the data structure is tacitly described -- in the application code…  And examining the code is not the most productive way to engage in a fruitful dialog between analysts, architects, designers, developers, and DBAs.

     

    A data model describes the business.  A data model is the blueprint of the application.  Such a map helps evaluate design options beforehand, think through the implications of different alternatives, and recognize potential hurdles before committing sizable amounts of development effort.  A data model helps plan ahead, in order to minimize later rework.  In the end, the modeling process accelerates development, increases quality of the application, and reduces execution risks.  

     

    With the convergence of traditional RDBMS (introducing support for JSON documents) and NoSQL (i.e. DBRefs and $lookup for left-outer joins appeared in MongoDB with v3.2), mainstream CIOs may need some convincing that MongoDB can be accepted by enterprise architects and large teams of analysts and designers, as well as operations.  A MongoDB schema modeling tool contributes to such acceptance, in addition to being a best practice.

     

    But the traditional methods and tools of the old ‘relational’ world are no longer valid for NoSQL. 

     

     

    Hackolade was developed to be a cross-platform (Windows/Mac/Linux) NodeJS-based desktop Single Page Application (JavaScript/HTML 5/CSS) to help the design and documentation of physical models, leveraging the power of JSON and MongoDB.  It is targeted at analysts, solution designers, architects, developers, and database administrators.  

     

    The graphical interface lets the user visualize and maintain a diagram of the collections and their logical relationships, plus the details and constraints of individual attributes and objects within each collection.  The application is specifically designed around the powerful nature of nested sub-objects and denormalization.  The outputs of the model are:

    • a detailed documentation of the model in HTML and PDF formats;
    • scripts
      • MongoDB: validator script and Mongoose schema
      • DynamoDB: Create Table and Condition Expression scripts
      • Couchbase: Ottoman schema; 
      • Cassandra: CQL scripts for CREATE or ALTER TABLE;
      • Hive: HQL scripts;
      • Neo4j: Cypher script by example;
      • Avro: Avro schema;
      • Parquet: Parquet schema;
      • DW and RDBMS: DDL scripts;
      • etc...
    • sample JSON documents and JSON Schema compliant JSON models. 

     

    A powerful reverse-engineering feature lets the user create the basis for a model, from an existing database, then lets edit and enrich the physical model.

     

    Particular emphasis has been given to making the application intuitive and simple to use, yet powerful and rigorous.

     

    The business benefits are as follows:

    • increase projects legitimacy and credibility with mainstream CIOs, by showing that MongoDB applications can also be planned, designed, and fully thought-through, thereby reducing risks.
    • leverage the power of visual modeling: data structures and relationships don't have to be buried in application code.  They can also be available to the various teams for a 360° view of the system landscape, for better collaboration and smooth operations.
    • facilitate data governance by generating scripts to easily configure MongoDB 3.2’s validator