Tasks - Get
Get task information
The tasks resource is a nested, proxy-only resource representing work performed by a DMS (classic) instance. The GET method retrieves information about a task.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}/projects/{projectName}/tasks/{taskName}?api-version=2022-03-30-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}/projects/{projectName}/tasks/{taskName}?$expand={$expand}&api-version=2022-03-30-preview
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
group
|
path | True |
string |
Name of the resource group |
project
|
path | True |
string |
Name of the project |
service
|
path | True |
string |
Name of the service |
subscription
|
path | True |
string |
Subscription ID that identifies an Azure subscription. |
task
|
path | True |
string |
Name of the Task |
api-version
|
query | True |
string |
Version of the API |
$expand
|
query |
string |
Expand the response |
Responses
Name | Type | Description |
---|---|---|
200 OK |
A task resource |
|
Other Status Codes |
Error |
Security
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
Tasks_Get
Sample request
Sample response
{
"properties": {
"input": {
"targetConnectionInfo": {
"type": "SqlConnectionInfo",
"dataSource": "ssma-test-server.database.windows.net",
"authentication": "SqlAuthentication",
"encryptConnection": true,
"trustServerCertificate": true,
"userName": "testuser"
}
},
"taskType": "ConnectToTarget.SqlDb",
"state": "Queued"
},
"etag": "0vPYxzfnDaDH9yhOJAnqTyTRpa09Kb7pm+LEukDBbw8=",
"id": "/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject/tasks/DmsSdkTask",
"name": "DmsSdkTask",
"type": "Microsoft.DataMigration/services/projects/tasks"
}
Definitions
Name | Description |
---|---|
Api |
Error information. |
Authentication |
An enumeration of possible authentication types when connecting |
Azure |
Azure Active Directory Application |
Backup |
Information of the backup file |
Backup |
An enumeration of Status of the log backup file. |
Backup |
An enumeration of backup modes |
Backup |
Information of backup set |
Backup |
Enum of the different backup types. |
Blob |
Blob container storage information. |
Command |
The state of the command. This is ignored if submitted. |
Connect |
Properties for the task that validates the connection to and provides information about a MongoDB server |
Connect |
Input for the task that validates MySQL database connection |
Connect |
Properties for the task that validates MySQL database connection |
Connect |
Output for connect to MySQL type source |
Connect |
Input for the task that validates Oracle database connection |
Connect |
Output for the task that validates Oracle database connection |
Connect |
Properties for the task that validates Oracle database connection |
Connect |
Input for the task that validates connection to PostgreSQL and source server requirements |
Connect |
Output for the task that validates connection to PostgreSQL and source server requirements |
Connect |
Properties for the task that validates connection to PostgreSQL server and source server requirements for online migration |
Connect |
Properties for the task that validates connection to SQL Server and source server requirements for online migration |
Connect |
Input for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Agent Job level output for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Database level output for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Login level output for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Task level output for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Properties for the task that validates connection to SQL Server and also validates source server requirements |
Connect |
Input for the task that validates connection to Azure Database for MySQL and target server requirements |
Connect |
Output for the task that validates connection to Azure Database for MySQL and target server requirements |
Connect |
Properties for the task that validates connection to Azure Database for MySQL and target server requirements |
Connect |
Input for the task that validates connection to Azure Database for PostgreSQL and target server requirements |
Connect |
Output for the task that validates connection to Azure Database for PostgreSQL and target server requirements |
Connect |
Properties for the task that validates connection to Azure Database For PostgreSQL server and target server requirements for online migration |
Connect |
Input for the task that validates connection to Azure Database for PostgreSQL and target server requirements for Oracle source. |
Connect |
Output for the task that validates connection to Azure Database for PostgreSQL and target server requirements for Oracle source. |
Connect |
Properties for the task that validates connection to Azure Database For PostgreSQL server and target server requirements for online migration for Oracle source. |
Connect |
Input for the task that validates connection to SQL DB and target server requirements |
Connect |
Output for the task that validates connection to SQL DB and target server requirements |
Connect |
Properties for the task that validates connection to SQL DB and target server requirements |
Connect |
Input for the task that validates connection to Azure SQL Database Managed Instance online scenario. |
Connect |
Output for the task that validates connection to Azure SQL Database Managed Instance. |
Connect |
Properties for the task that validates connection to Azure SQL Database Managed Instance |
Connect |
Input for the task that validates connection to Azure SQL Database Managed Instance. |
Connect |
Output for the task that validates connection to Azure SQL Database Managed Instance. |
Connect |
Properties for the task that validates connection to Azure SQL Database Managed Instance |
Connect |
Input for the task that validates connection to Azure SQL DB and target server requirements |
Connect |
Properties for the task that validates connection to SQL DB and target server requirements for online migration |
created |
|
Database |
Information about backup files when existing backup mode is used. |
Database |
An enumeration of SQL Server database compatibility levels |
Database |
Database file specific information |
Database |
An enumeration of SQL Server database file types |
Database |
Current stage of migration |
Database |
Database level migration state. |
Database |
Mapping of schemas per database |
Database |
An enumeration of SQL Server Database states |
Database |
Summary of database results in the migration |
Database |
Table properties |
Data |
Results for checksum based Data Integrity validation results |
Data |
Basic summary of a data item migration |
Execution |
Description about the errors happen while performing migration validation |
File |
File share information with Path, Username, and Password. |
Get |
Input for the task that gets TDE certificates in Base64 encoded format. |
Get |
Output of the task that gets TDE certificates in Base64 encoded format. |
Get |
Properties for the task that gets TDE certificates in Base64 encoded format. |
Get |
Input for the task that collects user tables for the given list of databases |
Get |
Output of the task that collects user tables for the given list of databases |
Get |
Properties for the task that collects user tables for the given list of databases |
Get |
Input for the task that gets the list of tables contained within a provided list of Oracle schemas. |
Get |
Output for the task that gets the list of tables contained within a provided list of Oracle schemas. |
Get |
Properties for the task that collects user tables for the given list of Oracle schemas |
Get |
Input for the task that gets the list of tables for a provided list of PostgreSQL databases. |
Get |
Output for the task that gets the list of tables for a provided list of PostgreSQL databases. |
Get |
Properties for the task that collects user tables for the given list of databases |
Get |
Input for the task that collects user tables for the given list of databases |
Get |
Output of the task that collects user tables for the given list of databases |
Get |
Properties for the task that collects user tables for the given list of databases |
Get |
Input for the task that collects user tables for the given list of databases |
Get |
Output of the task that collects user tables for the given list of databases |
Get |
Properties for the task that collects user tables for the given list of databases |
Login |
Enum of the different stage of login migration. |
Login |
Enum mapping of SMO LoginType. |
Migrate |
Input for command that completes online migration for an Azure SQL Database Managed Instance. |
Migrate |
Output for command that completes online migration for an Azure SQL Database Managed Instance. |
Migrate |
Properties for the command that completes online migration for an Azure SQL Database Managed Instance. |
Migrate |
Properties for the task that migrates data between MongoDB data sources |
Migrate |
Database specific information for offline MySQL to Azure Database for MySQL migration task inputs |
Migrate |
Input for the task that migrates MySQL databases to Azure Database for MySQL for offline migrations |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for the task that migrates MySQL databases to Azure Database for MySQL for offline migrations |
Migrate |
Database specific information for MySQL to Azure Database for MySQL migration task inputs |
Migrate |
Input for the task that migrates MySQL databases to Azure Database for MySQL for online migrations |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for the task that migrates MySQL databases to Azure Database for MySQL for online migrations |
Migrate |
Properties for the task that migrates Oracle to Azure Database for PostgreSQL for online migrations |
Migrate |
Database specific information for Oracle to Azure Database for PostgreSQL migration task inputs |
Migrate |
Input for the task that migrates Oracle databases to Azure Database for PostgreSQL for online migrations |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Database specific information for PostgreSQL to Azure Database for PostgreSQL migration task inputs |
Migrate |
Selected tables for the migration |
Migrate |
Input for the task that migrates PostgreSQL databases to Azure Database for PostgreSQL for online migrations |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for the task that migrates PostgreSQL databases to Azure Database for PostgreSQL for online migrations |
Migrate |
Database specific information for SQL to Azure SQL DB migration task inputs |
Migrate |
Database specific information for SQL to Azure SQL DB sync migration task inputs |
Migrate |
Input for the task that migrates on-prem SQL Server databases to Azure SQL Database for online migrations |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for the task that migrates on-prem SQL Server databases to Azure SQL Database for online migrations |
Migrate |
Input for the task that migrates on-prem SQL Server databases to Azure SQL Database |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for the task that migrates on-prem SQL Server databases to Azure SQL Database |
Migrate |
Database specific information for SQL to Azure SQL DB Managed Instance migration task inputs |
Migrate |
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance online scenario. |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for task that migrates SQL Server databases to Azure SQL Database Managed Instance sync scenario |
Migrate |
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance. |
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
|
Migrate |
Properties for task that migrates SQL Server databases to Azure SQL Database Managed Instance |
Migrate |
Input for task that migrates SSIS packages from SQL Server to Azure SQL Database Managed Instance. |
Migrate |
|
Migrate |
|
Migrate |
Properties for task that migrates SSIS packages from SQL Server databases to Azure SQL Database Managed Instance. |
Migrate |
Input for command that completes sync migration for a database. |
Migrate |
Output for command that completes sync migration for a database. |
Migrate |
Properties for the command that completes sync migration for a database. |
Migration |
Information about migration eligibility of a server object |
Migration |
Migration validation report result, contains the url for downloading the generated report. |
Migration |
Current state of migration |
Migration |
Current status of migration |
Migration |
Migration Validation Database level summary result |
Migration |
Types of validations to run after the migration |
Migration |
Migration Validation Result |
Mi |
Properties required to create a connection to Azure SQL database Managed instance |
Mongo |
Describes a MongoDB data source |
Mongo |
The type of data source |
Mongo |
Describes a supported collection within a MongoDB database |
Mongo |
Describes the progress of a collection |
Mongo |
Describes how an individual MongoDB collection should be migrated |
Mongo |
Describes a connection to a MongoDB data source |
Mongo |
Describes a database within a MongoDB data source |
Mongo |
Describes the progress of a database |
Mongo |
Describes how an individual MongoDB database should be migrated |
Mongo |
Describes an error or warning that occurred during a MongoDB migration |
Mongo |
The type of error or warning |
Mongo |
Describes the progress of the overall migration |
Mongo |
Describes how a MongoDB data migration should be performed |
Mongo |
|
Mongo |
Describes how changes will be replicated from the source to the target. The default is OneTime. |
Mongo |
Describes a field reference within a MongoDB shard key |
Mongo |
Describes a MongoDB shard key |
Mongo |
The field ordering |
Mongo |
Describes a MongoDB shard key |
Mongo |
Specifies resource limits for the migration |
My |
Information for connecting to MySQL server |
My |
Target Platform for the migration |
Object |
Type of the object that has the difference. e.g (Table/View/StoredProcedure) |
OData |
Error information in OData format. |
Oracle |
Information for connecting to Oracle server |
Orphaned |
Information of orphaned users on the SQL server database. |
Postgre |
Information for connecting to PostgreSQL server |
Project |
A task resource |
Query |
Results for query analysis comparison between the source and target |
Query |
Describes query analysis results for execution in source and target |
Replicate |
Wrapper for replicate reported migration states. |
Reportable |
Exception object for all custom exceptions |
Scenario |
An enumeration of source type |
Scenario |
An enumeration of target type |
Schema |
Results for schema comparison between the source and target |
Schema |
Description about the errors happen while performing migration validation |
Selected |
Info for certificate to be exported for TDE enabled databases. |
Server |
Permission group for validations. These groups will run a set of permissions for validating user activity. Select the permission group for the activity that you are performing. |
Server |
Server properties for MySQL type source |
Severity |
Severity of the validation error |
Sql |
Information for connecting to SQL database server |
Sql |
Server platform type for connection |
Ssis |
SSIS migration info with SSIS store type, overwrite policy. |
Ssis |
The overwrite option for SSIS object migration, only ignore and overwrite are supported in DMS (classic) now and future may add Reuse option for container object |
Ssis |
Current stage of SSIS migration |
Ssis |
An enumeration of supported source SSIS store type in DMS (classic) |
Start |
Server role migration result |
Sync |
Enum of the different state of database level online migration. |
Sync |
Database migration errors for online migration |
Sync |
Enum of the different state of table level online migration. |
System |
|
Task |
The state of the task. This is ignored if submitted. |
Update |
Type of the actual difference for the compared object, while performing schema comparison |
Validate |
Properties for task that validates migration input for SQL to Azure SQL DB sync migrations |
Validate |
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance online scenario. |
Validate |
Output for task that validates migration input for Azure SQL Database Managed Instance online migration |
Validate |
Properties for task that validates migration input for SQL to Azure SQL Database Managed Instance sync scenario |
Validate |
Input for task that validates migration input for SQL to Azure SQL Managed Instance |
Validate |
Output for task that validates migration input for SQL to Azure SQL Managed Instance migrations |
Validate |
Properties for task that validates migration input for SQL to Azure SQL Database Managed Instance |
Validate |
Properties for the task that validates a migration between MongoDB data sources |
Validate |
Properties for the task that validates a migration for Oracle to Azure Database for PostgreSQL for online migrations |
Validate |
Output for task that validates migration input for Oracle to Azure Database for PostgreSQL for online migrations |
Validate |
Input for task that validates migration input for SQL sync migrations |
Validate |
Output for task that validates migration input for SQL sync migrations |
Validation |
Description about the errors happen while performing migration validation |
Validation |
Current status of the validation |
Wait |
Wait statistics gathered during query batch execution |
ApiError
Error information.
Name | Type | Description |
---|---|---|
error |
Error information in OData format |
|
systemData |
Metadata pertaining to creation and last modification of the resource. |
AuthenticationType
An enumeration of possible authentication types when connecting
Name | Type | Description |
---|---|---|
ActiveDirectoryIntegrated |
string |
|
ActiveDirectoryPassword |
string |
|
None |
string |
|
SqlAuthentication |
string |
|
WindowsAuthentication |
string |
AzureActiveDirectoryApp
Azure Active Directory Application
Name | Type | Description |
---|---|---|
appKey |
string |
Key used to authenticate to the Azure Active Directory Application |
applicationId |
string |
Application ID of the Azure Active Directory Application |
ignoreAzurePermissions |
boolean |
Ignore checking azure permissions on the AAD app |
tenantId |
string |
Tenant id of the customer |
BackupFileInfo
Information of the backup file
Name | Type | Description |
---|---|---|
familySequenceNumber |
integer |
Sequence number of the backup file in the backup set |
fileLocation |
string |
Location of the backup file in shared folder |
status |
Status of the backup file during migration |
BackupFileStatus
An enumeration of Status of the log backup file.
Name | Type | Description |
---|---|---|
Arrived |
string |
|
Cancelled |
string |
|
Queued |
string |
|
Restored |
string |
|
Restoring |
string |
|
Uploaded |
string |
|
Uploading |
string |
BackupMode
An enumeration of backup modes
Name | Type | Description |
---|---|---|
CreateBackup |
string |
|
ExistingBackup |
string |
BackupSetInfo
Information of backup set
Name | Type | Description |
---|---|---|
backupFinishedDate |
string |
Date and time that the backup operation finished |
backupSetId |
string |
Id for the set of backup files |
backupStartDate |
string |
Date and time that the backup operation began |
backupType |
Enum of the different backup types |
|
databaseName |
string |
Name of the database to which the backup set belongs |
firstLsn |
string |
First log sequence number of the backup file |
isBackupRestored |
boolean |
Whether the backup set is restored or not |
lastLsn |
string |
Last log sequence number of the backup file |
lastModifiedTime |
string |
Last modified time of the backup file in share location |
listOfBackupFiles |
List of files in the backup set |
BackupType
Enum of the different backup types.
Name | Type | Description |
---|---|---|
Database |
string |
|
DifferentialDatabase |
string |
|
DifferentialFile |
string |
|
DifferentialPartial |
string |
|
File |
string |
|
Partial |
string |
|
TransactionLog |
string |
BlobShare
Blob container storage information.
Name | Type | Description |
---|---|---|
sasUri |
string |
SAS URI of Azure Storage Account Container. |
CommandState
The state of the command. This is ignored if submitted.
Name | Type | Description |
---|---|---|
Accepted |
string |
|
Failed |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
ConnectToMongoDbTaskProperties
Properties for the task that validates the connection to and provides information about a MongoDB server
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Describes a connection to a MongoDB data source |
|
output |
An array containing a single MongoDbClusterInfo object |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect. |
Task type. |
ConnectToSourceMySqlTaskInput
Input for the task that validates MySQL database connection
Name | Type | Default value | Description |
---|---|---|---|
checkPermissionsGroup |
Permission group for validations |
||
isOfflineMigration |
boolean |
False |
Flag for whether or not the migration is offline |
sourceConnectionInfo |
Information for connecting to MySQL source |
||
targetPlatform |
Target Platform for the migration |
ConnectToSourceMySqlTaskProperties
Properties for the task that validates MySQL database connection
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToSourceNonSqlTaskOutput
Output for connect to MySQL type source
Name | Type | Description |
---|---|---|
databases |
string[] |
List of databases on the server |
id |
string |
Result identifier |
serverProperties |
Server properties |
|
sourceServerBrandVersion |
string |
Server brand version |
validationErrors |
Validation errors associated with the task |
ConnectToSourceOracleSyncTaskInput
Input for the task that validates Oracle database connection
Name | Type | Description |
---|---|---|
sourceConnectionInfo |
Information for connecting to Oracle source |
ConnectToSourceOracleSyncTaskOutput
Output for the task that validates Oracle database connection
Name | Type | Description |
---|---|---|
databases |
string[] |
List of schemas on source server |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Version of the source server |
validationErrors |
Validation errors associated with the task |
ConnectToSourceOracleSyncTaskProperties
Properties for the task that validates Oracle database connection
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToSourcePostgreSqlSyncTaskInput
Input for the task that validates connection to PostgreSQL and source server requirements
Name | Type | Description |
---|---|---|
sourceConnectionInfo |
Connection information for source PostgreSQL server |
ConnectToSourcePostgreSqlSyncTaskOutput
Output for the task that validates connection to PostgreSQL and source server requirements
Name | Type | Description |
---|---|---|
databases |
string[] |
List of databases on source server |
id |
string |
Result identifier |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Version of the source server |
validationErrors |
Validation errors associated with the task |
ConnectToSourcePostgreSqlSyncTaskProperties
Properties for the task that validates connection to PostgreSQL server and source server requirements for online migration
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToSourceSqlServerSyncTaskProperties
Properties for the task that validates connection to SQL Server and source server requirements for online migration
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | ConnectToSourceSqlServerTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToSourceSqlServerTaskInput
Input for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Default value | Description |
---|---|---|---|
checkPermissionsGroup |
Permission group for validations |
||
collectAgentJobs |
boolean |
False |
Flag for whether to collect agent jobs from source server. |
collectDatabases |
boolean |
True |
Flag for whether to collect databases from source server. |
collectLogins |
boolean |
False |
Flag for whether to collect logins from source server. |
collectTdeCertificateInfo |
boolean |
False |
Flag for whether to collect TDE Certificate names from source server. |
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
|
sourceConnectionInfo |
Connection information for Source SQL Server |
||
validateSsisCatalogOnly |
boolean |
False |
Flag for whether to validate SSIS catalog is reachable on the source server. |
ConnectToSourceSqlServerTaskOutputAgentJobLevel
Agent Job level output for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Description |
---|---|---|
id |
string |
Result identifier |
isEnabled |
boolean |
The state of the original Agent Job. |
jobCategory |
string |
The type of Agent Job. |
jobOwner |
string |
The owner of the Agent Job |
lastExecutedOn |
string |
UTC Date and time when the Agent Job was last executed. |
migrationEligibility |
Information about eligibility of agent job for migration. |
|
name |
string |
Agent Job name |
resultType |
string:
Agent |
Type of result - database level or task level |
validationErrors |
Validation errors |
ConnectToSourceSqlServerTaskOutputDatabaseLevel
Database level output for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Description |
---|---|---|
compatibilityLevel |
SQL Server compatibility level of database |
|
databaseFiles |
The list of database files |
|
databaseState |
State of the database |
|
id |
string |
Result identifier |
name |
string |
Database name |
resultType |
string:
Database |
Type of result - database level or task level |
sizeMB |
number |
Size of the file in megabytes |
ConnectToSourceSqlServerTaskOutputLoginLevel
Login level output for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Description |
---|---|---|
defaultDatabase |
string |
The default database for the login. |
id |
string |
Result identifier |
isEnabled |
boolean |
The state of the login. |
loginType |
The type of login. |
|
migrationEligibility |
Information about eligibility of login for migration. |
|
name |
string |
Login name. |
resultType |
string:
Login |
Type of result - database level or task level |
ConnectToSourceSqlServerTaskOutputTaskLevel
Task level output for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Description |
---|---|---|
agentJobs |
object |
Source agent jobs as a map from agent job name to id. |
databaseTdeCertificateMapping |
object |
Mapping from database name to TDE certificate name, if applicable |
databases |
object |
Source databases as a map from database name to database id |
id |
string |
Result identifier |
logins |
object |
Source logins as a map from login name to login id. |
resultType |
string:
Task |
Type of result - database level or task level |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Source server version |
validationErrors |
Validation errors |
ConnectToSourceSqlServerTaskProperties
Properties for the task that validates connection to SQL Server and also validates source server requirements
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | ConnectToSourceSqlServerTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
Task id |
taskType |
string:
Connect |
Task type. |
ConnectToTargetAzureDbForMySqlTaskInput
Input for the task that validates connection to Azure Database for MySQL and target server requirements
Name | Type | Default value | Description |
---|---|---|---|
isOfflineMigration |
boolean |
False |
Flag for whether or not the migration is offline |
sourceConnectionInfo |
Connection information for source MySQL server |
||
targetConnectionInfo |
Connection information for target Azure Database for MySQL server |
ConnectToTargetAzureDbForMySqlTaskOutput
Output for the task that validates connection to Azure Database for MySQL and target server requirements
Name | Type | Description |
---|---|---|
databases |
string[] |
List of databases on target server |
id |
string |
Result identifier |
serverVersion |
string |
Version of the target server |
targetServerBrandVersion |
string |
Target server brand version |
validationErrors |
Validation errors associated with the task |
ConnectToTargetAzureDbForMySqlTaskProperties
Properties for the task that validates connection to Azure Database for MySQL and target server requirements
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetAzureDbForPostgreSqlSyncTaskInput
Input for the task that validates connection to Azure Database for PostgreSQL and target server requirements
Name | Type | Description |
---|---|---|
sourceConnectionInfo |
Connection information for source PostgreSQL server |
|
targetConnectionInfo |
Connection information for target Azure Database for PostgreSQL server |
ConnectToTargetAzureDbForPostgreSqlSyncTaskOutput
Output for the task that validates connection to Azure Database for PostgreSQL and target server requirements
Name | Type | Description |
---|---|---|
databases |
string[] |
List of databases on target server |
id |
string |
Result identifier |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Version of the target server |
validationErrors |
Validation errors associated with the task |
ConnectToTargetAzureDbForPostgreSqlSyncTaskProperties
Properties for the task that validates connection to Azure Database For PostgreSQL server and target server requirements for online migration
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetOracleAzureDbForPostgreSqlSyncTaskInput
Input for the task that validates connection to Azure Database for PostgreSQL and target server requirements for Oracle source.
Name | Type | Description |
---|---|---|
targetConnectionInfo |
Connection information for target Azure Database for PostgreSQL server |
ConnectToTargetOracleAzureDbForPostgreSqlSyncTaskOutput
Output for the task that validates connection to Azure Database for PostgreSQL and target server requirements for Oracle source.
Name | Type | Description |
---|---|---|
databaseSchemaMap |
Mapping of schemas per database |
|
databases |
string[] |
List of databases on target server |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Version of the target server |
validationErrors |
Validation errors associated with the task |
ConnectToTargetOracleAzureDbForPostgreSqlSyncTaskProperties
Properties for the task that validates connection to Azure Database For PostgreSQL server and target server requirements for online migration for Oracle source.
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetSqlDbTaskInput
Input for the task that validates connection to SQL DB and target server requirements
Name | Type | Description |
---|---|---|
queryObjectCounts |
boolean |
Boolean flag indicating whether to query object counts for each database on the target server |
targetConnectionInfo |
Connection information for target SQL DB |
ConnectToTargetSqlDbTaskOutput
Output for the task that validates connection to SQL DB and target server requirements
Name | Type | Description |
---|---|---|
databases |
object |
Source databases as a map from database name to database id |
id |
string |
Result identifier |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Version of the target server |
ConnectToTargetSqlDbTaskProperties
Properties for the task that validates connection to SQL DB and target server requirements
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
createdOn |
string |
DateTime in UTC when the task was created |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetSqlMISyncTaskInput
Input for the task that validates connection to Azure SQL Database Managed Instance online scenario.
Name | Type | Description |
---|---|---|
azureApp |
Azure Active Directory Application the DMS (classic) instance will use to connect to the target instance of Azure SQL Database Managed Instance and the Azure Storage Account |
|
targetConnectionInfo |
Connection information for Azure SQL Database Managed Instance |
ConnectToTargetSqlMISyncTaskOutput
Output for the task that validates connection to Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
validationErrors |
Validation errors |
ConnectToTargetSqlMISyncTaskProperties
Properties for the task that validates connection to Azure SQL Database Managed Instance
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetSqlMITaskInput
Input for the task that validates connection to Azure SQL Database Managed Instance.
Name | Type | Default value | Description |
---|---|---|---|
collectAgentJobs |
boolean |
True |
Flag for whether to collect agent jobs from target SQL MI server. |
collectLogins |
boolean |
True |
Flag for whether to collect logins from target SQL MI server. |
targetConnectionInfo |
Connection information for target SQL Server |
||
validateSsisCatalogOnly |
boolean |
False |
Flag for whether to validate SSIS catalog is reachable on the target SQL MI server. |
ConnectToTargetSqlMITaskOutput
Output for the task that validates connection to Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
agentJobs |
string[] |
List of agent jobs on the target server. |
id |
string |
Result identifier |
logins |
string[] |
List of logins on the target server. |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
validationErrors |
Validation errors |
ConnectToTargetSqlMITaskProperties
Properties for the task that validates connection to Azure SQL Database Managed Instance
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
ConnectToTargetSqlSqlDbSyncTaskInput
Input for the task that validates connection to Azure SQL DB and target server requirements
Name | Type | Description |
---|---|---|
sourceConnectionInfo |
Connection information for source SQL Server |
|
targetConnectionInfo |
Connection information for target SQL DB |
ConnectToTargetSqlSqlDbSyncTaskProperties
Properties for the task that validates connection to SQL DB and target server requirements for online migration
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Connect |
Task type. |
createdByType
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DatabaseBackupInfo
Information about backup files when existing backup mode is used.
Name | Type | Description |
---|---|---|
backupFiles |
string[] |
The list of backup files for the current database. |
backupFinishDate |
string |
Date and time when the backup operation finished. |
backupType |
Backup Type. |
|
databaseName |
string |
Database name. |
familyCount |
integer |
Number of files in the backup set. |
isCompressed |
boolean |
Whether the backup set is compressed |
isDamaged |
boolean |
Database was damaged when backed up, but the backup operation was requested to continue despite errors. |
position |
integer |
Position of current database backup in the file. |
DatabaseCompatLevel
An enumeration of SQL Server database compatibility levels
Name | Type | Description |
---|---|---|
CompatLevel100 |
string |
|
CompatLevel110 |
string |
|
CompatLevel120 |
string |
|
CompatLevel130 |
string |
|
CompatLevel140 |
string |
|
CompatLevel80 |
string |
|
CompatLevel90 |
string |
DatabaseFileInfo
Database file specific information
Name | Type | Description |
---|---|---|
databaseName |
string |
Name of the database |
fileType |
Database file type |
|
id |
string |
Unique identifier for database file |
logicalName |
string |
Logical name of the file |
physicalFullName |
string |
Operating-system full path of the file |
restoreFullName |
string |
Suggested full path of the file for restoring |
sizeMB |
number |
Size of the file in megabytes |
DatabaseFileType
An enumeration of SQL Server database file types
Name | Type | Description |
---|---|---|
Filestream |
string |
|
Fulltext |
string |
|
Log |
string |
|
NotSupported |
string |
|
Rows |
string |
DatabaseMigrationStage
Current stage of migration
Name | Type | Description |
---|---|---|
Backup |
string |
|
Completed |
string |
|
FileCopy |
string |
|
Initialize |
string |
|
None |
string |
|
Restore |
string |
DatabaseMigrationState
Database level migration state.
Name | Type | Description |
---|---|---|
CANCELLED |
string |
|
COMPLETED |
string |
|
CUTOVER_START |
string |
|
FAILED |
string |
|
FULL_BACKUP_UPLOAD_START |
string |
|
INITIAL |
string |
|
LOG_SHIPPING_START |
string |
|
POST_CUTOVER_COMPLETE |
string |
|
UNDEFINED |
string |
|
UPLOAD_LOG_FILES_START |
string |
DatabaseSchemaMap
Mapping of schemas per database
Name | Type | Description |
---|---|---|
database |
string |
|
schemas |
string[] |
DatabaseState
An enumeration of SQL Server Database states
Name | Type | Description |
---|---|---|
Copying |
string |
|
Emergency |
string |
|
Offline |
string |
|
OfflineSecondary |
string |
|
Online |
string |
|
Recovering |
string |
|
RecoveryPending |
string |
|
Restoring |
string |
|
Suspect |
string |
DatabaseSummaryResult
Summary of database results in the migration
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
itemsCompletedCount |
integer |
Number of successfully completed items |
itemsCount |
integer |
Number of items |
name |
string |
Name of the item |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
sizeMB |
number |
Size of the database in megabytes |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
DatabaseTable
Table properties
Name | Type | Description |
---|---|---|
hasRows |
boolean |
Indicates whether table is empty or not |
name |
string |
Schema-qualified name of the table |
DataIntegrityValidationResult
Results for checksum based Data Integrity validation results
Name | Type | Description |
---|---|---|
failedObjects |
object |
List of failed table names of source and target pair |
validationErrors |
List of errors that happened while performing data integrity validation |
DataItemMigrationSummaryResult
Basic summary of a data item migration
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
itemsCompletedCount |
integer |
Number of successfully completed items |
itemsCount |
integer |
Number of items |
name |
string |
Name of the item |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
ExecutionStatistics
Description about the errors happen while performing migration validation
Name | Type | Description |
---|---|---|
cpuTimeMs |
number |
CPU Time in millisecond(s) for the query execution |
elapsedTimeMs |
number |
Time taken in millisecond(s) for executing the query |
executionCount |
integer |
No. of query executions |
hasErrors |
boolean |
Indicates whether the query resulted in an error |
sqlErrors |
string[] |
List of sql Errors |
waitStats |
<string,
Wait |
Dictionary of sql query execution wait types and the respective statistics |
FileShare
File share information with Path, Username, and Password.
Name | Type | Description |
---|---|---|
password |
string |
Password credential used to connect to the share location. |
path |
string |
The folder path for this share. |
userName |
string |
User name credential to connect to the share location |
GetTdeCertificatesSqlTaskInput
Input for the task that gets TDE certificates in Base64 encoded format.
Name | Type | Description |
---|---|---|
backupFileShare |
Backup file share information for file share to be used for temporarily storing files. |
|
connectionInfo |
Connection information for SQL Server |
|
selectedCertificates |
List containing certificate names and corresponding password to use for encrypting the exported certificate. |
GetTdeCertificatesSqlTaskOutput
Output of the task that gets TDE certificates in Base64 encoded format.
Name | Type | Description |
---|---|---|
base64EncodedCertificates |
object |
Mapping from certificate name to base 64 encoded format. |
validationErrors |
Validation errors |
GetTdeCertificatesSqlTaskProperties
Properties for the task that gets TDE certificates in Base64 encoded format.
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Get |
Task type. |
GetUserTablesMySqlTaskInput
Input for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
connectionInfo |
Connection information for SQL Server |
|
selectedDatabases |
string[] |
List of database names to collect tables for |
GetUserTablesMySqlTaskOutput
Output of the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
databasesToTables |
object |
Mapping from database name to list of tables |
id |
string |
Result identifier |
validationErrors |
Validation errors |
GetUserTablesMySqlTaskProperties
Properties for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Get |
Task type. |
GetUserTablesOracleTaskInput
Input for the task that gets the list of tables contained within a provided list of Oracle schemas.
Name | Type | Description |
---|---|---|
connectionInfo |
Information for connecting to Oracle source |
|
selectedSchemas |
string[] |
List of Oracle schemas for which to collect tables |
GetUserTablesOracleTaskOutput
Output for the task that gets the list of tables contained within a provided list of Oracle schemas.
Name | Type | Description |
---|---|---|
schemaName |
string |
The schema this result is for |
tables |
List of valid tables found for this schema |
|
validationErrors |
Validation errors associated with the task |
GetUserTablesOracleTaskProperties
Properties for the task that collects user tables for the given list of Oracle schemas
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Get |
Task type. |
GetUserTablesPostgreSqlTaskInput
Input for the task that gets the list of tables for a provided list of PostgreSQL databases.
Name | Type | Description |
---|---|---|
connectionInfo |
Information for connecting to PostgreSQL source |
|
selectedDatabases |
string[] |
List of PostgreSQL databases for which to collect tables |
GetUserTablesPostgreSqlTaskOutput
Output for the task that gets the list of tables for a provided list of PostgreSQL databases.
Name | Type | Description |
---|---|---|
databaseName |
string |
The database this result is for |
tables |
List of valid tables found for this database |
|
validationErrors |
Validation errors associated with the task |
GetUserTablesPostgreSqlTaskProperties
Properties for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Get |
Task type. |
GetUserTablesSqlSyncTaskInput
Input for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
selectedSourceDatabases |
string[] |
List of source database names to collect tables for |
selectedTargetDatabases |
string[] |
List of target database names to collect tables for |
sourceConnectionInfo |
Connection information for SQL Server |
|
targetConnectionInfo |
Connection information for SQL DB |
GetUserTablesSqlSyncTaskOutput
Output of the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
databasesToSourceTables |
object |
Mapping from database name to list of source tables |
databasesToTargetTables |
object |
Mapping from database name to list of target tables |
tableValidationErrors |
object |
Mapping from database name to list of validation errors |
validationErrors |
Validation errors |
GetUserTablesSqlSyncTaskProperties
Properties for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Get |
Task type. |
GetUserTablesSqlTaskInput
Input for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
connectionInfo |
Connection information for SQL Server |
|
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
selectedDatabases |
string[] |
List of database names to collect tables for |
GetUserTablesSqlTaskOutput
Output of the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
databasesToTables |
object |
Mapping from database name to list of tables |
id |
string |
Result identifier |
validationErrors |
Validation errors |
GetUserTablesSqlTaskProperties
Properties for the task that collects user tables for the given list of databases
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
Task id |
taskType |
string:
Get |
Task type. |
LoginMigrationStage
Enum of the different stage of login migration.
Name | Type | Description |
---|---|---|
AssignRoleMembership |
string |
|
AssignRoleOwnership |
string |
|
Completed |
string |
|
EstablishObjectPermissions |
string |
|
EstablishServerPermissions |
string |
|
EstablishUserMapping |
string |
|
Initialize |
string |
|
LoginMigration |
string |
|
None |
string |
LoginType
Enum mapping of SMO LoginType.
Name | Type | Description |
---|---|---|
AsymmetricKey |
string |
|
Certificate |
string |
|
ExternalGroup |
string |
|
ExternalUser |
string |
|
SqlLogin |
string |
|
WindowsGroup |
string |
|
WindowsUser |
string |
MigrateMISyncCompleteCommandInput
Input for command that completes online migration for an Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
sourceDatabaseName |
string |
Name of managed instance database |
MigrateMISyncCompleteCommandOutput
Output for command that completes online migration for an Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
errors |
List of errors that happened during the command execution |
MigrateMISyncCompleteCommandProperties
Properties for the command that completes online migration for an Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
commandType |
string:
Migrate. |
Command type. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Command input |
|
output |
Command output. This is ignored if submitted. |
|
state |
The state of the command. This is ignored if submitted. |
MigrateMongoDbTaskProperties
Properties for the task that migrates data between MongoDB data sources
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Describes how a MongoDB data migration should be performed |
|
output | MongoDbProgress[]: |
Base class for MongoDB migration outputs |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateMySqlAzureDbForMySqlOfflineDatabaseInput
Database specific information for offline MySQL to Azure Database for MySQL migration task inputs
Name | Type | Description |
---|---|---|
name |
string |
Name of the database |
tableMap |
object |
Mapping of source to target tables |
targetDatabaseName |
string |
Name of target database. Note: Target database will be truncated before starting migration. |
MigrateMySqlAzureDbForMySqlOfflineTaskInput
Input for the task that migrates MySQL databases to Azure Database for MySQL for offline migrations
Name | Type | Default value | Description |
---|---|---|---|
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
|
makeSourceServerReadOnly |
boolean |
False |
Setting to set the source server read only |
optionalAgentSettings |
object |
Optional parameters for fine tuning the data transfer rate during migration |
|
selectedDatabases |
Databases to migrate |
||
sourceConnectionInfo |
Connection information for source MySQL |
||
startedOn |
string |
Parameter to specify when the migration started |
|
targetConnectionInfo |
Connection information for target Azure Database for MySQL |
MigrateMySqlAzureDbForMySqlOfflineTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
errorCount |
integer |
Number of database/object errors. |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
lastStorageUpdate |
string |
Last time the storage was updated |
message |
string |
Migration progress message |
numberOfObjects |
integer |
Number of objects |
numberOfObjectsCompleted |
integer |
Number of successfully completed objects |
objectSummary |
<string,
Data |
Summary of object results in the migration |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
resultType |
string:
Database |
Result type |
stage |
Migration stage that this database is in |
|
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
MigrateMySqlAzureDbForMySqlOfflineTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Unique identifier for the exception |
resultType |
string:
Error |
Result type |
MigrateMySqlAzureDbForMySqlOfflineTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
databaseSummary |
<string,
Database |
Summary of database results in the migration |
databases |
object |
Selected databases as a map from database name to database id |
durationInSeconds |
integer |
Duration of task execution in seconds. |
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
lastStorageUpdate |
string |
Last time the storage was updated |
message |
string |
Migration progress message |
migrationReportResult |
Migration Report Result, provides unique url for downloading your migration report. |
|
resultType |
string:
Migration |
Result type |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
status |
Current status of migration |
|
statusMessage |
string |
Migration status message |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
MigrateMySqlAzureDbForMySqlOfflineTaskOutputTableLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
id |
string |
Result identifier |
itemsCompletedCount |
integer |
Number of successfully completed items |
itemsCount |
integer |
Number of items |
lastStorageUpdate |
string |
Last time the storage was updated |
objectName |
string |
Name of the item |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
resultType |
string:
Table |
Result type |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
MigrateMySqlAzureDbForMySqlOfflineTaskProperties
Properties for the task that migrates MySQL databases to Azure Database for MySQL for offline migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
isCloneable |
boolean |
whether the task can be cloned or not |
output | MigrateMySqlAzureDbForMySqlOfflineTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
Task id |
taskType |
string:
Migrate. |
Task type. |
MigrateMySqlAzureDbForMySqlSyncDatabaseInput
Database specific information for MySQL to Azure Database for MySQL migration task inputs
Name | Type | Description |
---|---|---|
migrationSetting |
object |
Migration settings which tune the migration behavior |
name |
string |
Name of the database |
sourceSetting |
object |
Source settings to tune source endpoint migration behavior |
tableMap |
object |
Mapping of source to target tables |
targetDatabaseName |
string |
Name of target database. Note: Target database will be truncated before starting migration. |
targetSetting |
object |
Target settings to tune target endpoint migration behavior |
MigrateMySqlAzureDbForMySqlSyncTaskInput
Input for the task that migrates MySQL databases to Azure Database for MySQL for online migrations
Name | Type | Description |
---|---|---|
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Connection information for source MySQL |
|
targetConnectionInfo |
Connection information for target Azure Database for MySQL |
MigrateMySqlAzureDbForMySqlSyncTaskOutputDatabaseError
Name | Type | Description |
---|---|---|
errorMessage |
string |
Error message |
events |
List of error events. |
|
id |
string |
Result identifier |
resultType |
string:
Database |
Result type |
MigrateMySqlAzureDbForMySqlSyncTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
appliedChanges |
integer |
Number of applied changes |
cdcDeleteCounter |
integer |
Number of cdc deletes |
cdcInsertCounter |
integer |
Number of cdc inserts |
cdcUpdateCounter |
integer |
Number of cdc updates |
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
fullLoadCompletedTables |
integer |
Number of tables completed in full load |
fullLoadErroredTables |
integer |
Number of tables errored in full load |
fullLoadLoadingTables |
integer |
Number of tables loading in full load |
fullLoadQueuedTables |
integer |
Number of tables queued in full load |
id |
string |
Result identifier |
incomingChanges |
integer |
Number of incoming changes |
initializationCompleted |
boolean |
Indicates if initial load (full load) has been completed |
latency |
integer |
CDC apply latency |
migrationState |
Migration state that this database is in |
|
resultType |
string:
Database |
Result type |
startedOn |
string |
Migration start time |
MigrateMySqlAzureDbForMySqlSyncTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Result identifier |
resultType |
string:
Error |
Result type |
MigrateMySqlAzureDbForMySqlSyncTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
id |
string |
Result identifier |
resultType |
string:
Migration |
Result type |
sourceServer |
string |
Source server name |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
targetServer |
string |
Target server name |
targetServerVersion |
string |
Target server version |
MigrateMySqlAzureDbForMySqlSyncTaskOutputTableLevel
Name | Type | Description |
---|---|---|
cdcDeleteCounter |
string |
Number of applied deletes |
cdcInsertCounter |
string |
Number of applied inserts |
cdcUpdateCounter |
string |
Number of applied updates |
dataErrorsCounter |
integer |
Number of data errors occurred |
databaseName |
string |
Name of the database |
fullLoadEndedOn |
string |
Full load end time |
fullLoadEstFinishTime |
string |
Estimate to finish full load |
fullLoadStartedOn |
string |
Full load start time |
fullLoadTotalRows |
integer |
Number of rows applied in full load |
id |
string |
Result identifier |
lastModifiedTime |
string |
Last modified time on target |
resultType |
string:
Table |
Result type |
state |
Current state of the table migration |
|
tableName |
string |
Name of the table |
totalChangesApplied |
integer |
Total number of applied changes |
MigrateMySqlAzureDbForMySqlSyncTaskProperties
Properties for the task that migrates MySQL databases to Azure Database for MySQL for online migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | MigrateMySqlAzureDbForMySqlSyncTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateOracleAzureDbForPostgreSqlSyncTaskProperties
Properties for the task that migrates Oracle to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | MigrateOracleAzureDbPostgreSqlSyncTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateOracleAzureDbPostgreSqlSyncDatabaseInput
Database specific information for Oracle to Azure Database for PostgreSQL migration task inputs
Name | Type | Description |
---|---|---|
caseManipulation |
string |
How to handle object name casing: either Preserve or ToLower |
migrationSetting |
object |
Migration settings which tune the migration behavior |
name |
string |
Name of the migration pipeline |
schemaName |
string |
Name of the source schema |
sourceSetting |
object |
Source settings to tune source endpoint migration behavior |
tableMap |
object |
Mapping of source to target tables |
targetDatabaseName |
string |
Name of target database. Note: Target database will be truncated before starting migration. |
targetSetting |
object |
Target settings to tune target endpoint migration behavior |
MigrateOracleAzureDbPostgreSqlSyncTaskInput
Input for the task that migrates Oracle databases to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Connection information for source Oracle |
|
targetConnectionInfo |
Connection information for target Azure Database for PostgreSQL |
MigrateOracleAzureDbPostgreSqlSyncTaskOutputDatabaseError
Name | Type | Description |
---|---|---|
errorMessage |
string |
Error message |
events |
List of error events. |
|
id |
string |
Result identifier |
resultType |
string:
Database |
Result type |
MigrateOracleAzureDbPostgreSqlSyncTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
appliedChanges |
integer |
Number of applied changes |
cdcDeleteCounter |
integer |
Number of cdc deletes |
cdcInsertCounter |
integer |
Number of cdc inserts |
cdcUpdateCounter |
integer |
Number of cdc updates |
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
fullLoadCompletedTables |
integer |
Number of tables completed in full load |
fullLoadErroredTables |
integer |
Number of tables errored in full load |
fullLoadLoadingTables |
integer |
Number of tables loading in full load |
fullLoadQueuedTables |
integer |
Number of tables queued in full load |
id |
string |
Result identifier |
incomingChanges |
integer |
Number of incoming changes |
initializationCompleted |
boolean |
Indicates if initial load (full load) has been completed |
latency |
integer |
CDC apply latency |
migrationState |
Migration state that this database is in |
|
resultType |
string:
Database |
Result type |
startedOn |
string |
Migration start time |
MigrateOracleAzureDbPostgreSqlSyncTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Result identifier |
resultType |
string:
Error |
Result type |
MigrateOracleAzureDbPostgreSqlSyncTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
id |
string |
Result identifier |
resultType |
string:
Migration |
Result type |
sourceServer |
string |
Source server name |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
targetServer |
string |
Target server name |
targetServerVersion |
string |
Target server version |
MigrateOracleAzureDbPostgreSqlSyncTaskOutputTableLevel
Name | Type | Description |
---|---|---|
cdcDeleteCounter |
integer |
Number of applied deletes |
cdcInsertCounter |
integer |
Number of applied inserts |
cdcUpdateCounter |
integer |
Number of applied updates |
dataErrorsCounter |
integer |
Number of data errors occurred |
databaseName |
string |
Name of the database |
fullLoadEndedOn |
string |
Full load end time |
fullLoadEstFinishTime |
string |
Estimate to finish full load |
fullLoadStartedOn |
string |
Full load start time |
fullLoadTotalRows |
integer |
Number of rows applied in full load |
id |
string |
Result identifier |
lastModifiedTime |
string |
Last modified time on target |
resultType |
string:
Table |
Result type |
state |
Current state of the table migration |
|
tableName |
string |
Name of the table |
totalChangesApplied |
integer |
Total number of applied changes |
MigratePostgreSqlAzureDbForPostgreSqlSyncDatabaseInput
Database specific information for PostgreSQL to Azure Database for PostgreSQL migration task inputs
Name | Type | Description |
---|---|---|
id |
string |
Result identifier |
migrationSetting |
|
Migration settings which tune the migration behavior |
name |
string |
Name of the database |
selectedTables |
Migrate |
Tables selected for migration |
sourceSetting |
object |
Source settings to tune source endpoint migration behavior |
targetDatabaseName |
string |
Name of target database. Note: Target database will be truncated before starting migration. |
targetSetting |
object |
Target settings to tune target endpoint migration behavior |
MigratePostgreSqlAzureDbForPostgreSqlSyncDatabaseTableInput
Selected tables for the migration
Name | Type | Description |
---|---|---|
name |
string |
Name of the table to migrate |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskInput
Input for the task that migrates PostgreSQL databases to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Connection information for source PostgreSQL |
|
startedOn |
string |
Migration start time |
targetConnectionInfo |
Connection information for target Azure Database for PostgreSQL |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutputDatabaseError
Name | Type | Description |
---|---|---|
errorMessage |
string |
Error message |
events |
List of error events. |
|
id |
string |
Result identifier |
resultType |
string:
Database |
Result type |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
appliedChanges |
integer |
Number of applied changes |
cdcDeleteCounter |
integer |
Number of cdc deletes |
cdcInsertCounter |
integer |
Number of cdc inserts |
cdcUpdateCounter |
integer |
Number of cdc updates |
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
fullLoadCompletedTables |
integer |
Number of tables completed in full load |
fullLoadErroredTables |
integer |
Number of tables errored in full load |
fullLoadLoadingTables |
integer |
Number of tables loading in full load |
fullLoadQueuedTables |
integer |
Number of tables queued in full load |
id |
string |
Result identifier |
incomingChanges |
integer |
Number of incoming changes |
initializationCompleted |
boolean |
Indicates if initial load (full load) has been completed |
latency |
integer |
CDC apply latency |
migrationState |
Migration state that this database is in |
|
resultType |
string:
Database |
Result type |
startedOn |
string |
Migration start time |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
events |
List of error events |
|
id |
string |
Result identifier |
resultType |
string:
Error |
Result type |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
databaseCount |
number |
Number of databases to include |
endedOn |
string |
Migration end time |
id |
string |
Result identifier |
resultType |
string:
Migration |
Result type |
sourceServer |
string |
Source server name |
sourceServerType |
Source server type. |
|
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
state |
Migration status |
|
targetServer |
string |
Target server name |
targetServerType |
Target server type. |
|
targetServerVersion |
string |
Target server version |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutputTableLevel
Name | Type | Description |
---|---|---|
cdcDeleteCounter |
integer |
Number of applied deletes |
cdcInsertCounter |
integer |
Number of applied inserts |
cdcUpdateCounter |
integer |
Number of applied updates |
dataErrorsCounter |
integer |
Number of data errors occurred |
databaseName |
string |
Name of the database |
fullLoadEndedOn |
string |
Full load end time |
fullLoadEstFinishTime |
string |
Estimate to finish full load |
fullLoadStartedOn |
string |
Full load start time |
fullLoadTotalRows |
integer |
Number of rows applied in full load |
id |
string |
Result identifier |
lastModifiedTime |
string |
Last modified time on target |
resultType |
string:
Table |
Result type |
state |
Current state of the table migration |
|
tableName |
string |
Name of the table |
totalChangesApplied |
integer |
Total number of applied changes |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskProperties
Properties for the task that migrates PostgreSQL databases to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
createdOn |
string |
DateTime in UTC when the task was created |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
isCloneable |
boolean |
whether the task can be cloned or not |
output |
MigratePostgreSqlAzureDbForPostgreSqlSyncTaskOutput[]:
|
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
task id |
taskType |
string:
Migrate. |
Task type. |
MigrateSqlServerSqlDbDatabaseInput
Database specific information for SQL to Azure SQL DB migration task inputs
Name | Type | Description |
---|---|---|
id |
string |
id of the database |
makeSourceDbReadOnly |
boolean |
Whether to set database read only before migration |
name |
string |
Name of the database |
schemaSetting |
object |
Settings selected for DB schema migration. |
tableMap |
object |
Mapping of source to target tables |
targetDatabaseName |
string |
Name of target database. Note: Target database will be truncated before starting migration. |
MigrateSqlServerSqlDbSyncDatabaseInput
Database specific information for SQL to Azure SQL DB sync migration task inputs
Name | Type | Description |
---|---|---|
id |
string |
Unique identifier for database |
migrationSetting |
object |
Migration settings which tune the migration behavior |
name |
string |
Name of database |
schemaName |
string |
Schema name to be migrated |
sourceSetting |
object |
Source settings to tune source endpoint migration behavior |
tableMap |
object |
Mapping of source to target tables |
targetDatabaseName |
string |
Target database name |
targetSetting |
object |
Target settings to tune target endpoint migration behavior |
MigrateSqlServerSqlDbSyncTaskInput
Input for the task that migrates on-prem SQL Server databases to Azure SQL Database for online migrations
Name | Type | Description |
---|---|---|
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Information for connecting to source |
|
targetConnectionInfo |
Information for connecting to target |
|
validationOptions |
Validation options |
MigrateSqlServerSqlDbSyncTaskOutputDatabaseError
Name | Type | Description |
---|---|---|
errorMessage |
string |
Error message |
events |
List of error events. |
|
id |
string |
Result identifier |
resultType |
string:
Database |
Result type |
MigrateSqlServerSqlDbSyncTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
appliedChanges |
integer |
Number of applied changes |
cdcDeleteCounter |
integer |
Number of cdc deletes |
cdcInsertCounter |
integer |
Number of cdc inserts |
cdcUpdateCounter |
integer |
Number of cdc updates |
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
fullLoadCompletedTables |
integer |
Number of tables completed in full load |
fullLoadErroredTables |
integer |
Number of tables errored in full load |
fullLoadLoadingTables |
integer |
Number of tables loading in full load |
fullLoadQueuedTables |
integer |
Number of tables queued in full load |
id |
string |
Result identifier |
incomingChanges |
integer |
Number of incoming changes |
initializationCompleted |
boolean |
Indicates if initial load (full load) has been completed |
latency |
integer |
CDC apply latency |
migrationState |
Migration state that this database is in |
|
resultType |
string:
Database |
Result type |
startedOn |
string |
Migration start time |
MigrateSqlServerSqlDbSyncTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Result identifier |
resultType |
string:
Error |
Result type |
MigrateSqlServerSqlDbSyncTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
databaseCount |
integer |
Count of databases |
endedOn |
string |
Migration end time |
id |
string |
Result identifier |
resultType |
string:
Migration |
Result type |
sourceServer |
string |
Source server name |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
targetServer |
string |
Target server name |
targetServerVersion |
string |
Target server version |
MigrateSqlServerSqlDbSyncTaskOutputTableLevel
Name | Type | Description |
---|---|---|
cdcDeleteCounter |
integer |
Number of applied deletes |
cdcInsertCounter |
integer |
Number of applied inserts |
cdcUpdateCounter |
integer |
Number of applied updates |
dataErrorsCounter |
integer |
Number of data errors occurred |
databaseName |
string |
Name of the database |
fullLoadEndedOn |
string |
Full load end time |
fullLoadEstFinishTime |
string |
Estimate to finish full load |
fullLoadStartedOn |
string |
Full load start time |
fullLoadTotalRows |
integer |
Number of rows applied in full load |
id |
string |
Result identifier |
lastModifiedTime |
string |
Last modified time on target |
resultType |
string:
Table |
Result type |
state |
Current state of the table migration |
|
tableName |
string |
Name of the table |
totalChangesApplied |
integer |
Total number of applied changes |
MigrateSqlServerSqlDbSyncTaskProperties
Properties for the task that migrates on-prem SQL Server databases to Azure SQL Database for online migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | MigrateSqlServerSqlDbSyncTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateSqlServerSqlDbTaskInput
Input for the task that migrates on-prem SQL Server databases to Azure SQL Database
Name | Type | Description |
---|---|---|
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Information for connecting to source |
|
startedOn |
string |
Date and time relative to UTC when the migration was started on |
targetConnectionInfo |
Information for connecting to target |
|
validationOptions |
Options for enabling various post migration validations. Available options, 1.) Data Integrity Check: Performs a checksum based comparison on source and target tables after the migration to ensure the correctness of the data. 2.) Schema Validation: Performs a thorough schema comparison between the source and target tables and provides a list of differences between the source and target database, 3.) Query Analysis: Executes a set of queries picked up automatically either from the Query Plan Cache or Query Store and execute them and compares the execution time between the source and target database. |
MigrateSqlServerSqlDbTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
databaseName |
string |
Name of the item |
endedOn |
string |
Migration end time |
errorCount |
integer |
Number of database/object errors. |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
message |
string |
Migration progress message |
numberOfObjects |
integer |
Number of objects |
numberOfObjectsCompleted |
integer |
Number of successfully completed objects |
objectSummary |
<string,
Data |
Summary of object results in the migration |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
resultType |
string:
Database |
Result type |
stage |
Migration stage that this database is in |
|
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
MigrateSqlServerSqlDbTaskOutputDatabaseLevelValidationResult
Name | Type | Description |
---|---|---|
dataIntegrityValidationResult |
Provides data integrity validation result between the source and target tables that are migrated. |
|
endedOn |
string |
Validation end time |
id |
string |
Result identifier |
migrationId |
string |
Migration Identifier |
queryAnalysisValidationResult |
Results of some of the query execution result between source and target database |
|
resultType |
string:
Migration |
Result type |
schemaValidationResult |
Provides schema comparison result between source and target database |
|
sourceDatabaseName |
string |
Name of the source database |
startedOn |
string |
Validation start time |
status |
Current status of validation at the database level |
|
targetDatabaseName |
string |
Name of the target database |
MigrateSqlServerSqlDbTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Unique identifier for the exception |
resultType |
string:
Error |
Result type |
MigrateSqlServerSqlDbTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
databaseSummary |
<string,
Database |
Summary of database results in the migration |
databases |
object |
Selected databases as a map from database name to database id |
durationInSeconds |
integer |
Duration of task execution in seconds. |
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
message |
string |
Migration progress message |
migrationReportResult |
Migration Report Result, provides unique url for downloading your migration report. |
|
migrationValidationResult | MigrationValidationResult: |
Migration Validation Results |
resultType |
string:
Migration |
Result type |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
status |
Current status of migration |
|
statusMessage |
string |
Migration status message |
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
MigrateSqlServerSqlDbTaskOutputTableLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
errorPrefix |
string |
Wildcard string prefix to use for querying all errors of the item |
id |
string |
Result identifier |
itemsCompletedCount |
integer |
Number of successfully completed items |
itemsCount |
integer |
Number of items |
objectName |
string |
Name of the item |
resultPrefix |
string |
Wildcard string prefix to use for querying all sub-tem results of the item |
resultType |
string:
Table |
Result type |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
statusMessage |
string |
Status message |
MigrateSqlServerSqlDbTaskOutputValidationResult
Name | Type | Description |
---|---|---|
id |
string |
Result identifier |
migrationId |
string |
Migration Identifier |
resultType |
string:
Migration |
Result type |
status |
Current status of validation at the migration level. Status from the database validation result status will be aggregated here. |
|
summaryResults |
<string,
Migration |
Validation summary results for each database |
MigrateSqlServerSqlDbTaskProperties
Properties for the task that migrates on-prem SQL Server databases to Azure SQL Database
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
createdOn |
string |
DateTime in UTC when the task was created |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
isCloneable |
boolean |
whether the task can be cloned or not |
output | MigrateSqlServerSqlDbTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
task id |
taskType |
string:
Migrate. |
Task type. |
MigrateSqlServerSqlMIDatabaseInput
Database specific information for SQL to Azure SQL DB Managed Instance migration task inputs
Name | Type | Description |
---|---|---|
backupFilePaths |
string[] |
The list of backup files to be used in case of existing backups. |
backupFileShare |
Backup file share information for backing up this database. |
|
id |
string |
id of the database |
name |
string |
Name of the database |
restoreDatabaseName |
string |
Name of the database at destination |
MigrateSqlServerSqlMISyncTaskInput
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance online scenario.
Name | Type | Description |
---|---|---|
azureApp |
Azure Active Directory Application the DMS (classic) instance will use to connect to the target instance of Azure SQL Database Managed Instance and the Azure Storage Account |
|
backupFileShare |
Backup file share information for all selected databases. |
|
numberOfParallelDatabaseMigrations |
number |
Number of database migrations to start in parallel |
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Connection information for source SQL Server |
|
storageResourceId |
string |
Fully qualified resourceId of storage |
targetConnectionInfo |
Connection information for Azure SQL Database Managed Instance |
MigrateSqlServerSqlMISyncTaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
activeBackupSets |
Backup sets that are currently active (Either being uploaded or getting restored) |
|
containerName |
string |
Name of container created in the Azure Storage account where backups are copied to |
endedOn |
string |
Database migration end time |
errorPrefix |
string |
prefix string to use for querying errors for this database |
exceptionsAndWarnings |
Migration exceptions and warnings |
|
fullBackupSetInfo |
Details of full backup set |
|
id |
string |
Result identifier |
isFullBackupRestored |
boolean |
Whether full backup has been applied to the target database or not |
lastRestoredBackupSetInfo |
Last applied backup set information |
|
migrationState |
Current state of database |
|
resultType |
string:
Database |
Result type |
sourceDatabaseName |
string |
Name of the database |
startedOn |
string |
Database migration start time |
MigrateSqlServerSqlMISyncTaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Unique identifier for the exception |
resultType |
string:
Error |
Result type |
MigrateSqlServerSqlMISyncTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
databaseCount |
integer |
Count of databases |
databaseErrorCount |
integer |
Number of database level errors |
endedOn |
string |
Migration end time |
id |
string |
Result identifier |
resultType |
string:
Migration |
Result type |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerName |
string |
Source server name |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
targetServerBrandVersion |
string |
Target server brand version |
targetServerName |
string |
Target server name |
targetServerVersion |
string |
Target server version |
MigrateSqlServerSqlMISyncTaskProperties
Properties for task that migrates SQL Server databases to Azure SQL Database Managed Instance sync scenario
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
createdOn |
string |
DateTime in UTC when the task was created |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | MigrateSqlServerSqlMISyncTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateSqlServerSqlMITaskInput
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
aadDomainName |
string |
Azure Active Directory domain name in the format of 'contoso.com' for federated Azure AD or 'contoso.onmicrosoft.com' for managed domain, required if and only if Windows logins are selected |
backupBlobShare |
SAS URI of Azure Storage Account Container to be used for storing backup files. |
|
backupFileShare |
Backup file share information for all selected databases. |
|
backupMode |
Backup Mode to specify whether to use existing backup or create new backup. If using existing backups, backup file paths are required to be provided in selectedDatabases. |
|
encryptedKeyForSecureFields |
string |
encrypted key for secure fields |
selectedAgentJobs |
string[] |
Agent Jobs to migrate. |
selectedDatabases |
Databases to migrate |
|
selectedLogins |
string[] |
Logins to migrate. |
sourceConnectionInfo |
Information for connecting to source |
|
startedOn |
string |
Date and time relative to UTC when the migration was started on |
targetConnectionInfo |
Information for connecting to target |
MigrateSqlServerSqlMITaskOutputAgentJobLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration errors and warnings per job |
|
id |
string |
Result identifier |
isEnabled |
boolean |
The state of the original Agent Job. |
message |
string |
Migration progress message |
name |
string |
Agent Job name. |
resultType |
string:
Agent |
Result type |
startedOn |
string |
Migration start time |
state |
Current state of migration |
MigrateSqlServerSqlMITaskOutputDatabaseLevel
Name | Type | Description |
---|---|---|
databaseName |
string |
Name of the database |
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings |
|
id |
string |
Result identifier |
message |
string |
Migration progress message |
resultType |
string:
Database |
Result type |
sizeMB |
number |
Size of the database in megabytes |
stage |
Current stage of migration |
|
startedOn |
string |
Migration start time |
state |
Current state of migration |
MigrateSqlServerSqlMITaskOutputError
Name | Type | Description |
---|---|---|
error |
Migration error |
|
id |
string |
Unique identifier for the exception |
resultType |
string:
Error |
Result type |
MigrateSqlServerSqlMITaskOutputLoginLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Login migration end time |
exceptionsAndWarnings |
Login migration errors and warnings per login |
|
id |
string |
Result identifier |
loginName |
string |
Login name. |
message |
string |
Login migration progress message |
resultType |
string:
Login |
Result type |
stage |
Current stage of login |
|
startedOn |
string |
Login migration start time |
state |
Current state of login |
MigrateSqlServerSqlMITaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
agentJobs |
object |
Selected agent jobs as a map from name to id |
databases |
object |
Selected databases as a map from database name to database id |
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
logins |
object |
Selected logins as a map from name to id |
message |
string |
Migration progress message |
orphanedUsersInfo |
List of orphaned users. |
|
resultType |
string:
Migration |
Result type |
serverRoleResults |
<string,
Start |
Map of server role migration results. |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Source server version |
startedOn |
string |
Migration start time |
state |
Current state of migration |
|
status |
Current status of migration |
|
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
MigrateSqlServerSqlMITaskProperties
Properties for task that migrates SQL Server databases to Azure SQL Database Managed Instance
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
createdOn |
string |
DateTime in UTC when the task was created |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
isCloneable |
boolean |
whether the task can be cloned or not |
output | MigrateSqlServerSqlMITaskOutput[]: |
Task output. This is ignored if submitted. |
parentTaskId |
string |
parent task id |
state |
The state of the task. This is ignored if submitted. |
|
taskId |
string |
task id |
taskType |
string:
Migrate. |
Task type. |
MigrateSsisTaskInput
Input for task that migrates SSIS packages from SQL Server to Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
sourceConnectionInfo |
Information for connecting to source |
|
ssisMigrationInfo |
SSIS package migration information. |
|
targetConnectionInfo |
Information for connecting to target |
MigrateSsisTaskOutputMigrationLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
id |
string |
Result identifier |
message |
string |
Migration progress message |
resultType |
string:
Migration |
Result type |
sourceServerBrandVersion |
string |
Source server brand version |
sourceServerVersion |
string |
Source server version |
stage |
Stage of SSIS migration. |
|
startedOn |
string |
Migration start time |
status |
Current status of migration |
|
targetServerBrandVersion |
string |
Target server brand version |
targetServerVersion |
string |
Target server version |
MigrateSsisTaskOutputProjectLevel
Name | Type | Description |
---|---|---|
endedOn |
string |
Migration end time |
exceptionsAndWarnings |
Migration exceptions and warnings |
|
folderName |
string |
Name of the folder |
id |
string |
Result identifier |
message |
string |
Migration progress message |
projectName |
string |
Name of the project |
resultType |
string:
Ssis |
Result type |
stage |
Stage of SSIS migration. |
|
startedOn |
string |
Migration start time |
state |
Current state of migration |
MigrateSsisTaskProperties
Properties for task that migrates SSIS packages from SQL Server databases to Azure SQL Database Managed Instance.
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output | MigrateSsisTaskOutput[]: |
Task output. This is ignored if submitted. |
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Migrate. |
Task type. |
MigrateSyncCompleteCommandInput
Input for command that completes sync migration for a database.
Name | Type | Description |
---|---|---|
commitTimeStamp |
string |
Time stamp to complete |
databaseName |
string |
Name of database |
MigrateSyncCompleteCommandOutput
Output for command that completes sync migration for a database.
Name | Type | Description |
---|---|---|
errors |
List of errors that happened during the command execution |
|
id |
string |
Result identifier |
MigrateSyncCompleteCommandProperties
Properties for the command that completes sync migration for a database.
Name | Type | Description |
---|---|---|
commandId |
string |
Command id |
commandType |
string:
Migrate. |
Command type. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Command input |
|
output |
Command output. This is ignored if submitted. |
|
state |
The state of the command. This is ignored if submitted. |
MigrationEligibilityInfo
Information about migration eligibility of a server object
Name | Type | Description |
---|---|---|
isEligibleForMigration |
boolean |
Whether object is eligible for migration or not. |
validationMessages |
string[] |
Information about eligibility failure for the server object. |
MigrationReportResult
Migration validation report result, contains the url for downloading the generated report.
Name | Type | Description |
---|---|---|
id |
string |
Migration validation result identifier |
reportUrl |
string |
The url of the report. |
MigrationState
Current state of migration
Name | Type | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
|
None |
string |
|
Skipped |
string |
|
Stopped |
string |
|
Warning |
string |
MigrationStatus
Current status of migration
Name | Type | Description |
---|---|---|
Completed |
string |
|
CompletedWithWarnings |
string |
|
Configured |
string |
|
Connecting |
string |
|
Default |
string |
|
Error |
string |
|
Running |
string |
|
SelectLogins |
string |
|
SourceAndTargetSelected |
string |
|
Stopped |
string |
MigrationValidationDatabaseSummaryResult
Migration Validation Database level summary result
Name | Type | Description |
---|---|---|
endedOn |
string |
Validation end time |
id |
string |
Result identifier |
migrationId |
string |
Migration Identifier |
sourceDatabaseName |
string |
Name of the source database |
startedOn |
string |
Validation start time |
status |
Current status of validation at the database level |
|
targetDatabaseName |
string |
Name of the target database |
MigrationValidationOptions
Types of validations to run after the migration
Name | Type | Description |
---|---|---|
enableDataIntegrityValidation |
boolean |
Allows to perform a checksum based data integrity validation between source and target for the selected database / tables . |
enableQueryAnalysisValidation |
boolean |
Allows to perform a quick and intelligent query analysis by retrieving queries from the source database and executes them in the target. The result will have execution statistics for executions in source and target databases for the extracted queries. |
enableSchemaValidation |
boolean |
Allows to compare the schema information between source and target. |
MigrationValidationResult
Migration Validation Result
Name | Type | Description |
---|---|---|
id |
string |
Migration validation result identifier |
migrationId |
string |
Migration Identifier |
status |
Current status of validation at the migration level. Status from the database validation result status will be aggregated here. |
|
summaryResults |
<string,
Migration |
Validation summary results for each database |
MiSqlConnectionInfo
Properties required to create a connection to Azure SQL database Managed instance
Name | Type | Description |
---|---|---|
managedInstanceResourceId |
string |
Resource id for Azure SQL database Managed instance |
password |
string |
Password credential. |
type | string: |
Type of connection info |
userName |
string |
User name |
MongoDbClusterInfo
Describes a MongoDB data source
Name | Type | Description |
---|---|---|
databases |
A list of non-system databases in the cluster |
|
supportsSharding |
boolean |
Whether the cluster supports sharded collections |
type |
The type of data source |
|
version |
string |
The version of the data source in the form x.y.z (e.g. 3.6.7). Not used if Type is BlobContainer. |
MongoDbClusterType
The type of data source
Name | Type | Description |
---|---|---|
BlobContainer |
string |
|
CosmosDb |
string |
|
MongoDb |
string |
MongoDbCollectionInfo
Describes a supported collection within a MongoDB database
Name | Type | Description |
---|---|---|
averageDocumentSize |
integer |
The average document size, or -1 if the average size is unknown |
dataSize |
integer |
The estimated total data size, in bytes, or -1 if the size is unknown. |
databaseName |
string |
The name of the database containing the collection |
documentCount |
integer |
The estimated total number of documents, or -1 if the document count is unknown |
isCapped |
boolean |
Whether the collection is a capped collection (i.e. whether it has a fixed size and acts like a circular buffer) |
isSystemCollection |
boolean |
Whether the collection is system collection |
isView |
boolean |
Whether the collection is a view of another collection |
name |
string |
The unqualified name of the database or collection |
qualifiedName |
string |
The qualified name of the database or collection. For a collection, this is the database-qualified name. |
shardKey |
The shard key on the collection, or null if the collection is not sharded |
|
supportsSharding |
boolean |
Whether the database has sharding enabled. Note that the migration task will enable sharding on the target if necessary. |
viewOf |
string |
The name of the collection that this is a view of, if IsView is true |
MongoDbCollectionProgress
Describes the progress of a collection
Name | Type | Description |
---|---|---|
bytesCopied |
integer |
The number of document bytes copied during the Copying stage |
documentsCopied |
integer |
The number of documents copied during the Copying stage |
elapsedTime |
string |
The elapsed time in the format [ddd.]hh:mm:ss[.fffffff] (i.e. TimeSpan format) |
errors |
<string,
Mongo |
The errors and warnings that have occurred for the current object. The keys are the error codes. |
eventsPending |
integer |
The number of oplog events awaiting replay |
eventsReplayed |
integer |
The number of oplog events replayed so far |
lastEventTime |
string |
The timestamp of the last oplog event received, or null if no oplog event has been received yet |
lastReplayTime |
string |
The timestamp of the last oplog event replayed, or null if no oplog event has been replayed yet |
name |
string |
The name of the progress object. For a collection, this is the unqualified collection name. For a database, this is the database name. For the overall migration, this is null. |
qualifiedName |
string |
The qualified name of the progress object. For a collection, this is the database-qualified name. For a database, this is the database name. For the overall migration, this is null. |
resultType |
string:
Collection |
The type of progress object |
state | ||
totalBytes |
integer |
The total number of document bytes on the source at the beginning of the Copying stage, or -1 if the total size was unknown |
totalDocuments |
integer |
The total number of documents on the source at the beginning of the Copying stage, or -1 if the total count was unknown |
MongoDbCollectionSettings
Describes how an individual MongoDB collection should be migrated
Name | Type | Description |
---|---|---|
canDelete |
boolean |
Whether the migrator is allowed to drop the target collection in the course of performing a migration. The default is true. |
shardKey |
Describes a MongoDB shard key |
|
targetRUs |
integer |
The RUs that should be configured on a CosmosDB target, or null to use the default. This has no effect on non-CosmosDB targets. |
MongoDbConnectionInfo
Describes a connection to a MongoDB data source
Name | Type | Default value | Description |
---|---|---|---|
additionalSettings |
string |
Additional connection settings |
|
authentication |
Authentication type to use for connection |
||
connectionString |
string |
A MongoDB connection string or blob container URL. The user name and password can be specified here or in the userName and password properties |
|
dataSource |
string |
Data source |
|
encryptConnection |
boolean |
Whether to encrypt the connection |
|
enforceSSL |
boolean |
||
password |
string |
Password credential. |
|
port |
integer |
port for server |
|
serverBrandVersion |
string |
server brand version |
|
serverName |
string |
name of the server |
|
serverVersion |
string |
server version |
|
trustServerCertificate |
boolean |
False |
Whether to trust the server certificate |
type |
string |
Type of connection info |
|
userName |
string |
User name |
MongoDbDatabaseInfo
Describes a database within a MongoDB data source
Name | Type | Description |
---|---|---|
averageDocumentSize |
integer |
The average document size, or -1 if the average size is unknown |
collections |
A list of supported collections in a MongoDB database |
|
dataSize |
integer |
The estimated total data size, in bytes, or -1 if the size is unknown. |
documentCount |
integer |
The estimated total number of documents, or -1 if the document count is unknown |
name |
string |
The unqualified name of the database or collection |
qualifiedName |
string |
The qualified name of the database or collection. For a collection, this is the database-qualified name. |
supportsSharding |
boolean |
Whether the database has sharding enabled. Note that the migration task will enable sharding on the target if necessary. |
MongoDbDatabaseProgress
Describes the progress of a database
Name | Type | Description |
---|---|---|
bytesCopied |
integer |
The number of document bytes copied during the Copying stage |
collections |
object |
The progress of the collections in the database. The keys are the unqualified names of the collections |
documentsCopied |
integer |
The number of documents copied during the Copying stage |
elapsedTime |
string |
The elapsed time in the format [ddd.]hh:mm:ss[.fffffff] (i.e. TimeSpan format) |
errors |
<string,
Mongo |
The errors and warnings that have occurred for the current object. The keys are the error codes. |
eventsPending |
integer |
The number of oplog events awaiting replay |
eventsReplayed |
integer |
The number of oplog events replayed so far |
lastEventTime |
string |
The timestamp of the last oplog event received, or null if no oplog event has been received yet |
lastReplayTime |
string |
The timestamp of the last oplog event replayed, or null if no oplog event has been replayed yet |
name |
string |
The name of the progress object. For a collection, this is the unqualified collection name. For a database, this is the database name. For the overall migration, this is null. |
qualifiedName |
string |
The qualified name of the progress object. For a collection, this is the database-qualified name. For a database, this is the database name. For the overall migration, this is null. |
resultType |
string:
Database |
The type of progress object |
state | ||
totalBytes |
integer |
The total number of document bytes on the source at the beginning of the Copying stage, or -1 if the total size was unknown |
totalDocuments |
integer |
The total number of documents on the source at the beginning of the Copying stage, or -1 if the total count was unknown |
MongoDbDatabaseSettings
Describes how an individual MongoDB database should be migrated
Name | Type | Description |
---|---|---|
collections |
<string,
Mongo |
The collections on the source database to migrate to the target. The keys are the unqualified names of the collections. |
targetRUs |
integer |
The RUs that should be configured on a CosmosDB target, or null to use the default, or 0 if throughput should not be provisioned for the database. This has no effect on non-CosmosDB targets. |
MongoDbError
Describes an error or warning that occurred during a MongoDB migration
Name | Type | Description |
---|---|---|
code |
string |
The non-localized, machine-readable code that describes the error or warning |
count |
integer |
The number of times the error or warning has occurred |
message |
string |
The localized, human-readable message that describes the error or warning |
type |
The type of error or warning |
MongoDbErrorType
The type of error or warning
Name | Type | Description |
---|---|---|
Error |
string |
|
ValidationError |
string |
|
Warning |
string |
MongoDbMigrationProgress
Describes the progress of the overall migration
Name | Type | Description |
---|---|---|
bytesCopied |
integer |
The number of document bytes copied during the Copying stage |
databases |
<string,
Mongo |
The progress of the databases in the migration. The keys are the names of the databases |
documentsCopied |
integer |
The number of documents copied during the Copying stage |
elapsedTime |
string |
The elapsed time in the format [ddd.]hh:mm:ss[.fffffff] (i.e. TimeSpan format) |
errors |
<string,
Mongo |
The errors and warnings that have occurred for the current object. The keys are the error codes. |
eventsPending |
integer |
The number of oplog events awaiting replay |
eventsReplayed |
integer |
The number of oplog events replayed so far |
lastEventTime |
string |
The timestamp of the last oplog event received, or null if no oplog event has been received yet |
lastReplayTime |
string |
The timestamp of the last oplog event replayed, or null if no oplog event has been replayed yet |
name |
string |
The name of the progress object. For a collection, this is the unqualified collection name. For a database, this is the database name. For the overall migration, this is null. |
qualifiedName |
string |
The qualified name of the progress object. For a collection, this is the database-qualified name. For a database, this is the database name. For the overall migration, this is null. |
resultType |
string:
Migration |
The type of progress object |
state | ||
totalBytes |
integer |
The total number of document bytes on the source at the beginning of the Copying stage, or -1 if the total size was unknown |
totalDocuments |
integer |
The total number of documents on the source at the beginning of the Copying stage, or -1 if the total count was unknown |
MongoDbMigrationSettings
Describes how a MongoDB data migration should be performed
Name | Type | Description |
---|---|---|
boostRUs |
integer |
The RU limit on a CosmosDB target that collections will be temporarily increased to (if lower) during the initial copy of a migration, from 10,000 to 1,000,000, or 0 to use the default boost (which is generally the maximum), or null to not boost the RUs. This setting has no effect on non-CosmosDB targets. |
databases |
<string,
Mongo |
The databases on the source cluster to migrate to the target. The keys are the names of the databases. |
replication |
Describes how changes will be replicated from the source to the target. The default is OneTime. |
|
source |
Settings used to connect to the source cluster |
|
target |
Settings used to connect to the target cluster |
|
throttling |
Settings used to limit the resource usage of the migration |
MongoDbMigrationState
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Complete |
string |
|
Copying |
string |
|
Failed |
string |
|
Finalizing |
string |
|
InitialReplay |
string |
|
Initializing |
string |
|
NotStarted |
string |
|
Replaying |
string |
|
Restarting |
string |
|
ValidatingInput |
string |
MongoDbReplication
Describes how changes will be replicated from the source to the target. The default is OneTime.
Name | Type | Description |
---|---|---|
Continuous |
string |
|
Disabled |
string |
|
OneTime |
string |
MongoDbShardKeyField
Describes a field reference within a MongoDB shard key
Name | Type | Description |
---|---|---|
name |
string |
The name of the field |
order |
The field ordering |
MongoDbShardKeyInfo
Describes a MongoDB shard key
Name | Type | Description |
---|---|---|
fields |
The fields within the shard key |
|
isUnique |
boolean |
Whether the shard key is unique |
MongoDbShardKeyOrder
The field ordering
Name | Type | Description |
---|---|---|
Forward |
string |
|
Hashed |
string |
|
Reverse |
string |
MongoDbShardKeySetting
Describes a MongoDB shard key
Name | Type | Description |
---|---|---|
fields |
The fields within the shard key |
|
isUnique |
boolean |
Whether the shard key is unique |
MongoDbThrottlingSettings
Specifies resource limits for the migration
Name | Type | Description |
---|---|---|
maxParallelism |
integer |
The maximum number of work items (e.g. collection copies) that will be processed in parallel |
minFreeCpu |
integer |
The percentage of CPU time that the migrator will try to avoid using, from 0 to 100 |
minFreeMemoryMb |
integer |
The number of megabytes of RAM that the migrator will try to avoid using |
MySqlConnectionInfo
Information for connecting to MySQL server
Name | Type | Default value | Description |
---|---|---|---|
additionalSettings |
string |
Additional connection settings |
|
authentication |
Authentication type to use for connection |
||
dataSource |
string |
Data source |
|
encryptConnection |
boolean |
True |
Whether to encrypt the connection |
password |
string |
Password credential. |
|
port |
integer |
Port for Server |
|
serverName |
string |
Name of the server |
|
type | string: |
Type of connection info |
|
userName |
string |
User name |
MySqlTargetPlatformType
Target Platform for the migration
Name | Type | Description |
---|---|---|
AzureDbForMySQL |
string |
|
SqlServer |
string |
ObjectType
Type of the object that has the difference. e.g (Table/View/StoredProcedure)
Name | Type | Description |
---|---|---|
Function |
string |
|
StoredProcedures |
string |
|
Table |
string |
|
User |
string |
|
View |
string |
ODataError
Error information in OData format.
Name | Type | Description |
---|---|---|
code |
string |
The machine-readable description of the error, such as 'InvalidRequest' or 'InternalServerError' |
details |
Inner errors that caused this error |
|
message |
string |
The human-readable description of the error |
OracleConnectionInfo
Information for connecting to Oracle server
Name | Type | Description |
---|---|---|
authentication |
Authentication type to use for connection |
|
dataSource |
string |
EZConnect or TNSName connection string. |
password |
string |
Password credential. |
port |
integer |
port for server |
serverName |
string |
name of the server |
serverVersion |
string |
server version |
type | string: |
Type of connection info |
userName |
string |
User name |
OrphanedUserInfo
Information of orphaned users on the SQL server database.
Name | Type | Description |
---|---|---|
databaseName |
string |
Parent database of the user |
name |
string |
Name of the orphaned user |
PostgreSqlConnectionInfo
Information for connecting to PostgreSQL server
Name | Type | Default value | Description |
---|---|---|---|
additionalSettings |
string |
Additional connection settings |
|
authentication |
Authentication type to use for connection |
||
dataSource |
string |
Data source |
|
databaseName |
string |
Name of the database |
|
encryptConnection |
boolean |
True |
Whether to encrypt the connection |
password |
string |
Password credential. |
|
port |
integer |
Port for Server |
|
serverBrandVersion |
string |
server brand version |
|
serverName |
string |
Name of the server |
|
serverVersion |
string |
server version |
|
trustServerCertificate |
boolean |
False |
Whether to trust the server certificate |
type | string: |
Type of connection info |
|
userName |
string |
User name |
ProjectTask
A task resource
QueryAnalysisValidationResult
Results for query analysis comparison between the source and target
Name | Type | Description |
---|---|---|
queryResults |
List of queries executed and it's execution results in source and target |
|
validationErrors |
Errors that are part of the execution |
QueryExecutionResult
Describes query analysis results for execution in source and target
Name | Type | Description |
---|---|---|
queryText |
string |
Query text retrieved from the source server |
sourceResult |
Query analysis result from the source |
|
statementsInBatch |
integer |
Total no. of statements in the batch |
targetResult |
Query analysis result from the target |
ReplicateMigrationState
Wrapper for replicate reported migration states.
Name | Type | Description |
---|---|---|
ACTION_REQUIRED |
string |
|
COMPLETE |
string |
|
FAILED |
string |
|
PENDING |
string |
|
UNDEFINED |
string |
|
VALIDATING |
string |
ReportableException
Exception object for all custom exceptions
Name | Type | Description |
---|---|---|
actionableMessage |
string |
Actionable steps for this exception |
filePath |
string |
The path to the file where exception occurred |
hResult |
integer |
Coded numerical value that is assigned to a specific exception |
lineNumber |
string |
The line number where exception occurred |
message |
string |
Error message |
stackTrace |
string |
Stack trace |
ScenarioSource
An enumeration of source type
Name | Type | Description |
---|---|---|
Access |
string |
|
DB2 |
string |
|
MongoDB |
string |
|
MySQL |
string |
|
MySQLRDS |
string |
|
Oracle |
string |
|
PostgreSQL |
string |
|
PostgreSQLRDS |
string |
|
SQL |
string |
|
SQLRDS |
string |
|
Sybase |
string |
ScenarioTarget
An enumeration of target type
Name | Type | Description |
---|---|---|
AzureDBForMySql |
string |
|
AzureDBForPostgresSQL |
string |
|
MongoDB |
string |
|
SQLDB |
string |
|
SQLDW |
string |
|
SQLMI |
string |
|
SQLServer |
string |
SchemaComparisonValidationResult
Results for schema comparison between the source and target
Name | Type | Description |
---|---|---|
schemaDifferences |
List of schema differences between the source and target databases |
|
sourceDatabaseObjectCount |
object |
Count of source database objects |
targetDatabaseObjectCount |
object |
Count of target database objects |
validationErrors |
List of errors that happened while performing schema compare validation |
SchemaComparisonValidationResultType
Description about the errors happen while performing migration validation
Name | Type | Description |
---|---|---|
objectName |
string |
Name of the object that has the difference |
objectType |
Type of the object that has the difference. e.g (Table/View/StoredProcedure) |
|
updateAction |
Update action type with respect to target |
SelectedCertificateInput
Info for certificate to be exported for TDE enabled databases.
Name | Type | Description |
---|---|---|
certificateName |
string |
Name of certificate to be exported. |
password |
string |
Password to use for encrypting the exported certificate. |
ServerLevelPermissionsGroup
Permission group for validations. These groups will run a set of permissions for validating user activity. Select the permission group for the activity that you are performing.
Name | Type | Description |
---|---|---|
Default |
string |
|
MigrationFromMySQLToAzureDBForMySQL |
string |
|
MigrationFromSqlServerToAzureDB |
string |
|
MigrationFromSqlServerToAzureMI |
string |
|
MigrationFromSqlServerToAzureVM |
string |
ServerProperties
Server properties for MySQL type source
Name | Type | Description |
---|---|---|
serverDatabaseCount |
integer |
Number of databases in the server |
serverEdition |
string |
Edition of the database server |
serverName |
string |
Name of the server |
serverOperatingSystemVersion |
string |
Version of the operating system |
serverPlatform |
string |
Name of the server platform |
serverVersion |
string |
Version of the database server |
Severity
Severity of the validation error
Name | Type | Description |
---|---|---|
Error |
string |
|
Message |
string |
|
Warning |
string |
SqlConnectionInfo
Information for connecting to SQL database server
Name | Type | Default value | Description |
---|---|---|---|
additionalSettings |
string |
Additional connection settings |
|
authentication |
Authentication type to use for connection |
||
dataSource |
string |
Data source in the format Protocol:MachineName\SQLServerInstanceName,PortNumber |
|
encryptConnection |
boolean |
True |
Whether to encrypt the connection |
password |
string |
Password credential. |
|
platform |
Server platform type for connection |
||
port |
integer |
Port for Server |
|
resourceId |
string |
Represents the ID of an HTTP resource represented by an Azure resource provider. |
|
serverBrandVersion |
string |
server brand version |
|
serverName |
string |
name of the server |
|
serverVersion |
string |
server version |
|
trustServerCertificate |
boolean |
False |
Whether to trust the server certificate |
type | string: |
Type of connection info |
|
userName |
string |
User name |
SqlSourcePlatform
Server platform type for connection
Name | Type | Description |
---|---|---|
SqlOnPrem |
string |
SsisMigrationInfo
SSIS migration info with SSIS store type, overwrite policy.
Name | Type | Description |
---|---|---|
environmentOverwriteOption |
The overwrite option for the SSIS environment migration |
|
projectOverwriteOption |
The overwrite option for the SSIS project migration |
|
ssisStoreType |
The SSIS store type of source, only SSIS catalog is supported now in DMS (classic) |
SsisMigrationOverwriteOption
The overwrite option for SSIS object migration, only ignore and overwrite are supported in DMS (classic) now and future may add Reuse option for container object
Name | Type | Description |
---|---|---|
Ignore |
string |
|
Overwrite |
string |
SsisMigrationStage
Current stage of SSIS migration
Name | Type | Description |
---|---|---|
Completed |
string |
|
InProgress |
string |
|
Initialize |
string |
|
None |
string |
SsisStoreType
An enumeration of supported source SSIS store type in DMS (classic)
Name | Type | Description |
---|---|---|
SsisCatalog |
string |
StartMigrationScenarioServerRoleResult
Server role migration result
Name | Type | Description |
---|---|---|
exceptionsAndWarnings |
Migration exceptions and warnings. |
|
name |
string |
Name of server role. |
state |
Current state of migration |
SyncDatabaseMigrationReportingState
Enum of the different state of database level online migration.
Name | Type | Description |
---|---|---|
BACKUP_COMPLETED |
string |
|
BACKUP_IN_PROGRESS |
string |
|
CANCELLED |
string |
|
CANCELLING |
string |
|
COMPLETE |
string |
|
COMPLETING |
string |
|
CONFIGURING |
string |
|
FAILED |
string |
|
INITIALIAZING |
string |
|
READY_TO_COMPLETE |
string |
|
RESTORE_COMPLETED |
string |
|
RESTORE_IN_PROGRESS |
string |
|
RUNNING |
string |
|
STARTING |
string |
|
UNDEFINED |
string |
|
VALIDATING |
string |
|
VALIDATION_COMPLETE |
string |
|
VALIDATION_FAILED |
string |
SyncMigrationDatabaseErrorEvent
Database migration errors for online migration
Name | Type | Description |
---|---|---|
eventText |
string |
Event text. |
eventTypeString |
string |
Event type. |
timestampString |
string |
String value of timestamp. |
SyncTableMigrationState
Enum of the different state of table level online migration.
Name | Type | Description |
---|---|---|
BEFORE_LOAD |
string |
|
CANCELED |
string |
|
COMPLETED |
string |
|
ERROR |
string |
|
FAILED |
string |
|
FULL_LOAD |
string |
SystemData
Name | Type | Description |
---|---|---|
createdAt |
string |
|
createdBy |
string |
|
createdByType | ||
lastModifiedAt |
string |
|
lastModifiedBy |
string |
|
lastModifiedByType |
TaskState
The state of the task. This is ignored if submitted.
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
FailedInputValidation |
string |
|
Faulted |
string |
|
Queued |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
UpdateActionType
Type of the actual difference for the compared object, while performing schema comparison
Name | Type | Description |
---|---|---|
AddedOnTarget |
string |
|
ChangedOnTarget |
string |
|
DeletedOnTarget |
string |
ValidateMigrationInputSqlServerSqlDbSyncTaskProperties
Properties for task that validates migration input for SQL to Azure SQL DB sync migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Validate |
Task type. |
ValidateMigrationInputSqlServerSqlMISyncTaskInput
Input for task that migrates SQL Server databases to Azure SQL Database Managed Instance online scenario.
Name | Type | Description |
---|---|---|
azureApp |
Azure Active Directory Application the DMS (classic) instance will use to connect to the target instance of Azure SQL Database Managed Instance and the Azure Storage Account |
|
backupFileShare |
Backup file share information for all selected databases. |
|
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Connection information for source SQL Server |
|
storageResourceId |
string |
Fully qualified resourceId of storage |
targetConnectionInfo |
Connection information for Azure SQL Database Managed Instance |
ValidateMigrationInputSqlServerSqlMISyncTaskOutput
Output for task that validates migration input for Azure SQL Database Managed Instance online migration
Name | Type | Description |
---|---|---|
id |
string |
Database identifier |
name |
string |
Name of database |
validationErrors |
Errors associated with a selected database object |
ValidateMigrationInputSqlServerSqlMISyncTaskProperties
Properties for task that validates migration input for SQL to Azure SQL Database Managed Instance sync scenario
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Validate |
Task type. |
ValidateMigrationInputSqlServerSqlMITaskInput
Input for task that validates migration input for SQL to Azure SQL Managed Instance
Name | Type | Description |
---|---|---|
backupBlobShare |
SAS URI of Azure Storage Account Container to be used for storing backup files. |
|
backupFileShare |
Backup file share information for all selected databases. |
|
backupMode |
Backup Mode to specify whether to use existing backup or create new backup. |
|
selectedDatabases |
Databases to migrate |
|
selectedLogins |
string[] |
Logins to migrate |
sourceConnectionInfo |
Information for connecting to source |
|
targetConnectionInfo |
Information for connecting to target |
ValidateMigrationInputSqlServerSqlMITaskOutput
Output for task that validates migration input for SQL to Azure SQL Managed Instance migrations
Name | Type | Description |
---|---|---|
backupFolderErrors |
Errors associated with the BackupFolder path |
|
backupShareCredentialsErrors |
Errors associated with backup share user name and password credentials |
|
backupStorageAccountErrors |
Errors associated with the storage account provided. |
|
databaseBackupInfo |
Information about backup files when existing backup mode is used. |
|
existingBackupErrors |
Errors associated with existing backup files. |
|
id |
string |
Result identifier |
name |
string |
Name of database |
restoreDatabaseNameErrors |
Errors associated with the RestoreDatabaseName |
ValidateMigrationInputSqlServerSqlMITaskProperties
Properties for task that validates migration input for SQL to Azure SQL Database Managed Instance
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Task input |
|
output |
Task output. This is ignored if submitted. |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Validate |
Task type. |
ValidateMongoDbTaskProperties
Properties for the task that validates a migration between MongoDB data sources
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Describes how a MongoDB data migration should be performed |
|
output |
An array containing a single MongoDbMigrationProgress object |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Validate. |
Task type. |
ValidateOracleAzureDbForPostgreSqlSyncTaskProperties
Properties for the task that validates a migration for Oracle to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
clientData |
object |
Key value pairs of client data to attach meta data information to task |
commands | CommandProperties[]: |
Array of command properties. |
errors |
Array of errors. This is ignored if submitted. |
|
input |
Input for the task that migrates Oracle databases to Azure Database for PostgreSQL for online migrations |
|
output |
An array containing a single validation error response object |
|
state |
The state of the task. This is ignored if submitted. |
|
taskType |
string:
Validate. |
Task type. |
ValidateOracleAzureDbPostgreSqlSyncTaskOutput
Output for task that validates migration input for Oracle to Azure Database for PostgreSQL for online migrations
Name | Type | Description |
---|---|---|
validationErrors |
Errors associated with a selected database object |
ValidateSyncMigrationInputSqlServerTaskInput
Input for task that validates migration input for SQL sync migrations
Name | Type | Description |
---|---|---|
selectedDatabases |
Databases to migrate |
|
sourceConnectionInfo |
Information for connecting to source SQL server |
|
targetConnectionInfo |
Information for connecting to target |
ValidateSyncMigrationInputSqlServerTaskOutput
Output for task that validates migration input for SQL sync migrations
Name | Type | Description |
---|---|---|
id |
string |
Database identifier |
name |
string |
Name of database |
validationErrors |
Errors associated with a selected database object |
ValidationError
Description about the errors happen while performing migration validation
Name | Type | Description |
---|---|---|
severity |
Severity of the error |
|
text |
string |
Error Text |
ValidationStatus
Current status of the validation
Name | Type | Description |
---|---|---|
Completed |
string |
|
CompletedWithIssues |
string |
|
Default |
string |
|
Failed |
string |
|
InProgress |
string |
|
Initialized |
string |
|
NotStarted |
string |
|
Stopped |
string |
WaitStatistics
Wait statistics gathered during query batch execution
Name | Type | Default value | Description |
---|---|---|---|
waitCount |
integer |
Total no. of waits |
|
waitTimeMs |
number |
0 |
Total wait time in millisecond(s) |
waitType |
string |
Type of the Wait |