Discover and import databases

This page describes how to use the database collection scripts to discover, collect, and upload your database data to Migration Center. Migration Center uses open-source collection scripts available on GitHub to collect data. To understand the type of data that Migration Center collects, you can review the code of the collection scripts.

Before you begin

  • The database collection scripts support the following databases and database versions:
    • Microsoft SQL Server for Windows Versions 2008R2 (SP2) to SQL Server 2022
    • MySQL version 8
    • PostgreSQL versions 14 and 15.

Download and run the scripts

To discover and collect data from your databases, follow these steps:

  1. Download the latest version of the collection scripts for the database type that you want to discover:

  2. Extract the files, then in the scripts/collector folder, open the folder for your database.

  3. Follow the instructions in the README file to run the script. When it finishes running, the script creates a ZIP file with the collected data in the output folder that you select.

Upload the collected data to Migration Center

The ZIP files created by the collection scripts contain all the specifications and performance data collected from your database.

To upload the ZIP files to Migration Center, follow these steps:

  1. Go to the Data import page.
  2. Click Add data > Upload files.
  3. In the Set up file upload section, enter the name of the file upload.
  4. From the File format list, select Database import file.
  5. Click Select files to upload, then select all the files that you want to upload.
  6. To upload the files, click Upload files.
  7. If the files are validated correctly, to create the assets from the files, click Import data, then click Confirm.

Review the upload

After you upload your files, Migration Center validates them to check if they are formally correct. If the validation is successful, Migration Center then processes the data to create new assets, or update existing ones. You can check the status of your upload jobs from the Google Cloud console.

To review the status of your upload job, follow these steps:

  1. Go to the Data import page, then click File uploads.
  2. From the list of file imports, select the upload you want to review.
  3. On the file upload page, under Data import progress, review the Status for your uploaded files.

You can see your files in one of the following statuses.

List of statuses

  • Completed. The import of your file was successful.
  • Ready. Your file passed validation, and is ready to be imported.
  • Pending. Your file is waiting for another file to finish processing.
  • Running. Your file is processing.
  • Validating. Your file is in the validation stage.
  • Failed validation. Your file contains some errors. Fix the errors then try to upload your file again.
  • Failed. Your file couldn't be imported.

Review error details

If you encounter errors after importing your files, you can review the error message directly in the Google Cloud console.

To review the errors of your upload job, follow these steps:

  1. Go to the Data import page, then click File uploads.
  2. Click the import file that shows a warning or error. The import file details page shows the complete list of errors.

On the import file details page, you can review the assets and data fields that cause the errors, and view a description of the error. Errors in the file import job might prevent Migration Center from creating new assets or update existing ones with the new changes. To fix the error, edit your files and create a new file import job to upload them again.

For more information about the possible error messages, see Troubleshoot file import errors.

What's next