Osvědčené postupy pro správu sestavení U-SQL v kanálu CI/CD

  • Článek
  • 3 min ke čtení

V tomto článku se dozvíte, jak spravovat zdrojový kód sestavení U-SQL pomocí nově zavedeného databázového projektu U-SQL. Naučíte se také, jak nastavit kanál průběžné integrace a nasazování (CI/CD) pro registraci sestavení pomocí Azure DevOps.

Použití databázového projektu U-SQL ke správě zdrojového kódu sestavení

Projekt databáze u-SQL je typ projektu v aplikaci Visual Studio, který pomáhá vývojářům rychle a snadno vyvíjet, spravovat a nasazovat databáze u-SQL. U databázového projektu U-SQL můžete spravovat všechny objekty databáze U-SQL (kromě přihlašovacích údajů).

Pro správu zdrojového kódu sestavení C# a skriptů DDL U-SQL registrace sestavení použijte:

  • Projekt databáze u-SQL pro správu registrace sestavení skripty U-SQL.
  • Knihovna tříd (pro aplikaci U-SQL) pro správu zdrojového kódu a závislostí v jazyce C# pro uživatelsky definované operátory, funkce a agregátory (Udo, UDF a UDAGs).
  • Projekt databáze U-SQL pro odkazování na projekt knihovny tříd.

Projekt databáze U-SQL může odkazovat na knihovnu tříd (pro aplikaci U-SQL). Sestavení registrovaná v databázi U-SQL můžete vytvořit pomocí odkazovaného zdrojového kódu C# z této knihovny tříd (pro aplikace U-SQL).

Pomocí těchto kroků můžete vytvořit projekty a přidat odkazy.

  1. Vytvořte projekt knihovny tříd (pro aplikaci u-SQL) tak, že vyberete soubor > Nový > projekt. Projekt je pod uzlem Azure Data Lake > U-SQL .

    Data Lake Tools for Visual Studio – vytvoření projektu knihovny tříd C#

  2. Přidejte uživatelem definovaný kód C# do knihovny tříd (pro aplikaci U-SQL).

  3. Vytvořte projekt U-SQL tak, že vyberete soubor > Nový > projekt. Projekt je pod uzlem Azure Data Lake > U-SQL .

    Data Lake Tools for Visual Studio – vytvoření databázového projektu U-SQL

  4. Přidejte odkaz na projekt knihovny tříd jazyka C# pro projekt databáze U-SQL.

    Data Lake Tools for Visual Studio – přidat odkaz

    Data Lake Tools for Visual Studio – přidat odkaz na projekt databáze U-SQL

  5. Vytvořte skript sestavení v projektu databáze U-SQL tak, že kliknete pravým tlačítkem na projekt a vyberete Přidat novou položku.

    Data Lake Tools for Visual Studio – přidání skriptu sestavení

  6. Otevřete skript sestavení v zobrazení návrhu sestavení. Vyberte odkazované sestavení z rozevírací nabídky vytvořit sestavení z odkazu .

    Data Lake Tools for Visual Studio – vytvoření sestavení z reference

  7. Přidejte spravované závislosti a Další soubory, pokud existují. Když přidáte další soubory, nástroj použije relativní cestu k tomu, aby bylo zajištěno, že bude moci najít sestavení v místním počítači a v počítači sestavení později.

@ _DeployTempDirectory v okně editoru v dolní části je předdefinovaná proměnná, která tento nástroj odkazuje na výstupní složku sestavení. V rámci výstupní složky sestavení má každé sestavení podsložku s názvem sestavení. Všechny knihovny DLL a další soubory jsou v této podsložce.

Vytvoření databázového projektu U-SQL

Výstup sestavení pro projekt databáze U-SQL je balíček pro nasazení U-SQL Database. Má název s příponou .usqldbpack . .usqldbpackBalíček je soubor. zip, který obsahuje všechny příkazy DDL v jednom skriptu U-SQL ve složce DDL. Všechny sestavené soubory DLL a další soubory pro sestavení jsou v dočasné složce.

Nasazení databáze U-SQL

.usqldbpackBalíček se dá nasadit buď do místního účtu, nebo do účtu Azure Data Lake Analytics. Použijte sadu Visual Studio nebo sadu SDK nasazení.

Nasazení databáze U-SQL v aplikaci Visual Studio

Databázi U-SQL můžete nasadit pomocí databázového projektu U-SQL nebo .usqldbpack balíčku v aplikaci Visual Studio.

Nasazení pomocí databázového projektu U-SQL

  1. Klikněte pravým tlačítkem na projekt databáze U-SQL a pak vyberte nasadit.

  2. V průvodci nasazením U-SQL Database vyberte účet ADLA , do kterého chcete nasadit databázi. Podporují se místní účty i účty ADLA.

  3. Zdroj databáze se vyplní automaticky. Odkazuje na balíček. usqldbpack ve výstupní složce sestavení projektu.

  4. Chcete-li vytvořit databázi, zadejte název v názvu databáze . Pokud databáze s tímto názvem již v cílovém Azure Data Lake Analytics účtu existuje, jsou všechny objekty, které jsou definovány v projektu databáze, vytvořeny bez opětovného vytvoření databáze.

  5. Chcete-li nasadit databázi U-SQL, vyberte Odeslat. Budou nahrány všechny prostředky, jako jsou sestavení a další soubory. Úloha U-SQL, která zahrnuje všechny příkazy DDL, je odeslána.

    Data Lake Tools for Visual Studio – nasazení databázového projektu U-SQL

    Data Lake Tools for Visual Studio – Průvodce nasazením databázového projektu U-SQL

Nasazení databáze U-SQL v Azure DevOps

PackageDeploymentTool.exe poskytuje rozhraní pro programování a příkazový řádek, která usnadňují nasazení databází U-SQL. Sada SDK je součástí balíčku NuGet U-SQL SDK, který se nachází na adrese build/runtime/PackageDeploymentTool.exe .

V Azure DevOps můžete k nastavení kanálu automatizace pro obnovení databáze U-SQL použít úlohu příkazového řádku a tuto sadu SDK. Přečtěte si další informace o sadě SDK a o tom, jak vytvořit kanál CI/CD pro nasazení databáze U-SQL.

Další kroky