Azure DocumentDB Data Migration Tool
Перейти к файлу
John Bowen d2ba7b9b4e Adding URI support to JSON source 2022-11-01 12:16:28 -07:00
.github/workflows Update dotnet-build-test.yml to 'main' branch after merge 2022-10-05 14:57:56 -04:00
Core Adding URI support to JSON source 2022-11-01 12:16:28 -07:00
Extensions Adding URI support to JSON source 2022-11-01 12:16:28 -07:00
Interfaces/Microsoft.DataTransfer.Interfaces Adding logging support in place of console output 2022-10-27 10:20:53 -07:00
docs removed the simple-json file from the sample data 2022-10-04 13:29:00 -04:00
media adding initial overview 2022-06-10 08:37:43 -04:00
.gitattributes Froze the stable version of the original tool 2022-05-17 11:00:04 -04:00
.gitignore Feature/json extension (#178) 2022-08-30 13:19:54 -04:00
Contributing.md Froze the stable version of the original tool 2022-05-17 11:00:04 -04:00
CosmosDbDataMigrationTool.sln SQL Source and Sink extension (#191) 2022-10-05 15:22:44 -04:00
EULA.RTF Froze the stable version of the original tool 2022-05-17 11:00:04 -04:00
LICENSE.txt Froze the stable version of the original tool 2022-05-17 11:00:04 -04:00
README.md Removed unnecessary usings, added default section name to extension configuration documentation, completed initial tutorial of JSON to Cosmos DB usage. 2022-09-24 12:44:30 -04:00
SECURITY.md Microsoft mandatory file (#189) 2022-10-06 08:58:50 -04:00
THIRDPARTYNOTICES.RTF Froze the stable version of the original tool 2022-05-17 11:00:04 -04:00

README.md

Azure Cosmos DB data migration tool

PLEASE NOTE

The Azure Cosmos DB data migration tool is undergoing a full refactor to restructure the project to accomplish the following:

  • Provide a base cross-platform CLI that is lightweight and serves as the base (core) executable for hosting extensions
  • The extensible framework enables the community to add source and destination targets without modifying the core executable
  • Improve stability
  • Use the latest stable .NET release (currently .NET 6)
  • Use the latest Azure Cosmos DB SDKs

To access the archived version of the tool, navigate to the Archive branch.


Cosmos DB data migration tool architecture

The Cosmos DB Data Migration Tool is a lightweight executable that leverages the Managed Extensibility Framework (MEF). MEF enables decoupled implementation of the core project and its extensions. The core application is a command-line executable responsible for composing the required extensions at runtime by automatically loading them from the Extensions folder of the application. An Extension is a class library that includes the implementation of a System as a Source and (optionally) Sink for data transfer. The core application project does not contain direct references to any extension implementation. Instead, these projects share a common interface.

An extensions folder holds multiple extensions implementations.The application loads extensions from the extensions folder and executes functionality based on an interface implementation.

Cosmos DB project structure

The Cosmos DB Data Migration Tool core project is a C# command-line executable. The core application serves as the composition container for the required Source and Sink extensions. Therefore, the application user needs to put only the desired Extension class library assembly into the Extensions folder before running the application. In addition, the core project has a unit test project to exercise the application's behavior, whereas extension projects contain concrete integration tests that rely on external systems.

The project consists of a core application executable project as well as a shared interface project. Each extension will consist of an extension project plus integration test project. A core unit test project exercises the core application functionality.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Documentation

Initial usage documentation.