Bewährte Methoden zum Verwalten von U-SQL-Assemblys in einer CI/CD-Pipeline

2023-12-20

In diesem Artikel erfahren Sie, wie Sie den Quellcode der U-SQL-Assembly mit dem neu eingeführten U-SQL-Datenbankprojekt verwalten. Außerdem erfahren Sie, wie Sie eine kontinuierliche Integrations- und Bereitstellungspipeline (CI/CD) für die Assemblyregistrierung mithilfe von Azure DevOps einrichten.

Wichtig

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

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

Verwenden des U-SQL-Datenbankprojekts zum Verwalten von Assemblyquellcode

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. Sie können alle U-SQL-Datenbankobjekte (mit Ausnahme von Anmeldeinformationen) mit dem U-SQL-Datenbankprojekt verwalten.

Um den C#-Assemblyquellcode und die Assemblyregistrierung von DDL U-SQL-Skripts zu verwalten, verwenden Sie folgendes:

U-SQL-Datenbankprojekt zum Verwalten von U-SQL-Skripts für die Assemblyregistrierung.
Klassenbibliothek (Für U-SQL-Anwendung) zum Verwalten des C#-Quellcodes und der Abhängigkeiten für benutzerdefinierte Operatoren, Funktionen und Aggregatoren (UDOs, UDFs und UDAGs).
U-SQL-Datenbankprojekt, um auf das Klassenbibliotheksprojekt zu verweisen.

Ein U-SQL-Datenbankprojekt kann auf ein Klassenbibliotheksprojekt (für U-SQL-Anwendung) verweisen. Sie können Assemblys erstellen, die in der U-SQL-Datenbank registriert sind, indem Sie auf den C#-Quellcode aus diesem Klassenbibliotheksprojekt (für die U-SQL-Anwendung) verweisen.

Führen Sie die folgenden Schritte aus, um Projekte zu erstellen und Verweise hinzuzufügen.

Erstellen Sie ein Klassenbibliotheksprojekt (für U-SQL-Anwendung), indem Sie Datei>Neu>Projekt auswählen. Das Projekt befindet sich unter dem Azure Data Lake > U-SQL-Knoten .
Fügen Sie Ihren benutzerdefinierten C#-Code im Projekt "Klassenbibliothek( Für U-SQL-Anwendung)" hinzu.
Erstellen Sie ein U-SQL-Projekt, indem Sie "Datei>Neu>Projekt" auswählen. Das Projekt befindet sich unter dem Azure Data Lake>U-SQL-Knoten .
Fügen Sie einen Verweis auf das C#-Klassenbibliotheksprojekt für das U-SQL-Datenbankprojekt hinzu.
Erstellen Sie ein Assemblyskript im U-SQL-Datenbankprojekt, indem Sie mit der rechten Maustaste auf das Projekt klicken und " Neues Element hinzufügen" auswählen.
Öffnen Sie das Assemblyskript in der Assemblyentwurfsansicht. Wählen Sie die referenzierte Assembly aus dem Dropdown-Menü "Zusammenstellung aus Referenz erstellen" aus.
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 auf Ihrem lokalen Computer und später auf dem Buildcomputer finden kann.

@_DeployTempDirectory im Editorfenster unten ist eine vordefinierte Variable, die das Tool auf den Buildausgabeordner zeigt. 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. Es wird mit dem Suffix .usqldbpackbenannt. Das .usqldbpack Paket ist eine .zip Datei, die alle DDL-Anweisungen in einem einzelnen U-SQL-Skript im DDL-Ordner enthält. Alle erstellten .dll Dateien und zusätzliche Dateien für Assemblys befinden sich im Ordner "Temp".

Bereitstellen einer U-SQL-Datenbank

Das .usqldbpack Paket kann entweder für ein lokales Konto oder ein Azure Data Lake Analytics-Konto bereitgestellt werden. Verwenden Sie Visual Studio oder das Bereitstellungs-SDK.

Bereitstellen einer U-SQL-Datenbank in Visual Studio

Sie können eine U-SQL-Datenbank mithilfe eines U-SQL-Datenbankprojekts oder eines .usqldbpack Pakets in Visual Studio bereitstellen.

Bereitstellen mithilfe eines U-SQL-Datenbankprojekts

Klicken Sie mit der rechten Maustaste auf das U-SQL-Datenbankprojekt, und wählen Sie dann Bereitstellenaus.
Wählen Sie im Assistenten für die Bereitstellung der U-SQL-Datenbank das ADLA-Konto aus, für das Sie die Datenbank bereitstellen möchten. Sowohl lokale Konten als auch ADLA-Konten werden unterstützt.
Datenbankquelle wird automatisch ausgefüllt. Er verweist auf das Usqldbpack-Paket im Buildausgabeordner des Projekts.
Geben Sie einen Namen in "Datenbankname" ein, um eine Datenbank zu erstellen. Wenn bereits eine Datenbank mit demselben Namen im Azure Data Lake Analytics-Zielkonto vorhanden ist, werden alle Objekte, die im Datenbankprojekt definiert sind, erstellt, ohne die Datenbank erneut zu erstellen.
Um die U-SQL-Datenbank bereitzustellen, wählen Sie Submitaus. Alle Ressourcen, z. B. Assemblys und zusätzliche Dateien, werden hochgeladen. Ein U-SQL-Auftrag, der alle DDL-Anweisungen enthält, wird übermittelt.

Bereitstellen einer U-SQL-Datenbank in Azure DevOps

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.

In Azure DevOps können Sie eine Befehlszeilenaufgabe und dieses SDK verwenden, um eine Automatisierungspipeline für die Aktualisierung der U-SQL-Datenbank einzurichten. Erfahren Sie mehr über das SDK und das Einrichten einer CI/CD-Pipeline für die Bereitstellung von U-SQL-Datenbanken.

Freigeben über