Compartir a través de

az datamigration sql-db

  • Referencia

Nota:

Esta referencia forma parte de la extensión de migración de datos para la CLI de Azure (versión 2.15.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az datamigration sql-db . Obtenga más información sobre las extensiones.

Administrar migraciones de bases de datos a SQL DB.

Comandos

Nombre Description Tipo Estado
az datamigration sql-db cancel

Detenga la migración de la base de datos en curso a SQL DB.

 Extensión GA
az datamigration sql-db create

Cree una nueva migración de base de datos a una base de datos SQL determinada. Este comando puede migrar datos de las tablas de base de datos de origen seleccionadas a las tablas de base de datos de destino. Si la base de datos de destino no tiene ninguna tabla existente, use el comando New-AzDataMigrationSqlServerSchema para migrar objetos de esquema de la base de datos de origen a databse de destino. El vínculo de New-AzDataMigrationSqlServerSchema es https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

 Extensión GA
az datamigration sql-db delete

Elimine una migración en curso o completada de la base de datos a SQL DB.

 Extensión GA
az datamigration sql-db show

Recupere la migración de base de datos especificada para una base de datos SQL determinada.

 Extensión GA
az datamigration sql-db wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de sql-db de la migración de datos.

 Extensión GA

az datamigration sql-db cancel

Detenga la migración de la base de datos en curso a SQL DB.

az datamigration sql-db cancel --migration-operation-id
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]

Ejemplos

Detiene la migración en curso de la base de datos.

az datamigration sql-db cancel --migration-operation-id "9a90bb84-e70f-46f7-b0ae-1aef5b3b9f07" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Parámetros requeridos

--migration-operation-id

Operación de migración de seguimiento de identificadores.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sqldb-instance-name

Nombre del servidor de SQL Database de destino.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--target-db-name

Nombre de la base de datos de destino.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az datamigration sql-db create

Cree una nueva migración de base de datos a una base de datos SQL determinada. Este comando puede migrar datos de las tablas de base de datos de origen seleccionadas a las tablas de base de datos de destino. Si la base de datos de destino no tiene ninguna tabla existente, use el comando New-AzDataMigrationSqlServerSchema para migrar objetos de esquema de la base de datos de origen a databse de destino. El vínculo de New-AzDataMigrationSqlServerSchema es https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

az datamigration sql-db create --resource-group
                               --sqldb-instance-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--scope]
                               [--source-database-name]
                               [--source-sql-connection]
                               [--table-list]
                               [--target-db-collation]
                               [--target-sql-connection]

Ejemplos

Cree o actualice el recurso de migración de base de datos con parámetros máximos.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --table-list "[Schema1].[TableName1]" "[Schema2].[TableName2]" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Cree o actualice el recurso de migración de base de datos con parámetros mínimos.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sqldb-instance-name

Nombre del servidor de SQL Database de destino.

--target-db-name

Nombre de la base de datos de destino.

Parámetros opcionales

--migration-service

Identificador de recurso del servicio de migración.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--scope

Identificador de recurso del recurso de destino (máquina virtual de SQL, SQL Instancia administrada o SQL DB).

--source-database-name

Nombre de la base de datos de origen.

--source-sql-connection

Detalles de conexión de SQL Server de origen.

Uso: --source-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

origen de datos: origen de datos. autenticación: tipo de autenticación. user-name: nombre de usuario para conectarse a SQL de origen. password: contraseña para conectarse a SQL de origen. encrypt-connection: indica si se va a cifrar o no la conexión. trust-server-certificate: indica si se debe confiar o no en el certificado de servidor.

--table-list

Lista de tablas que se van a copiar.

--target-db-collation

Intercalación de base de datos que se va a usar para la base de datos de destino.

--target-sql-connection

Detalles de conexión de SQL DB de destino.

Uso: --target-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

origen de datos: origen de datos. autenticación: tipo de autenticación. user-name: nombre de usuario para conectarse a SQL de origen. password: contraseña para conectarse a SQL de origen. encrypt-connection: indica si se va a cifrar o no la conexión. trust-server-certificate: indica si se debe confiar o no en el certificado de servidor.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az datamigration sql-db delete

Elimine una migración en curso o completada de la base de datos a SQL DB.

az datamigration sql-db delete [--force {false, true}]
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]
                               [--yes]

Ejemplos

Elimina un recurso de migración de base de datos.

az datamigration sql-db delete --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Parámetros opcionales

--force

Fuerza opcional eliminar booleano. Si esto se proporciona como true, la migración se eliminará incluso si está activa.

valores aceptados: false, true
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sqldb-instance-name

Nombre del servidor de SQL Database de destino.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--target-db-name

Nombre de la base de datos de destino.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az datamigration sql-db show

Recupere la migración de base de datos especificada para una base de datos SQL determinada.

az datamigration sql-db show [--expand]
                             [--ids]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]

Ejemplos

Obtenga la migración de base de datos de Sql DB con el parámetro expand.

az datamigration sql-db show --expand "MigrationStatusDetails" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Obtenga la migración de base de datos de Sql DB sin el parámetro expand.

az datamigration sql-db show --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Parámetros opcionales

--expand

Los detalles completos de la migración se incluyen en la respuesta.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--migration-operation-id

Identificador opcional de la operación de migración. Si se proporciona esto, se recuperan los detalles de la operación de migración para ese identificador. Si no se proporciona (valor predeterminado), se recuperan los detalles relacionados con la operación más reciente o actual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sqldb-instance-name

Nombre del servidor de SQL Database de destino.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--target-db-name

Nombre de la base de datos de destino.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az datamigration sql-db wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de sql-db de la migración de datos.

az datamigration sql-db wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--ids]
                             [--interval]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]
                             [--timeout]
                             [--updated]

Ejemplos

Pause la ejecución de la siguiente línea de script de la CLI hasta que se cree correctamente la base de datos sql-db de la migración de datos.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --created

Pause la ejecución de la siguiente línea de script de la CLI hasta que se elimine correctamente la base de datos sql-db de la migración de datos.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --deleted

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--expand

Los detalles completos de la migración se incluyen en la respuesta.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--migration-operation-id

Identificador opcional de la operación de migración. Si se proporciona esto, se recuperan los detalles de la operación de migración para ese identificador. Si no se proporciona (valor predeterminado), se recuperan los detalles relacionados con la operación más reciente o actual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sqldb-instance-name

Nombre del servidor de SQL Database de destino.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--target-db-name

Nombre de la base de datos de destino.

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.