使用 U-SQL 資料庫專案開發 Azure Data Lake 的 U-SQL 資料庫

發行項
12/20/2023

重要

Azure Data Lake Analytics 於 2024 年 2 月 29 日淘汰。使用此公告深入瞭解。

針對數據分析，您的組織可以使用 Azure Synapse Analytics 或 Microsoft Fabric。

U-SQL 資料庫會提供結構化的檢視，以便在資料表中檢視非結構化的資料和受控的結構化資料。也會提供一般的中繼資料目錄系統來組織結構化資料和自訂程式碼。資料庫是將這些相關物件編排在一起的概念。

U-SQL 資料庫專案是 Visual Studio 中的專案類型，能協助開發人員快速而輕鬆地開發、管理及部署 U-SQL 資料庫。

建立 U-SQL 資料庫專案

Azure Data Lake Tools for Visual Studio 在 2.3.3000.0 之後的版本中，新增了稱為 U-SQL 資料庫專案的專案範本。若要建立 U-SQL 專案，請選取 [檔案] > [新增] > [專案]。您可以在 [Azure Data Lake] > [U-SQL 節點] 下找到 U-SQL 資料庫專案。

Data Lake Tools for Visual Studio--建立 U-SQL 資料庫專案

使用資料庫專案開發 U-SQL 資料庫物件

以滑鼠右鍵按一下 U-SQL 資料庫專案。選取 [新增] > [新增項目]。您可以在 [新增項目] 精靈中找到所有新的可支援物件類型。

至於非組件物件 (例如資料表值函式)，新的 U-SQL 指令碼會在新項目新增後建立。您可以開始在編輯器中開發該物件的 DDL 陳述式。

針對元件物件，此工具提供方便使用的UI編輯器，可協助您註冊元件，並部署 DLL 檔案和其他檔案。以下步驟會說明如何將組件物件定義新增到 U-SQL 資料庫專案：

新增 C# 專案的參考，其中包含 U-SQL 資料庫專案的 UDO/UDAG/UDF。
在組件設計檢視中，從 [從參考建立組件] 下拉式功能表中選擇參考組件。
新增 [受控相依性] 和 [其他檔案] (若有的話)。在新增其他檔案時，工具會使用相對路徑來確保能在本機電腦和稍後的組建電腦上找到組件。

@_DeployTempDirectory 是預先定義的變數，能將工具指向建置輸出資料夾。在建置輸出資料夾中，每個組件都具有以組件名稱命名的子資料夾。所有 Dll 和其他檔案都在該子資料夾中。

建置 U-SQL 資料庫專案

U-SQL 資料庫專案的建置輸出，是一個名稱加上 .usqldbpack 尾碼的 U-SQL 資料庫部署套件。 .usqldbpack 套件是一個 ZIP 檔案，其中的 DDL 資料夾含有單一 U-SQL 指令碼中的所有 DDL 陳述式，而 Temp 資料夾則含有組件的所有 DLL 和額外檔案。

深入了解如何使用 MSBuild 命令列和Azure DevOps Service 建置工作來建置 U-SQL 資料庫專案。

部署 U-SQL 資料庫

您可以使用 Visual Studio 或部署 SDK，將 .usqldbpack 套件部署到本機帳戶或 Azure Data Lake Analytics 帳戶。

在 Visual Studio 中部署 U-SQL 資料庫

您可以在 Visual Studio 中透過 U-SQL 資料庫專案或 .usqldbpack 套件部署 U-SQL 資料庫。

透過 U-SQL 資料庫專案部署

以滑鼠右鍵按一下 U-SQL 資料庫專案，然後選取 [部署]。
在 [部署 U-SQL 資料庫精靈] 中，選擇要部署資料庫的目的地 [ADLA 帳戶]。本機帳戶和 ADLA 帳戶兩者均可支援。
[資料庫來源] 會自動填入，並指向專案建置輸出資料夾中的 .usqldbpack 套件。
在 [資料庫名稱] 中輸入名稱，以建立資料庫。如果目標 Azure Data Lake Analytics 帳戶已有相同名稱的資料庫，在資料庫專案中定義的所有物件均會建立，但不會重新建立資料庫。
若要部署 U-SQL 資料庫，請按一下 [提交]。所有資源 (組件和其他檔案) 隨即會上傳，而且包含所有 DDL 陳述式的 U-SQL 作業也會提交。

透過 U-SQL 資料庫部署套件部署

開啟 [伺服器總管]。然後展開要部署資料庫的目的地 Azure Data Lake Analytics 帳戶。
以滑鼠右鍵按住 U-SQL Database，然後選擇 [ 部署資料庫]。
將 [資料庫來源] 設定為 U-SQL 資料庫部署套件 (.usqldbpack file) 路徑。
輸入資料庫名稱，以建立資料庫。如果目標 Azure Data Lake Analytics 帳戶中已有同名的資料庫，則會建立資料庫專案中定義的所有物件，而不需要重新建立資料庫。

使用 SDK 部署 U-SQL 資料庫

PackageDeploymentTool.exe 提供程式設計和命令列介面，協助您部署 U-SQL 資料庫。 SDK 包含在位於的 U-SQL SDK NuGet 套件build/runtime/PackageDeploymentTool.exe中。

深入了解 SDK，以及如何為 U-SQL 資料庫部署設定 CI/CD 管線。

參考 U-SQL 資料庫專案

U-SQL 專案可以參考 U-SQL 資料庫專案。參考會影響兩種工作負載：

專案建置：在編譯 U-SQL 指令碼之前設定參考資料庫環境。
以 (Local-project) 帳戶進行本機執行：參考資料庫環境會在 U-SQL 指令碼執行之前部署到 (Local-project) 帳戶。在這裡可深入了解本機執行及 (Local-machine) 和 (Local-project) 帳戶之間的差異。

如何新增 U-SQL 資料庫參考

在 [方案總管] 中以滑鼠右鍵按一下 U-SQL 專案，然後選擇 [新增 U-SQL 資料庫參考...]。
從目前的解決方案中的 U-SQL 資料庫專案或 U-SQL 資料庫套件檔案中設定資料庫參考。
提供資料庫的名稱。

共用方式為