Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve como usar os scripts de coleta de banco de dados para descobrir,
coletar e fazer upload dos dados do seu banco de dados para o Migration Center.
O Migration Center usa
scripts de coleta de código aberto disponíveis no GitHub
para coletar dados. Para entender o tipo de dados que o Migration Center
coleciona, analise o código dos scripts de coleta.
Antes de começar
Os scripts de coleta de banco de dados são compatíveis com os seguintes bancos de dados e
versões:
Microsoft SQL Server para Windows, versões 2008R2 (SP2) a SQL
Server 2022
MySQL versão 8
Versões 14 e 15 do PostgreSQL.
Fazer o download e executar os scripts
Para descobrir e coletar dados dos seus bancos de dados, siga estas etapas:
Faça o download da versão mais recente dos scripts de coleta para o tipo de banco de dados que você quer descobrir:
Extraia os arquivos e, na pasta scripts/collector, abra a
pasta do banco de dados.
Siga as instruções no arquivo README para executar o script. Quando a execução for concluída, o script vai criar um arquivo ZIP com os dados coletados na pasta de saída selecionada.
Fazer upload dos dados coletados para o Migration Center
Os arquivos ZIP criados pelos scripts de coleta contêm todas as especificações
e dados de performance coletados do seu banco de dados.
Permissões exigidas para a tarefa
Para executar esta tarefa, é necessário ter as seguintes
permissões:
rma.collectors.create no projeto
migrationcenter.sources.create no projeto
migrationcenter.importJobs.create no projeto
Para fazer upload dos arquivos ZIP na Central de migração, siga estas etapas:
Acesse a página Importação de dados.
Clique em Adicionar dados > Fazer upload de arquivos.
Na seção Configurar o upload de arquivos, insira o nome do upload de arquivos.
Na lista Formato do arquivo, selecione Arquivo de importação do banco de dados.
Clique em Selecionar arquivos para fazer upload e selecione todos os arquivos que você
quer enviar.
Para fazer upload dos arquivos, clique em Fazer upload de arquivos.
Se os arquivos forem validados corretamente, para criar os recursos com base neles, clique em Importar dados e em Confirmar.
Analisar o upload
Depois de fazer upload dos arquivos, a Central de migração os valida
para verificar se eles estão formalmente corretos. Se a validação for bem-sucedida,
o Migration Center processará os dados para criar novos recursos
ou atualizar os existentes. É possível verificar o status dos jobs de upload
no console Google Cloud .
Para analisar o status do job de envio, siga estas etapas:
Acesse a página Importação de dados e clique em Envios de arquivos.
Na lista de importações de arquivos, selecione o upload que você quer revisar.
Na página de envio de arquivos, em Progresso da importação de dados,
confira o Status dos arquivos enviados.
Seus arquivos podem estar em um dos seguintes status.
Lista de status
Concluído. A importação do arquivo foi concluída.
Pronto. Seu arquivo passou na validação e está pronto para ser importado.
Pendente. Seu arquivo está aguardando outro arquivo terminar o processamento.
Em execução. Seu arquivo está sendo processado.
Validação. Seu arquivo está na fase de validação.
Falha na validação. Seu arquivo contém alguns erros. Corrija os erros e tente fazer o upload do arquivo novamente.
Falhou. Não foi possível importar seu arquivo.
Analisar detalhes do erro
Se você encontrar erros após a importação dos arquivos, analise
a mensagem de erro diretamente no Google Cloud console.
Para analisar os erros do seu job de upload, siga estas etapas:
Acesse a página Importação de dados e clique em Envios de arquivos.
Clique no arquivo de importação que mostra um aviso ou erro.
A página de detalhes do arquivo de importação mostra a lista completa de erros.
Na página de detalhes do arquivo de importação, é possível analisar os recursos e campos de dados
que causam os erros e conferir uma descrição deles.
Erros no job de importação de arquivos podem impedir que o Migration Center
crie novos recursos ou atualize os existentes com as novas mudanças.
Para corrigir o erro, edite seus arquivos e crie um novo job de importação de arquivos para fazer o upload
deles de novo.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[],[],null,["# Discover and import databases\n\nThis page describes how to use the database collection scripts to discover,\ncollect, and upload your database data to Migration Center.\nMigration Center uses\n[open-source collection scripts available on GitHub](https://github.com/GoogleCloudPlatform/database-assessment)\nto collect data. To understand the type of data that Migration Center\ncollects, you can review the code of the collection scripts.\n\nBefore you begin\n----------------\n\n- The database collection scripts support the following databases and database versions:\n - Microsoft SQL Server for Windows Versions 2008R2 (SP2) to SQL Server 2022\n - MySQL version 8\n - PostgreSQL versions 14 and 15.\n\nDownload and run the scripts\n----------------------------\n\nTo discover and collect data from your databases, follow these steps:\n\n1. Download the latest version of the collection scripts for the database\n type that you want to discover:\n\n - [Download scripts for Microsoft SQL Server](https://github.com/GoogleCloudPlatform/database-assessment/releases/latest/download/db-migration-assessment-collection-scripts-sqlserver.zip).\n - [Download scripts for PostgreSQL](https://github.com/GoogleCloudPlatform/database-assessment/releases/latest/download/db-migration-assessment-collection-scripts-postgres.zip).\n - [Download scripts for MySQL](https://github.com/GoogleCloudPlatform/database-assessment/releases/latest/download/db-migration-assessment-collection-scripts-mysql.zip).\n2. Extract the files, then in the `scripts/collector` folder, open the\n folder for your database.\n\n3. Follow the instructions in the README file to run the script. When it\n finishes running, the script creates a ZIP file with the collected data\n in the output folder that you select.\n\nUpload the collected data to Migration Center\n---------------------------------------------\n\nThe ZIP files created by the collection scripts contain all the specifications\nand performance data collected from your database.\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `rma.collectors.create` on the project\n- `migrationcenter.sources.create` on the project\n- `migrationcenter.importJobs.create` on the project\n\n\u003cbr /\u003e\n\nTo upload the ZIP files to Migration Center, follow these steps:\n\n1. Go to the **Data import** page.\n2. Click **Add data \\\u003e Upload files**.\n3. In the **Set up file upload** section, enter the name of the file upload.\n4. From the **File format** list, select **Database import file**.\n5. Click **Select files to upload**, then select all the files that you want to upload.\n6. To upload the files, click **Upload files**.\n7. If the files are validated correctly, to create the assets from the files, click **Import data** , then click **Confirm**.\n\nReview the upload\n-----------------\n\nAfter you upload your files, Migration Center validates them\nto check if they are formally correct. If the validation is successful,\nMigration Center then processes the data to create new assets,\nor update existing ones. You can check the status of your upload jobs\nfrom the Google Cloud console.\n\nTo review the status of your upload job, follow these steps:\n\n1. Go to the **Data import** page, then click **File uploads**.\n2. From the list of file imports, select the upload you want to review.\n3. On the file upload page, under **Data import progress** , review the **Status** for your uploaded files.\n\nYou can see your files in one of the following statuses.\n\n### List of statuses\n\n- **Completed**. The import of your file was successful.\n- **Ready**. Your file passed validation, and is ready to be imported.\n- **Pending**. Your file is waiting for another file to finish processing.\n- **Running**. Your file is processing.\n- **Validating**. Your file is in the validation stage.\n- **Failed validation**. Your file contains some errors. Fix the errors then try to upload your file again.\n- **Failed**. Your file couldn't be imported.\n\n### Review error details\n\nIf you encounter errors after importing your files, you can review\nthe error message directly in the Google Cloud console.\n\nTo review the errors of your upload job, follow these steps:\n\n1. Go to the **Data import** page, then click **File uploads**.\n2. Click the import file that shows a warning or error. The import file details page shows the complete list of errors.\n\nOn the import file details page, you can review the assets and data fields\nthat cause the errors, and view a description of the error.\nErrors in the file import job might prevent Migration Center from\ncreating new assets or update existing ones with the new changes.\nTo fix the error, edit your files and create a new file import job to upload\nthem again.\n\nFor more information about the possible error messages, see\n[Troubleshoot file import errors](/migration-center/docs/troubleshooting/file-import-errors).\n\nWhat's next\n-----------\n\n- Learn more about [Migration Center collection methods](/migration-center/docs/start-asset-discovery#collection_methods).\n- Learn how to [manage your file uploads](/migration-center/docs/manage-file-uploads)."]]
