Teilen über


Erstellen einer SQL-Datenbank mit der Fabric CLI

Gilt für:SQL-Datenbank in Microsoft Fabric

Sie können die Fabric-Befehlszeilenschnittstelle (CLI) verwenden, um SQL-Datenbanken in Fabric zu erstellen. Die Fabric CLI (fab) ist eine schnelle, vom Dateisystem inspirierte Befehlszeilenschnittstelle für Microsoft Fabric.

In diesem Artikel und Beispielskripts werden die grundlegenden Fabric CLI-Befehle veranschaulicht, die zum Bereitstellen einer Fabric SQL-Datenbank verwendet werden können.

Voraussetzungen

Bevor Sie beginnen:

  • Sie benötigen eine vorhandene Fabric-Kapazität. Falls dies nicht der Fall ist, können Sie eine Fabric-Testversion starten.

  • Sie können einen vorhandenen Arbeitsbereich verwenden oder einen Neuen Fabric-Arbeitsbereich erstellen.

  • Sie müssen Mitglied der Administrator- oder Mitgliedsrollen für den Arbeitsbereich sein, um eine SQL-Datenbank zu erstellen.

  • Stellen Sie sicher , dass Die Python-Version 3.10, 3.11 oder 3.12 auf Ihrem Computer installiert ist. Python sollte über die PATH Umgebungsvariable über Ihr Terminal zugänglich sein.

  • Installieren Sie Fabric CLI auf Ihrem Computer mit dem folgenden Befehl. Wenn eine Meldung zum Aktualisieren der Ausgabe des PATH im Installationsprogramm angezeigt wird, beheben Sie dies, bevor Sie fortfahren, da nachfolgende Schritte andernfalls fehlschlagen können.

    pip install ms-fabric-cli
    

Erstellen einer neuen SQL-Datenbank mit Fabric CLI

  1. Melden Sie sich bei Microsoft Fabric an. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:

    fab auth login 
    
  2. Folgen Sie den Anweisungen, um sich mit Ihrem Microsoft-Konto mit Zugriff auf Ihren Fabric-Arbeitsbereich zu authentifizieren.

  3. Führen Sie den folgenden Befehl aus, um eine neue SQL-Datenbank zu erstellen:

    • Ersetzen Sie den <workspacename> Namen des Arbeitsbereichs, in dem Sie die SQL-Datenbank erstellen möchten.
    • Ersetzen Sie den <databasename> Namen, den Sie für die neue SQL-Datenbank verwenden möchten.
    fab create <workspacename>.Workspace/<databasename>.SQLDatabase
    
  4. Überprüfen Sie die neue SQL-Datenbank in Ihrem Arbeitsbereich mit dem folgenden Befehl:

    • Ersetzen Sie den <workspacename> Namen des Arbeitsbereichs, in dem Sie die SQL-Datenbank erstellen möchten.
    fab ls <workspacename>.Workspace 
    

    Der fab ls Befehl zeigt eine Liste aller Elemente im Arbeitsbereich an, einschließlich der neuen SQL-Datenbank.

Datenbanksortierung

Standardmäßig wird die Datenbank mit der groß-/kleinschreibungsunabhängigen Sortierung SQL_Latin1_General_CP1_CI_AS erstellt.

Die Datenbanksortierung kann nach der Erstellung nicht geändert werden, obwohl Sortierungen für einzelne Spalten unterstützt werden.

Wenn Sie die Datenbank mit der Fabric CLI erstellen, können Sie die Fabric-API direkt mit dem Fab-API-Satz von Befehlen aufrufen. Geben Sie den gewünschten Arbeitsbereich, den neuen Datenbanknamen und die Beschreibung sowie die gewünschte Sortierung in den Parametern an.

Derzeit ist der fab cli Befehl erforderlich, um eine Datenbank mit einer nicht standardmäßigen Sortierung zu erstellen. Die Syntax ist ähnlich, beispielsweise:

fab api workspaces/<workspace unique ID>/sqldatabases -X post -H "Content-Type=application/json" -i "{\"displayName\": \"<new database name>\", \"description\": \"<new database description>\", \"creationPayload\":{\"collation\": \"Latin1_General_100_BIN2_UTF8\",\"creationMode\": \"new\"}}"

In diesem Beispiel wird eine neue Datenbank im Arbeitsbereich mit der eindeutigen ID workspace unique IDmit einem Namen <new database name>, einer Beschreibung <new database description>und der Sortierung Latin1_General_100_BIN2_UTF8erstellt.