Freigeben über

az datamigration sql-db

  • Referenz

Hinweis

Diese Referenz ist Teil der Datenmigrationserweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az datamigration sql-db-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Datenbankmigrationen zu SQL DB.

Befehle

Name Beschreibung Typ Status
az datamigration sql-db cancel

Beenden Sie die in Bearbeitung ausgeführte Datenbankmigration zu SQL DB.

 Erweiterung Allgemein verfügbar
az datamigration sql-db create

Erstellen Sie eine neue Datenbankmigration zu einer bestimmten SQL Db. Mit diesem Befehl können Daten aus den ausgewählten Quelldatenbanktabellen in die Zieldatenbanktabellen migriert werden. Wenn die Zieldatenbank keine Tabelle enthält, verwenden Sie den Befehl "New-AzDataMigrationSqlServerSchema", um Schemaobjekte aus der Quelldatenbank in Zieldatenbse zu migrieren. Die Verknüpfung von New-AzDataMigrationSqlServerSchema ist https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

 Erweiterung Allgemein verfügbar
az datamigration sql-db delete

Löschen Einer laufenden oder abgeschlossenen Datenbankmigration zu SQL DB.

 Erweiterung Allgemein verfügbar
az datamigration sql-db show

Rufen Sie die angegebene Datenbankmigration für eine bestimmte SQL DB ab.

 Erweiterung Allgemein verfügbar
az datamigration sql-db wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der datamigration sql-db erfüllt ist.

 Erweiterung Allgemein verfügbar

az datamigration sql-db cancel

Beenden Sie die in Bearbeitung ausgeführte Datenbankmigration zu SQL DB.

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

Beispiele

Beendet die laufende Migration für die Datenbank.

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

Erforderliche Parameter

--migration-operation-id

Id tracking migration operation.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sqldb-instance-name

Der Name des Zielservers SQL-Datenbank Server.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--target-db-name

Name der Zieldatenbank.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az datamigration sql-db create

Erstellen Sie eine neue Datenbankmigration zu einer bestimmten SQL Db. Mit diesem Befehl können Daten aus den ausgewählten Quelldatenbanktabellen in die Zieldatenbanktabellen migriert werden. Wenn die Zieldatenbank keine Tabelle enthält, verwenden Sie den Befehl "New-AzDataMigrationSqlServerSchema", um Schemaobjekte aus der Quelldatenbank in Zieldatenbse zu migrieren. Die Verknüpfung von New-AzDataMigrationSqlServerSchema ist 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]

Beispiele

Erstellen oder Aktualisieren der Datenbankmigrationsressource mit maximalen Parametern.

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"

Erstellen oder Aktualisieren der Datenbankmigrationsressource mit minimalen Parametern.

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"

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sqldb-instance-name

Der Name des Zielservers SQL-Datenbank Server.

--target-db-name

Name der Zieldatenbank.

Optionale Parameter

--migration-service

Ressourcen-ID des Migrationsdiensts.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--scope

Ressourcen-ID der Zielressource (SQL VM, SQL verwaltete Instanz oder SQL DB).

--source-database-name

Name der Quelldatenbank.

--source-sql-connection

Sql Server-Quellverbindungsdetails.

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

Datenquelle: Datenquelle. Authentifizierung: Authentifizierungstyp. Benutzername: Benutzername, um eine Verbindung mit der SQL-Quelle herzustellen. kennwort: Kennwort zum Herstellen einer Verbindung mit der SQL-Quelle. encrypt-connection: Gibt an, ob die Verbindung verschlüsselt werden soll oder nicht. trust-server-certificate: Gibt an, ob das Serverzertifikat als vertrauenswürdig gilt oder nicht.

--table-list

Liste der zu kopierenden Tabellen.

--target-db-collation

Datenbanksortierung, die für die Zieldatenbank verwendet werden soll.

--target-sql-connection

Ziel-SQL DB-Verbindungsdetails.

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

Datenquelle: Datenquelle. Authentifizierung: Authentifizierungstyp. Benutzername: Benutzername, um eine Verbindung mit der SQL-Quelle herzustellen. kennwort: Kennwort zum Herstellen einer Verbindung mit der SQL-Quelle. encrypt-connection: Gibt an, ob die Verbindung verschlüsselt werden soll oder nicht. trust-server-certificate: Gibt an, ob das Serverzertifikat als vertrauenswürdig gilt oder nicht.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az datamigration sql-db delete

Löschen Einer laufenden oder abgeschlossenen Datenbankmigration zu SQL DB.

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

Beispiele

Löscht die Datenbankmigrationsressource.

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

Optionale Parameter

--force

Optionaler Erzwingungslöschvorgang vom Typ Boolean. Wenn dies als "true" angegeben wird, wird die Migration auch dann gelöscht, wenn sie aktiv ist.

Zulässige Werte: false, true
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sqldb-instance-name

Der Name des Zielservers SQL-Datenbank Server.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--target-db-name

Name der Zieldatenbank.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az datamigration sql-db show

Rufen Sie die angegebene Datenbankmigration für eine bestimmte SQL DB ab.

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

Beispiele

Rufen Sie die Sql DB-Datenbankmigration mit dem Erweiterungsparameter ab.

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

Sql DB-Datenbankmigration ohne den Expand-Parameter abrufen.

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

Optionale Parameter

--expand

Vollständige Migrationsdetails werden in die Antwort einbezogen.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--migration-operation-id

Optionale Migrationsvorgangs-ID. Wenn dies angegeben wird, werden Details des Migrationsvorgangs für diese ID abgerufen. Wenn nicht angegeben (Standard), werden Details im Zusammenhang mit dem letzten oder dem aktuellen Vorgang abgerufen.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sqldb-instance-name

Der Name des Zielservers SQL-Datenbank Server.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--target-db-name

Name der Zieldatenbank.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az datamigration sql-db wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der datamigration sql-db erfüllt ist.

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]

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Datenmigration sql-db erfolgreich erstellt wurde.

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

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Datenmigration sql-db erfolgreich gelöscht wurde.

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

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--expand

Vollständige Migrationsdetails werden in die Antwort einbezogen.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--migration-operation-id

Optionale Migrationsvorgangs-ID. Wenn dies angegeben wird, werden Details des Migrationsvorgangs für diese ID abgerufen. Wenn nicht angegeben (Standard), werden Details im Zusammenhang mit dem letzten oder dem aktuellen Vorgang abgerufen.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sqldb-instance-name

Der Name des Zielservers SQL-Datenbank Server.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--target-db-name

Name der Zieldatenbank.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.