Entwickeln einer U-SQL-Datenbank für Azure Data Lake mithilfe eines U-SQL-Datenbankprojekts
Wichtig
Azure Data Lake Analytics am 29. Februar 2024 eingestellt. In dieser Ankündigung erhalten Sie weitere Informationen.
Für Datenanalysen kann Ihr organization Azure Synapse Analytics oder Microsoft Fabric verwenden.
U-SQL-Datenbank ermöglicht strukturierte Ansichten von unstrukturierten Daten und verwalteten strukturierten Daten in Tabellen. Darüber hinaus umfasst U-SQL-Datenbank ein allgemeines Metadatenkatalogsystem zum Organisieren von strukturierten Daten und benutzerdefiniertem Code. Über die Datenbank werden diese verbundenen Objekte konzeptionell gruppiert.
Erfahren Sie mehr über die U-SQL-Datenbank und Data Definition Language (DDL).
Das U-SQL-Datenbankprojekt ist ein Projekttyp in Visual Studio, mit dem Entwickler U-SQL-Datenbanken schnell und einfach entwickeln, verwalten und bereitstellen können.
Erstellen eines U-SQL-Datenbankprojekts
In Azure Data Lake Tools für Visual Studio nach Version 2.3.3000.0 wurde eine neue Projektvorlage für U-SQL-Datenbankprojekte hinzugefügt. Klicken Sie auf Datei > Neu > Projekt, um ein U-SQL-Projekt zu erstellen. Das U-SQL-Datenbankprojekt befindet sich unter Azure Data Lake > U-SQL (Knoten).
Entwickeln von U-SQL-Datenbankobjekten mithilfe eines Datenbankprojekts
Klicken Sie mit der rechten Maustaste auf das U-SQL-Datenbankprojekt. Klicken Sie anschließend auf Hinzufügen > Neues Element. Sie finden alle neuen unterstützten Objekttypen im Assistenten Neues Element hinzufügen.
Für ein Nicht-Assemblyobjekt (etwa eine Tabellenwertfunktion) wird nach dem Hinzufügen eines neuen Elements ein neues U-SQL-Skript erstellt. Dann können Sie die DDL-Anweisung für das Objekt im Editor entwickeln.
Für ein Assemblyobjekt stellt das Tool einen benutzerfreundlichen Benutzeroberflächen-Editor bereit, mit dem Sie die Assembly registrieren und DLL-Dateien und andere Dateien bereitstellen können. Die folgenden Schritte veranschaulichen, wie Sie dem U-SQL-Datenbankprojekt eine Assemblyobjektdefinition hinzufügen:
Fügen Sie Verweise zum C#-Projekt hinzu, die UDO/UDAG/UDF für das U-SQL-Datenbankprojekt enthalten.
Wählen Sie in der Entwurfsansicht der Assembly im Dropdownmenü Assembly aus Verweis erstellen die referenzierte Assembly aus.
Fügen Sie verwaltete Abhängigkeiten und zusätzliche Dateien hinzu, sofern vorhanden. Beim Hinzufügen zusätzlicher Dateien verwendet das Tool den relativen Pfad, um sicherzustellen, dass die Assemblys später auf Ihrem lokalen Computer und dem Buildcomputer gefunden werden.
@_DeployTempDirectory ist eine vordefinierte Variable, die das Tool auf den Buildausgabeordner verweist. Im Buildausgabeordner verfügt jede Assembly über einen Unterordner, der den gleichen Namen wie die Assembly besitzt. Alle DLLs und zusätzlichen Dateien befinden sich in diesem Unterordner.
Erstellen eines U-SQL-Datenbankprojekts
Die Buildausgabe für ein U-SQL-Datenbankprojekt ist ein U-SQL-Datenbankbereitstellungspaket, das mit dem Suffix .usqldbpack benannt ist. Das Paket .usqldbpack ist eine ZIP-Datei und enthält alle DDL-Anweisungen in einem einzelnen U-SQL-Skript im Ordner DDL sowie alle DLLs und zusätzlichen Dateien für Assemblys im Ordner Temp.
Erfahren Sie mehr über das Erstellen eines U-SQL-Datenbankprojekts mit der MSBuild-Befehlszeile und einer Azure DevOps Services-Buildaufgabe.
Bereitstellen einer U-SQL-Datenbank
Das Paket vom Typ „.usqldbpack“ kann mit Visual Studio oder dem Bereitstellungs-SDK in einem lokalen Konto oder in einem Azure Data Lake Analytics-Konto bereitgestellt werden.
Bereitstellen einer U-SQL-Datenbank in Visual Studio
Sie können eine U-SQL-Datenbank über ein U-SQL-Datenbankprojekt oder ein .usqldbpack-Paket in Visual Studio bereitstellen.
Bereitstellen über ein U-SQL-Datenbankprojekt
Klicken Sie mit der rechten Maustaste auf das U-SQL-Datenbankprojekt, und wählen Sie dann Bereitstellen aus.
Wählen Sie im Assistenten U-SQL-Datenbank bereitstellen das ADLA-Konto aus, in dem Sie die Datenbank bereitstellen möchten. Sowohl lokale Konten als auch ADLA-Konten werden unterstützt.
Datenbankquelle wird automatisch ausgefüllt und verweist auf das Paket vom Typ „.usqldbpack“ im Buildausgabeordner des Projekts.
Geben Sie unter Datenbankname einen Namen ein, um eine Datenbank zu erstellen. Wenn bereits eine Datenbank mit demselben Namen im Azure Data Lake Analytics-Zielkonto vorhanden ist, werden alle im Datenbankprojekt definierten Objekte erstellt, ohne dass die Datenbank neu erstellt wird.
Klicken Sie auf Senden, um die U-SQL-Datenbank bereitzustellen. Alle Ressourcen (Assemblys und zusätzliche Dateien) werden hochgeladen, und ein U-SQL-Auftrag mit allen gesendeten DDL-Anweisungen wird gesendet.
Bereitstellen über ein U-SQL-Datenbankbereitstellungspaket
Öffnen Sie Server-Explorer. Erweitern Sie anschließend das Azure Data Lake Analytics-Konto, in dem Sie die Datenbank bereitstellen möchten.
Klicken Sie mit der rechten Maustaste auf U-SQL-Datenbanken, oder halten Sie sie gedrückt, und wählen Sie dann Datenbank bereitstellen aus.
Legen Sie Datenbankquelle auf den Pfad des U-SQL-Datenbankbereitstellungspakets (.usqldbpack-Datei) fest.
Geben Sie unter Datenbankname den Namen ein, um eine Datenbank zu erstellen. Wenn es eine Datenbank mit demselben Namen gibt, die bereits im Azure Data Lake Analytics-Zielkonto vorhanden ist, werden alle objekte, die im Datenbankprojekt definiert sind, erstellt, ohne die Datenbank neu zu erstellen.
Bereitstellen einer U-SQL-Datenbank mit dem SDK
PackageDeploymentTool.exe enthält die Programmier- und Befehlszeilenschnittstellen, über die U-SQL-Datenbanken bereitgestellt werden können. Das SDK ist im NuGet-Paket U-SQL SDK enthalten, das sich unter build/runtime/PackageDeploymentTool.exebefindet.
Verweisen auf ein U-SQL-Datenbankprojekt
Ein U-SQL-Projekt kann auf ein U-SQL-Datenbankprojekt verweisen. Der Verweis wirkt sich auf zwei Workloads aus:
- Projekterstellung: Richten Sie die Umgebungen für die referenzierten Datenbanken vor dem Erstellen der U-SQL-Skripts ein.
- Lokale Ausführung im Konto „(Local-project)“: Die referenzierten Datenbankumgebungen werden vor dem Erstellen der U-SQL-Skripts im Konto „(Local-project)“ bereitgestellt. Hier erfahren Sie mehr über die lokale Ausführung und den Unterschied zwischen dem Konto „(Local-machine)“ und dem Konto „(Local-project)“.
So fügen Sie einen U-SQL-Datenbankverweis hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das U-SQL-Projekt, und wählen Sie U-SQL-Datenbankverweis hinzufügen aus.
Konfigurieren Sie den Datenbankverweis aus einem U-SQL-Datenbankprojekt in der aktuellen Projektmappe oder einer U-SQL-Datenbankpaketdatei.
Geben Sie den Namen für die Datenbank an.
