Experimental feature: reverse-engineering a database schema into a Cloudfier application

We just released a new version of Cloudfier which sports a long requested feature (in experimental status): reverse engineering a relational database schema as a Cloudfier application. It relies on offline database schema snapshots produced by the SchemaCrawler tool.

Steps

  1. Create a new folder (call it, say, ‘import-test’)
  2. Select the folder you just created, right click it, and choose Import > File or Zip Archive, then pick a database snapshot file created using SchemaCrawler in your computer (feel free to download this example snapshot). When asked whether the file should be unzipped, CHOOSE “NO”.
  3. Select the folder you just created, right click it, and choose Open Related > Shell
  4. type cloudfier init-project .
  5. type cloudfier app-deploy . so the contents of the project are published
  6. type cloudfier import-schema-crawler . offline.db_.zip to import the SchemaCrawler snapshot as TextUML model (provide the proper file name if your snapshot file has a different name)
  7. if you used the sample snapshot, delete the forlint.tuml file before you take the next step.
  8. type cloudfier full-deploy . to deploy the application.

all-steps-import-schema-crawler

Producing an offline database schema with SchemaCrawler

  1. Download and extract SchemaCrawler into your computer.
  2. Open a terminal or command prompt and cd into the _schemacrawer directory inside the location where you extracted SchemaCrawler.
  3. Run SchemaCrawler tool “serialize” command against your database, for instance (for a SQL Server database):
    ./schemacrawler.sh -command=serialize -server=sqlserver -infolevel=standard -password=DB_PASSWORD -user=DB_USER -database=DB_NAME -host=DB_HOST -o=my-offline-schema.zip  
    

More details on running SchemaCrawler here.

Controlling the schema import operation

There are a bunch of options that you can add to your mdd.properties file to customize the importing operation. Some of which are demonstrated in this test class.

Email this to someoneShare on FacebookShare on LinkedInShare on Google+Tweet about this on Twitter

3 thoughts on “Experimental feature: reverse-engineering a database schema into a Cloudfier application

  1. Sualeh Fatehi

    July 28, 2016 at 10:57pm

    Thank you for using SchemaCrawler creatively. Please make sure that the snapshots are made with the same version of SchemaCrawler as you use to produce the TUML files. Otherwise, Cloudifer may not be able to read the snapshot in order to create the TUML files.

    • Rafael Chaves

      July 28, 2016 at 11:06pm

      Thanks for making SchemaCrawler available, Sualeh. From what I could see, it looks solid! Before I knew about SchemaCrawler, I was considering using straight DatabaseMetadata, but SchemaCrawler’s API is so much nicer and easier to use.

      Is there any backward compatibility between snapshots across SchemaCrawler versions? Or is using the exact same version for creating and reading snapshots the only way to go?

  2. Sualeh Fatehi

    August 11, 2016 at 10:46pm

    Rafael, I am so glad you like it. Another way to go would be to serialize the catalog object in some abstract way, such as JSON. SchemaCrawler generates JSON natively. You would then have to write your own code to deserialize the JSON, and create TUML files.

Comments are closed.