Migrating data from InterSystems Cache to SQL Server

This guide walks you through migrating data from InterSystems Cache to SQL Server in a few simple steps using ESF Database Migration Toolkit. Simplify complex migration tasks and save valuable time with our streamlined approach.

InterSystems Cache vs. SQL Server:

InterSystems Cache is a high-performance object database management system and rapid application development environment designed for transactional applications. It offers a powerful database engine coupled with a robust set of development tools, making it suitable for building scalable, data-intensive applications in healthcare, finance, and other industries. Cache excels in handling complex data structures and large volumes of data while providing real-time analytics and seamless integration capabilities. Its advanced features include support for SQL, object-oriented programming, web services, and interoperability with various programming languages, making it a versatile solution for modern application development needs.
SQL Server is a robust relational database management system developed by Microsoft, designed for a wide range of data management applications. It supports a variety of transaction processing, business intelligence, and analytics applications in corporate IT environments. Known for its high performance, scalability, and security features, SQL Server offers comprehensive tools for database creation, management, and maintenance, making it a preferred choice for both small-scale applications and large enterprise systems. Its integration with other Microsoft products and services further enhances its versatility and ease of use.

Prerequisite:

Software Required:

DMToolkit_x64.zip (63.6 MiB)	64-bit Windows application for ESF Database Migration Toolkit 12.2.08 (2025-07-11). (md5: e93a0ef57622bfd8ee77d6aa6e38c13b)
DMToolkit_win32.zip (58.8 MiB)	32-bit Windows application for ESF Database Migration Toolkit 12.2.08 (2025-07-11). (md5: bd34cb7f73c88c6d0c7a44069ad756d6)

System Supported:
- Windows 7 or higher.
- InterSystems Cache 2015.1 or higher.
- SQL Server 6.5 or higher.

Step by Step Wizard:

Connect to InterSystems Cache
- In the "Choose a Data Source" dialog:
  - Select "InterSystems Cache"
- Enter connection parameters:
  - Server name: localhost (default)
  - Port number: 1972 (default)
- Provide authentication:
  - Username: _system (default)
  - Password associated with the account
- Load database options:
  - Click the Refresh Database button
  - Select target database from the list
- Load schema options:
  - Click the Refresh Schema button
  - Choose desired schema
Fig. 1: InterSystems Cache data source configuration
Configure Microsoft SQL Server Destination
- In the "Choose a Destination" dialog:
  - Select "Microsoft SQL Server"
- Server connection details:
  - Enter SQL Server host name (optionally with instance name), e.g., localhost\sqlexpress
  - For TCP/IP connections:
    - Specify server port (default: 0 uses named pipes)
    - Provide username (e.g., sa) and password
  - For Windows Authentication:
    - Check the Windows Authentication checkbox
- Database configuration:
  - Click the Refresh button to list existing databases
  - Select existing database or enter new database name
  - Note: Non-existing databases will be automatically created during migration
- Schema configuration:
  - Click the refresh button to list existing schemas
  - Select existing schema or enter new schema name
  - Default schema: dbo (if left blank)
  - Note: Non-existing schemas will be automatically created during migration
Fig. 2: Microsoft SQL Server destination configuration
In "Select Source Table(s) & View(s)" Dialog
- Select migration objects: Choose tables or views to include in the migration.
  
  Fig. 3: Select tables and views
- Modify table structure: Click the ellipsis (...) button to access table options and schema adjustments.
  
  Fig. 4: Do transform
- Configure field mapping: In the Field Mapping options:
  - Customize destination fields (name, data type, default value, comments)
  - Select data transfer method:
    - Overwrite Table (replace existing data)
    - Empty Data (truncate before insert)
    - Append Data (add to existing data)
    - Skip Table (exclude from transfer)
  - Apply data filters before transfer
Execution Dialog
- Start migration: Click "Submit" to initiate automated data transfer from InterSystems Cache to SQL Server.
  
  Fig. 5: Execute migration
- Monitor progress: Click "Browse Log" for real-time migration tracking, including issue resolution details.
- Save configuration: Click "Save as job" to store settings for:
  - Quick reloads of migration jobs
  - Command-line execution (use: dmtc.exe --help for parameter options)
Finished!

After migration completes, the toolkit generates a comprehensive report for verifying migration accuracy. You can monitor progress as the automated process runs efficiently. For any questions or feedback, contact us – our team is ready to assist.