Schnellstart: Erstellen eines Synapse SQL-Pools mithilfe der Azure-Befehlszeilenschnittstelle

Artikel
03/10/2023

Hier erfahren Sie, wie Sie mithilfe der Azure-Befehlszeilenschnittstelle einen Synapse SQL-Pool (Data Warehouse) in Azure Synapse Analytics erstellen.

Voraussetzungen

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
- Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
- Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
- Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Erste Schritte

Verwenden Sie die folgenden Befehle, um sich bei Azure anzumelden und eine Ressourcengruppe einzurichten:

Führen Sie bei Verwendung einer lokalen Installation den Befehl az login aus, um sich bei Azure anzumelden:
```
az login
```
Verwenden Sie bei Bedarf den Befehl az account set, um Ihr Abonnement auszuwählen:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Führen Sie den Befehl az group create aus, um eine Ressourcengruppe zu erstellen:
```
az group create --name myResourceGroup --location WestEurope
```
Erstellen Sie mithilfe des Befehls az sql server create einen logischen SQL-Server:
```
az sql server create --resource-group myResourceGroup --name mysqlserver \
   --admin-user ServerAdmin --admin-password ChangeYourAdminPassword1
```
Ein Server enthält eine Gruppe von Datenbanken, die als Gruppe verwaltet werden.

Konfigurieren einer Firewallregel auf Serverebene

Erstellen Sie eine Firewallregel auf Serverebene. Eine Firewallregel auf Serverebene ermöglicht es einer externen Anwendung wie SQL Server Management Studio oder dem SQLCMD-Hilfsprogramm, über die Firewall des SQL-Pooldiensts eine Verbindung mit einem SQL-Pool herzustellen.

Führen Sie den Befehl az sql server firewall-rule create aus, um eine Firewallregel zu erstellen:

az sql server firewall-rule create --resource-group myResourceGroup --name AllowSome \
   --server mysqlserver --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0

In diesem Beispiel wird die Firewall nur für andere Azure-Ressourcen geöffnet. Ändern Sie die IP-Adresse in eine für Ihre Umgebung geeignete Adresse, um die externe Konnektivität zu ermöglichen. Verwenden Sie 0.0.0.0 als IP-Startadresse und 255.255.255.255 als Endadresse, wenn Sie alle IP-Adressen öffnen möchten.

Hinweis

SQL-Endpunkte kommunizieren über Port 1433. Wenn Sie versuchen, eine Verbindung aus einem Unternehmensnetzwerk heraus herzustellen, wird der ausgehende Datenverkehr über Port 1433 von der Firewall Ihres Netzwerks unter Umständen nicht zugelassen. In diesem Fall können Sie nur dann eine Verbindung mit Ihrem Server herstellen, wenn Ihre IT-Abteilung Port 1433 öffnet.

Erstellen und Verwalten Ihres SQL-Pools

Erstellen Sie den SQL-Pool. In diesem Beispiel wird „DW100c“ als Dienstziel angegeben. Hierbei handelt es sich um einen kostengünstigeren Ausgangspunkt für Ihren SQL-Pool.

Hinweis

Sie benötigen einen zuvor erstellten Arbeitsbereich. Weitere Informationen finden Sie unter Quickstart: Erstellen eines Azure Synapse-Arbeitsbereichs über die Azure CLI.

Verwenden Sie den Befehl az synapse sql pool create, um den SQL-Pool zu erstellen:

az synapse sql pool create --resource-group myResourceGroup --name mySampleDataWarehouse \
   --performance-level "DW1000c" --workspace-name testsynapseworkspace

Weitere Informationen zu den Parameteroptionen finden Sie unter az synapse sql pool.

Ihre SQL-Pools können Sie mithilfe des Befehls az synapse sql pool list anzeigen:

az synapse sql pool list --resource-group myResourceGroup --workspace-name testsynapseworkspace

Verwenden Sie den Befehl az synapse sql pool update, um einen vorhandenen Pool zu aktualisieren:

az synapse sql pool update --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Verwenden Sie den Befehl az synapse sql pool pause, um Ihren Pool anzuhalten:

az synapse sql pool pause --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Verwenden Sie den Befehl az synapse sql pool resume, um einen angehaltenen Pool zu starten:

az synapse sql pool resume --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Wenn Sie einen vorhandenen SQL-Pool entfernen möchten, verwenden Sie den Befehl az synapse sql pool delete:

az synapse sql pool delete --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

Bereinigen von Ressourcen

Andere Schnellstarttutorials in dieser Sammlung bauen auf dieser Schnellstartanleitung auf.

Tipp

Wenn Sie mit weiteren Schnellstart-Tutorials fortfahren möchten, sollten Sie die in diesem Schnellstart erstellten Ressourcen nicht bereinigen. Falls Sie nicht fortfahren möchten, verwenden Sie den Befehl az group delete, um alle in dieser Schnellstartanleitung erstellten Ressourcen zu löschen.

az group delete --ResourceGroupName MyResourceGroup

Nächste Schritte

Sie haben nun einen SQL-Pool sowie eine Firewallregel erstellt und diese mit Ihrem SQL-Pool verbunden. Weitere Informationen finden Sie im Artikel zum Laden von Daten in den SQL-Pool.

Freigeben über