Connecting to DB2 database (DB2ToSQL)

To migrate DB2 databases to SQL Server, you must connect to the DB2 database that you want to migrate. When you connect, SSMA obtains metadata about all DB2 schemas, and then displays it in the DB2 Metadata Explorer pane. SSMA stores information about the database server, but doesn't store passwords.

Your connection to the database stays active until you close the project. When you reopen the project, you must reconnect if you want an active connection to the database.

Metadata about the DB2 database isn't automatically updated. Instead, if you want to update the metadata in DB2 Metadata Explorer, you must manually update it. For more information, see the Refresh DB2 metadata section in this article.

Required DB2 permissions

User authorization defines the list of the commands and objects that are available for a user. This list thereby controls user actions. In DB2, there are predetermined groups of privileges for authorization, both at the instance level and at the level of a DB2 database. This enables SSMA to obtain metadata from schemas owned by the connecting user. To obtain metadata for objects in other schemas and then convert objects in those schemas, the account must have the following permissions:

  • Schema Access for schema migration is normally granted to PUBLIC unless the RESTRICT keyword was used in CREATE
  • Data access for data migration requires DATAACCESS

Establish a connection to DB2

When you connect to a database, SSMA reads the database metadata, and then adds this metadata to the project file. This metadata is used by SSMA when it converts objects to SQL Server syntax, and when it migrates data to SQL Server. You can browse this metadata in the DB2 Metadata Explorer pane and review properties of individual database objects.


Before you try to connect, make sure that the database server is running and can accept connections.

Connect to DB2

  1. On the File menu, select Connect to DB2.

    If you previously connected to DB2, the command name is Reconnect to DB2.

  2. In the Provider box, you see the OLE DB Provider which is currently the only DB2 client access provider.

  3. In the Manager box you can select either DB2 for zOS, DB2 for LUW or DB2 for i

  4. In the Mode box, select either Standard mode, or Connection string mode.

    Use standard mode to specify the server name and port. Use service name mode to specify the DB2 service name manually. Use connection string mode to provide a full connection string.

  5. If you select Standard mode, provide the following values:

    • In the Server name box, enter or select the name or IP address of the database server.
    • If the database server isn't configured to accept connections on the default port (1521), enter the port number that is used for DB2 connections in the Server port box.
    • In the Server Port box, enter the TCP/IP Port number.
    • In the Initial Catalog box, enter the database name.
    • In the User name box, enter a DB2 account that has the necessary permissions.
    • In the Password box, enter the password for the specified user name.
  6. If you select Connection string mode, provide a connection string in the Connection string box.

    The following example shows an OLE DB connection string:

    Provider=OraOLEDB.DB2;Data Source=MyDB2DB;User Id=myUsername;Password=myPassword;

    The following example shows a DB2 Client connection string that uses integrated security:

    Data Source=MyDB2DB;Integrated Security=yes;

    For more information, see Connect To Oracle (OracleToSQL).

Reconnect to DB2

Your connection to the database server stays active until you close the project. When you reopen the project, you must reconnect if you want an active connection to the database. You can work offline until you want to update metadata, load database objects into SQL Server, and migrate data.

Refresh DB2 metadata

Metadata about the DB2 database isn't automatically refreshed. The metadata in DB2 Metadata Explorer is a snapshot of the metadata when you first connected, or the last time that you manually refreshed metadata. You can manually update metadata for all schemas, a single schema, or individual database objects.

Refresh metadata

  1. Make sure that you are connected to the database.

  2. In DB2 Metadata Explorer, select the check box next to each schema or database object that you want to update.

  3. Right-click Schemas, or the individual schema or database object, and then select Refresh from Database.

    If you don't have an active connection, SSMA displays the Connect to DB2 dialog box so that you can connect.

  4. In the Refresh from Database dialog box, specify which objects to refresh.

    • To refresh an object, select the Active field next to the object until an arrow appears.

    • To prevent an object from being refreshed, select the Active field next to the object until an X appears.

    • To refresh or decline a category of objects, select the Active field next to the category folder.

      To view the definitions of the color coding, select the Legend button.

  5. Select OK.

See also

Next steps