Verwenden eines U-SQL-Datenbankprojekts zum Entwickeln einer U-SQL-Datenbank für Azure Data Lake

Wichtig

Azure Data Lake Analytics wurde am 29. Februar 2024 eingestellt. Erfahren Sie mehr über in dieser Ankündigung.

Bei Datenanalysen kann Ihre Organisation Azure Synapse Analytics oder Microsoft Fabricverwenden.

Die U-SQL-Datenbank bietet strukturierte Ansichten über unstrukturierte Daten und verwaltete strukturierte Daten in Tabellen. Es stellt außerdem ein allgemeines Metadatenkatalogsystem zum Organisieren ihrer strukturierten Daten und benutzerdefinierten Code bereit. Die Datenbank ist das Konzept, das diese verwandten Objekte zusammen gruppiert.

Erfahren Sie mehr über die U-SQL-Datenbank und die Data Definition Language (DDL).

Das U-SQL-Datenbankprojekt ist ein Projekttyp in Visual Studio, der Entwicklern hilft, ihre U-SQL-Datenbanken schnell und einfach zu entwickeln, zu verwalten und bereitzustellen.

Erstellen eines U-SQL-Datenbankprojekts

Azure Data Lake Tools für Visual Studio hat nach Version 2.3.3000.0 eine neue Projektvorlage namens "U-SQL-Datenbankprojekt" hinzugefügt. Um ein U-SQL-Projekt zu erstellen, wählen Sie Datei > Neues > Projektaus. Das U-SQL-Datenbankprojekt finden Sie 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. Wählen Sie Hinzufügen > Neues Elementaus. Alle neuen unterstützten Objekttypen finden Sie im Assistenten Hinzufügen neuer Elemente.

Für ein Nichtassemblyobjekt (z. B. eine Tabellenwertfunktion) wird ein neues U-SQL-Skript erstellt, nachdem Sie ein neues Element hinzugefügt haben. Sie können mit der Entwicklung der DDL-Anweisung für dieses Objekt im Editor beginnen.

Für ein Assemblyobjekt bietet das Tool einen benutzerfreundlichen UI-Editor, mit dem Sie die Assembly registrieren und DLL-Dateien und andere Dateien bereitstellen können. Die folgenden Schritte zeigen, wie Sie dem U-SQL-Datenbankprojekt eine Assemblyobjektdefinition hinzufügen:

1. Fügen Sie Verweise auf das C#-Projekt hinzu, die die UDO/UDAG/UDF für das U-SQL-Datenbankprojekt enthalten.

   

   

2. Wählen Sie in der Konstruktionsansicht die referenzierte Baugruppe aus dem Dropdown-Menü 'Baugruppe aus Verweis erstellen' aus.

   

3. Fügen Sie Verwaltete Abhängigkeiten und Zusätzliche Dateien hinzu, falls vorhanden. Wenn Sie zusätzliche Dateien hinzufügen, verwendet das Tool den relativen Pfad, um sicherzustellen, dass es die Assemblys sowohl auf Ihrem lokalen Computer als auch auf dem Buildcomputer später finden kann.

@_DeployTempDirectory ist eine vordefinierte Variable, die das Tool auf den Buildausgabeordner verweist. Unter dem Build-Ausgabeordner hat jede Assembly einen Unterordner mit dem Assemblynamen. 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 .usqldbpackbenannt ist. Das .usqldbpack-Paket ist eine .zip Datei, die 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 enthält.

Erfahren Sie mehr über , wie Sie ein U-SQL-Datenbankprojekt mit der MSBuild-Befehlszeile und einer Azure DevOps Services-Buildaufgabeerstellen.

Bereitstellen einer U-SQL-Datenbank

Das Usqldbpack-Paket kann entweder in einem lokalen Konto oder einem Azure Data Lake Analytics-Konto mithilfe von Visual Studio oder dem Bereitstellungs-SDK 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

1. Klicken Sie mit der rechten Maustaste auf das U-SQL-Datenbankprojekt, und wählen Sie dann Bereitstellenaus.

2. Wählen Sie im Bereitstellen des U-SQL-Datenbank-Assistentendas ADLA-Konto aus, für das Sie die Datenbank bereitstellen möchten. Sowohl lokale Konten als auch ADLA-Konten werden unterstützt.

3. Datenbankquelle wird automatisch ausgefüllt und verweist auf das .usqldbpack-Paket im Buildausgabeordner des Projekts.

4. Geben Sie einen Namen in "Datenbankname" ein, um eine Datenbank zu erstellen. Wenn eine Datenbank mit demselben Namen bereits im Azure Data Lake Analytics-Zielkonto vorhanden ist, werden alle Objekte, die im Datenbankprojekt definiert sind, erstellt, ohne die Datenbank neu zu erstellen.

5. Um die U-SQL-Datenbank bereitzustellen, wählen Sie Submitaus. Alle Ressourcen (Assemblys und zusätzliche Dateien) werden hochgeladen, und ein U-SQL-Auftrag, der alle DDL-Anweisungen enthält, wird übermittelt.

   

   

Bereitstellen über ein U-SQL-Datenbankbereitstellungspaket

1. Öffnen Sie Server-Explorer. Erweitern Sie dann das Azure Data Lake Analytics-Konto, in dem Sie die Datenbank bereitstellen möchten.

2. Klicken Sie mit der rechten Maustaste, oder halten Sie U-SQL-Datenbankengedrückt, und wählen Sie dann Datenbank bereitstellenaus.

3. Legen Sie Datenbankquelle auf den U-SQL-Datenbankbereitstellungspaketpfad (Usqldbpack-Datei) fest.

4. Geben Sie den Datenbanknamen ein, um eine Datenbank zu erstellen. Wenn es eine Datenbank mit demselben Namen gibt, der 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 der U-SQL-Datenbank mithilfe des SDK

PackageDeploymentTool.exe stellt die Programmier- und Befehlszeilenschnittstellen bereit, die bei der Bereitstellung von U-SQL-Datenbanken helfen. Das SDK ist im U-SQL SDK NuGet-Paketenthalten, das sich unter build/runtime/PackageDeploymentTool.exebefindet.

Weitere Informationen zum SDK und zum Einrichten der CI/CD-Pipeline für die Bereitstellung von U-SQL-Datenbanken.

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:

• Project Build: Richten Sie die referenzierten Datenbankumgebungen ein, bevor Sie die U-SQL-Skripts erstellen.
• Lokale Ausführung mit einem (lokalen Projekt)-Konto: Die referenzierten Datenbankumgebungen werden vor der Ausführung des U-SQL-Skripts in einem Lokalen Projektkonto bereitgestellt. Erfahren Sie mehr über lokale Ausführungen und den Unterschied zwischen (dem lokalen Computer) und (einem lokalen Projekt)-Konto hier.

So fügen Sie einen U-SQL-Datenbankverweis hinzu

1. Klicken Sie mit der rechten Maustaste auf das U-SQL-Projekt im Projektmappen-Explorer, und wählen Sie dann U-SQL-Datenbankreferenz hinzufügen...aus.

   

2. Konfigurieren Sie einen Datenbankverweis aus einem U-SQL-Datenbankprojekt in der aktuellen Lösung oder in einer U-SQL-Datenbankpaketdatei.

3. Geben Sie den Namen für die Datenbank an.

   Hinzufügen von Datenbankprojektreferenz-Assistenten

Nächste Schritte

• Einrichten einer CI/CD-Pipeline für Azure Data Lake Analytics
• So testen Sie Ihren Azure Data Lake Analytics-Code
• Ausführen eines U-SQL-Skripts auf dem lokalen Computer