Compartir vía

az datamigration sql-vm

  • 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-vm . Obtenga más información sobre las extensiones.

Administración de migraciones de bases de datos a una máquina virtual con SQL.

Comandos

Nombre Description Tipo Estado
az datamigration sql-vm cancel

Detenga la migración de la base de datos en curso a una máquina virtual con SQL.

 Extensión GA
az datamigration sql-vm create

Cree una nueva migración de base de datos a una máquina virtual de SQL determinada.

 Extensión GA
az datamigration sql-vm cutover

Inicie la migración total de la base de datos en línea en curso a la máquina virtual de SQL.

 Extensión GA
az datamigration sql-vm show

Recupere la migración de base de datos especificada para una máquina virtual sql determinada.

 Extensión GA
az datamigration sql-vm wait

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

 Extensión GA

az datamigration sql-vm cancel

Detenga la migración de la base de datos en curso a una máquina virtual con SQL.

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

Ejemplos

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

az datamigration sql-vm cancel --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nombre de la máquina virtual SQL 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-vm create

Cree una nueva migración de base de datos a una máquina virtual de SQL determinada.

az datamigration sql-vm create --resource-group
                               --sql-vm-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--offline-configuration]
                               [--scope]
                               [--source-database-name]
                               [--source-location]
                               [--source-sql-connection]
                               [--target-db-collation]
                               [--target-location]

Ejemplos

Cree o actualice el recurso de migración de base de datos con el recurso compartido de archivos como origen para los archivos de copia de seguridad.

az datamigration sql-vm create --source-location '{\"fileShare\":{\"path\":\"\\\\SharedBackup\\user\",\"password\":\"placeholder\",\"username\":\"Server\\name\"}}' --target-location account-key="abcd" storage-account-resource-id="account.database.windows.net" --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --offline-configuration last-backup-name="last_backup_file_name" offline=true --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

Cree o actualice el recurso database Migration con Azure Blob Storage como origen para los archivos de copia de seguridad.

az datamigration sql-vm create --source-location '{\"AzureBlob\":{\"storageAccountResourceId\":\"/subscriptions/1111-2222-3333-4444/resourceGroups/RG/prooviders/Microsoft.Storage/storageAccounts/MyStorage\",\"accountKey\":\"======AccountKey====\",\"blobContainerName\":\"ContainerName-X\"}}' --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --offline-configuration last-backup-name="last_backup_file_name" offline=true --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nombre de la máquina virtual SQL 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
--offline-configuration

Configuración sin conexión.

Uso: --offline-configuration offline=XX last-backup-name=XX

offline: apellido de la migración sin conexión: apellido de copia de seguridad para la migración sin conexión. Esto es opcional para las migraciones desde el recurso compartido de archivos. Si no se proporciona, el servicio determinará el último nombre de archivo de copia de seguridad en función de los archivos de copia de seguridad más recientes presentes en el recurso compartido de archivos.

--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-location

Ubicación de origen de las copias de seguridad. Valor esperado: json-string/json-file/@json-file.

--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.

--target-db-collation

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

--target-location

Ubicación de destino para copiar copias de seguridad.

Uso: --target-location storage-account-resource-id=XX account-key=XX

storage-account-resource-id: identificador de recurso de la cuenta de almacenamiento que copia copias de seguridad. clave de cuenta: clave de cuenta de almacenamiento.

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-vm cutover

Inicie la migración total de la base de datos en línea en curso a la máquina virtual de SQL.

az datamigration sql-vm cutover --migration-operation-id
                                [--ids]
                                [--no-wait]
                                [--resource-group]
                                [--sql-vm-name]
                                [--subscription]
                                [--target-db-name]

Ejemplos

Operación de migración en línea de migración total para la base de datos.

az datamigration sql-vm cutover --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nombre de la máquina virtual SQL 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-vm show

Recupere la migración de base de datos especificada para una máquina virtual sql determinada.

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

Ejemplos

Obtenga la migración de la base de datos de máquina virtual sql con el parámetro expand.

az datamigration sql-vm show --expand "MigrationStatusDetails" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

Obtenga la migración de la base de datos de máquina virtual sql sin el parámetro expand.

az datamigration sql-vm show --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nombre de la máquina virtual SQL 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-vm wait

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

az datamigration sql-vm wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--ids]
                             [--interval]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sql-vm-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 sql-vm de la migración de datos.

az datamigration sql-vm wait --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1" --created

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>.

--sql-vm-name

Nombre de la máquina virtual SQL 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.