Babelfish Compass Tool - How to use

03 August,2022 by Rambler

The Babelfish Compass Tool is an assessment tool for compatibility between SQL Server & Babelfish.    


The following is an outline of the migration process with Babelfish:

1) Generate the DDL from the source database. More details below 
2) Execute  the Babelfish Compass tool to assess  whether the application contains any SQL features not currently supported by Babelfish.
3) Review the Babelfish Compass assessment report and refactor or remove any unsupported SQL features. This step is probably the most complicated and could require multiple steps.

To progress with migrating to Babelfish you'll need to have an account and move through these stsps

4) Create the Babelfish cluster. Read more on Single-Mode Vs Multiple-Mode in Babelfish for Aurora PotgreSQL - which one should you use
5) Connect to the Babelfish database.  It's possible you've been utilising Active Directory for SQL Server connectivity , one of the review questions relates to whether you'll need Kerberos 
6) Execute the updated DDL against the Babelfish database.
7) Test and iterate until the migrated application’s functionality is correct.


To get the DDL from the SQL Server 

  1. Open SSMS and connect to your SQL Server instance as sa.
  2. Right-click the source database |  Tasks | Generate Scripts.
  3. Choose Next.
  4. Choose Select specific database objects and select all options  except Users.
  5. Choose Advanced. A new options window will appear
  6. Search and modify the following options

      Types of data to script – Choose Schema only
      Script Extended Properties – Choose False
      Script Owner – Choose True
      Script Object-Level-Permissions – Choose True
      Script Logins – Choose True
      Script Triggers  – Choose True
      Script Indexes – Choose True



To generate the report 

BabelfishCompass.bat MyReportName C:/temp/mysqlDDL.sql


You'll notice in this report some text such as the following. This guides you to a different combination of the command line, which will : 

To generate this section, specify these options with -reportoption:
     'xref'  or  'xref=feature'

 Use the xref option 

BabelfishCompass.bat PI_LicenseTracking_PROD -reportoption xref


Some general guidelines for reading the report 

1)The assessment summary shows the list of objects analyzed, including supported and unsupported features.

2) In the SQL Features section  of the report, you can  see the SQL features report starting from unsupported features.

You can review these using the cross-reference report which links to the exact location of each non-supported feature.

You can click on the line number, which takes you to the SQL for this unsupported feature, so you can review the details



More reading

Spotlight on Babelfish for Aurora PostgreSQL

Babelfish for Aurora PostgreSQL query cheatsheet

Download Babelfish Compass Tool 

64-bit Java/JRE not found. Please install 64-bit JRE 8 or later

If you get this error download and install the 64-bit JRE 8 . Confirm via   running the command  : java -version

Author: Rambler (


Verify your Comment

Previewing your Comment

This is only a preview. Your comment has not yet been posted.

Your comment could not be posted. Error type:
Your comment has been posted. Post another comment

The letters and numbers you entered did not match the image. Please try again.

As a final step before posting your comment, enter the letters and numbers you see in the image below. This prevents automated programs from posting comments.

Having trouble reading this image? View an alternate.


Post a comment on Babelfish Compass Tool - How to use