Referenz zur Verwaltungs-API für verwaltete Azure SQL-Instanzen

  • Artikel

Gilt für:Azure SQL Managed Instance

Sie können verwaltete Instanzen von Azure SQL Managed Instance mit dem Azure-Portal, mit PowerShell, der Azure CLI, der REST-API oder Transact-SQL erstellen und konfigurieren. Dieser Artikel gibt Ihnen eine Übersicht über die Funktionen und die API, die Sie zum Erstellen und Konfigurieren von verwalteten Instanzen verwenden können.

Azure-Portal: Erstellen einer verwalteten Instanz

Eine Schnellstartanleitung zum Erstellen einer verwalteten Instanz finden Sie unter Schnellstart: Erstellen einer verwalteten Instanz.

Mit PowerShell: Erstellen und Konfigurieren von verwalteten Instanzen

Hinweis

In diesem Artikel wird das Azure Az PowerShell-Modul verwendet. Dieses PowerShell-Modul wird für die Interaktion mit Azure empfohlen. Informationen zu den ersten Schritten mit dem Az PowerShell-Modul finden Sie unter Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

Wichtig

Das PowerShell Azure Resource Manager-Modul wird von Azure SQL-Datenbank weiterhin unterstützt, aber alle zukünftigen Entwicklungen erfolgen für das Az.Sql-Modul. Informationen zu diesen Cmdlets finden Sie unter AzureRM.Sql. Die Argumente für die Befehle im Az-Modul und den AzureRM-Modulen sind im Wesentlichen identisch.

Verwenden Sie zum Erstellen und Verwalten verwalteter Instanzen mithilfe von Azure PowerShell die folgenden PowerShell-Cmdlets. Wenn Sie PowerShell installieren oder aktualisieren müssen, helfen Ihnen die Informationen unter Installieren des Azure PowerShell-Moduls weiter.

Tipp

PowerShell-Beispielskripts finden Sie unter Schnellstartskript: Erstellen einer verwalteten Instanz mithilfe der PowerShell-Bibliothek.

Cmdlet BESCHREIBUNG
New-AzSqlInstance Erstellt eine verwaltete Instanz.
Get-AzSqlInstance Gibt Informationen zu einer verwalteten Instanz zurück.
Set-AzSqlInstance Legt Eigenschaften für eine verwaltete Instanz fest.
Remove-AzSqlInstance Entfernt eine verwaltete Instanz.
Get-AzSqlInstanceOperation Ruft eine Liste der Verwaltungsvorgänge ab, die für die verwaltete Instanz oder einen bestimmten Vorgang ausgeführt wurden.
Stop-AzSqlInstanceOperation Bricht den Verwaltungsvorgang ab, der für die verwaltete Instanz ausgeführt wird.
New-AzSqlInstanceDatabase Erstellt eine SQL Managed Instance-Datenbank.
Get-AzSqlInstanceDatabase Gibt Informationen zu einer SQL Managed Instance-Datenbank zurück.
Remove-AzSqlInstanceDatabase Entfernt eine SQL Managed Instance-Datenbank.
Restore-AzSqlInstanceDatabase Stellt eine SQL Managed Instance-Datenbank wieder her.

Azure CLI: Erstellen und Konfigurieren von verwalteten Instanzen

Verwenden Sie zum Erstellen und Konfigurieren verwalteter Instanzen mithilfe der Azure CLI die folgenden Azure CLI-Befehle für SQL Managed Instance. Führen Sie Azure CLI mithilfe von Azure Cloud Shell in Ihrem Browser aus, oder installieren Sie sie unter macOS, Linux oder Windows.

Tipp

Eine Azure CLI-Schnellstartanleitung finden Sie unter Arbeiten mit einer verwalteten SQL-Instanz mithilfe der Azure CLI.

Cmdlet BESCHREIBUNG
az sql mi create Erstellt eine verwaltete Instanz.
az sql mi list Listet verfügbare verwaltete Instanzen auf.
az sql mi show Ruft die Details für eine verwaltete Instanz ab.
az sql mi update Aktualisiert eine verwaltete Instanz.
az sql mi delete Entfernt eine verwaltete Instanz.
az sql mi op list Ruft eine Liste der Verwaltungsvorgänge ab, die für die verwaltete Instanz ausgeführt wurden.
az sql mi op show Ruft den Verwaltungsvorgang ab, der für die verwaltete Instanz ausgeführt wurde.
az sql mi op cancel Bricht den Verwaltungsvorgang ab, der für die verwaltete Instanz ausgeführt wird.
az sql midb create Erstellt eine verwaltete Datenbank.
az sql midb list Listet verfügbare verwaltete Datenbanken auf.
az sql midb restore Stellt eine verwaltete Datenbank wieder her.
az sql midb delete Entfernt eine verwaltete Datenbank.

Transact-SQL: Erstellen und Konfigurieren von Instanzdatenbanken

Verwenden Sie zum Erstellen und Konfigurieren einer Instanzdatenbank nach dem Erstellen der verwalteten Instanz die folgenden T-SQL-Befehle. Sie können diese Befehle mit dem Azure-Portal, SQL Server Management Studio, Azure Data Studio, Visual Studio Code oder einem beliebigen anderen Programm ausführen, mit dem eine Verbindung mit einem Server hergestellt und Transact-SQL-Befehle übergeben werden können.

Tipp

Schnellstartanleitungen, in denen gezeigt wird, wie Sie eine verwaltete Instanz mithilfe von SQL Server Management Studio unter Microsoft Windows konfigurieren und eine Verbindung herstellen, finden Sie unter Schnellstart: Konfigurieren einer Azure-VM für das Herstellen einer Verbindung mit einer verwalteten Azure SQL-Instanz und Schnellstart: Konfigurieren einer Point-to-Site-Verbindung von einem lokalen Computer zu einer verwalteten Azure SQL-Instanz.

Wichtig

Sie können eine verwaltete Instanz nicht mithilfe von Transact-SQL erstellen oder löschen.

Get-Help BESCHREIBUNG
CREATE DATABASE Erstellt eine neue verwaltete Instanz in SQL Managed Instance. Es muss eine Verbindung mit der master-Datenbank bestehen, um eine neue Datenbank zu erstellen.
ALTER DATABASE Ändert eine verwaltete Instanz in SQL Managed Instance.

REST-API: Erstellen und Konfigurieren von verwalteten Instanzen

Verwenden Sie zum Erstellen und Konfigurieren verwalteter Instanzen die folgenden REST-API-Anforderungen.

Get-Help Beschreibung
SQL Managed Instance – Erstellen oder Aktualisieren Erstellt oder aktualisiert eine verwaltete Instanz.
SQL Managed Instance – Löschen Löscht eine verwaltete Instanz.
SQL Managed Instance – Abrufen Ruft eine verwaltete Instanz ab.
SQL Managed Instance – Beenden Beendet eine verwaltete Instanz.
SQL Managed Instance – Starten Startet eine verwaltete Instanz
SQL Managed Instance – Auflisten Gibt eine Liste der verwalteten Instanzen in einem Abonnement zurück.
SQL Managed Instance – Auflisten nach Ressourcengruppe Gibt eine Liste der verwalteten Instanzen in einer Ressourcengruppe zurück.
SQL Managed Instance – Aktualisieren Aktualisiert eine verwaltete Instanz.
SQL Managed Instance-Vorgänge – Auflisten nach verwalteter Instanz Ruft eine Liste der Verwaltungsvorgänge ab, die für die verwaltete Instanz ausgeführt wurden.
SQL Managed Instance-Vorgänge – Abrufen Ruft den Verwaltungsvorgang ab, der für die verwaltete Instanz ausgeführt wurde.
SQL Managed Instance-Vorgänge – Abbrechen Bricht den Verwaltungsvorgang ab, der für die verwaltete Instanz ausgeführt wird.
SQL Managed Instance – Zeitplan zum Starten/Beenden – Erstellen oder Aktualisieren Erstellt oder aktualisiert einen Zeitplan zum Starten und Beenden verwalteter Instanzen.
SQL Managed Instance – Zeitplan zum Starten/Beenden – Abrufen Ruft einen vorhandenen Zeitplan zum Starten und Beenden verwalteter Instanzen ab.
SQL Managed Instance – Zeitplan zum Starten/Beenden – Löschen Löscht einen vorhandenen Zeitplan zum Starten und Beenden verwalteter Instanzen.

Nächste Schritte