Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
To migrate Sybase Adaptive Server Enterprise (ASE) databases to SQL Server or SQL Azure, you first create an SSMA project. The project is a file that contains metadata about the ASE databases that you want to migrate to SQL Server or SQL Azure, metadata about the target instance of SQL Server or SQL Azure that will receive the migrated objects and data, SQL Server or SQL Azure connection information, and project settings.
When you open a project, it's disconnected from SQL Server or SQL Azure. This lets you work offline. You can reconnect to SQL Server or SQL Azure. For more information, see Connecting to SQL Server / Connecting to Azure SQL Database.
Review default project settings
SSMA contains several options for converting and loading database objects, migrating data, and synchronizing SSMA with ASE and SQL Server or SQL Azure. The default settings for these options are appropriate for many users. However, before you create a new SSMA project, you should review the options and, if you want to, change the defaults that will be used for all your new projects.
On the Tools menu, select Default Project Settings.
Select the project type in Migration Target Version dropdown list for which settings are required to be viewed or changed and then Select General tab.
In the left pane, select Conversion.
In the right pane, review the options, changing options as necessary. For more information about these options, see Project Settings (Conversion).
Repeat steps 1-3 for the Migration, SQL Azure, Loading Objects, GUI, and Type Mapping pages.
For information about migration options, see Project Settings (Migration).
For information about options for loading objects into SQL Server, see Project Settings (Synchronization).
For more information about GUI options, see Project Settings (GUI).
For more information about data type mapping settings, select Project Settings (Type Mapping).
For more information about SQL Azure options, see Project Settings (Azure SQL Database).
Note
The SQL Azure settings will be displayed only when you select Migration to SQL Azure while creating a project.
Create new projects
To migrate data from ASE databases to SQL Server or SQL Azure, you must first create a project.
On the File menu, select New Project.
The New Project dialog box appears.
In the Name box, enter a name for your project.
In the Location box, enter or select a folder for the project.
In the Migration To dropdown list, select the version of target SQL Server used for migration. The options available are:
- SQL Server 2016 (13.x)
- SQL Server 2017 (14.x)
- SQL Server 2019 (15.x)
- SQL Server 2022 (16.x)
- SQL Server 2025 (17.x)
- Azure SQL Database
- Azure SQL Managed Instance
And then select OK.
Customize project settings
In addition to defining default project settings that apply to all new SSMA projects, you can customize the settings for each project. For more information, see Setting Project Options.
When you customize data type mappings between source and target databases, you can define mappings at the project, database, or object level. For more information about type mapping, see Mapping Sybase ASE and SQL Server Data Types.
Save projects
When you save a project, SSMA retains the project settings, and optionally the database metadata, to the project file.
On the File menu, select Save Project.
If databases within the project have changed or haven't been converted, SSMA will prompt you to save metadata into the project. Saving metadata will let you work offline and to send a complete project file to other people, including technical support personnel. If you're prompted to save metadata, do the following:
For each database that shows a status of Metadata missing, select the check box next to the database name.
Saving metadata might take several minutes. If you don't want to save metadata at this point, don't select any check boxes.
Select the Save button.
SSMA will parse the Sybase ASE schemas and save the metadata to the project file.
Open projects
When you open a project, it's disconnected from ASE and from SQL Server or SQL Azure. This lets you work offline. To update metadata, load database objects into SQL Server or SQL Azure. To migrate data, you must reconnect to ASE and SQL Server or SQL Azure.
Use one of the following procedures:
On the File menu, point to Recent Projects, and then select the project you want to open.
On the File menu, select Open Project, locate the .s2ssproj project file, select the file, and then select Open.
To reconnect to ASE, on the File menu, select Reconnect to Sybase.
To reconnect to SQL Server or SQL Azure, on the File menu, select Reconnect to SQL Server / Reconnect to SQL Azure.