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

U-SQL 資料庫提供非結構化數據和數據表中受控結構化數據的結構化檢視。 它也提供一般元數據目錄系統來組織結構化數據和自定義程序代碼。 資料庫是將這些相關物件群組在一起的概念。

深入瞭解 U-SQL 資料庫和資料定義語言 （DDL）。

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 Database 專案。

使用資料庫項目開發U-SQL 資料庫物件

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

針對非元件物件（例如數據表值函式），在您新增項目之後，就會建立新的U-SQL腳本。 您可以在編輯器中開始開發該物件的 DDL 語句。

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

1. 將包含 UDO/UDAG/UDF 的參考新增到 U-SQL 資料庫專案的 C# 專案中。

   

   

2. 在組裝設計檢視中，從 從參考建立組裝 下拉選單中選擇參考的元件。

   建立組件

3. 如果有的話，請新增 受控相依性 和 其他檔案。 當您新增其他檔案時，此工具會使用相對路徑，以確保它可以在本機計算機和組建計算機上稍後找到元件。

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

建置 U-SQL 資料庫專案

U-SQL 資料庫專案的建置輸出是 U-SQL 資料庫部署套件，其後綴為 .usqldbpack。 .usqldbpack 套件是一個 .zip 檔案，其中包含 DDL 資料夾中單一 U-SQL 腳本中的所有 DDL 語句，以及 Temp 資料夾中元件的所有 DLL 和其他檔案。

深入瞭解 如何使用 MSBuild 命令行和 Azure DevOps Services 建置工作建置 U-SQL 資料庫專案。

部署U-SQL 資料庫

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

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

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

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

1. 以滑鼠右鍵 U-SQL 資料庫專案，然後選取 [[部署]]。

2. 在 [部署 U-SQL Database 精靈]中，選取您要部署資料庫的 ADLA 帳戶。 支援本機使用者帳戶和 Azure Data Lake Analytics(ADLA) 帳戶。

3. 資料庫來源 會自動填入，並指向專案建置輸出資料夾中的 .usqldbpack 套件。

4. 在 [資料庫名稱] 中輸入名稱，以建立資料庫。 如果目標 Azure Data Lake Analytics 帳戶中已存在具有相同名稱的資料庫，則會建立資料庫專案中定義的所有物件，而不需要重新建立資料庫。

5. 若要部署 U-SQL 資料庫，請選擇 [提交]。 會上傳所有資源（元件和其他檔案），並提交包含所有 DDL 語句的 U-SQL 作業。

   

   

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

1. 開啟 伺服器總管。 然後展開要部署資料庫的 Azure Data Lake Analytics 帳戶。

2. 以滑鼠右鍵按兩下或按住 U-SQL Database，然後選擇 [部署資料庫]。

3. 將資料庫來源 設定為U-SQL資料庫部署套件 （.usqldbpack 檔案） 路徑。

4. 輸入 資料庫名稱 來建立資料庫。 如果目標 Azure Data Lake Analytics 帳戶中已有相同名稱的資料庫，則會建立資料庫專案中定義的所有物件，而不需要重新建立資料庫。

   

   

使用 SDK 部署 U-SQL 資料庫

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

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

參考U-SQL 資料庫專案

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

• Project 建置：在建置 U-SQL 腳本之前，先設定參考的資料庫環境。
• 在本機執行針對 (local-project) 帳戶的運行：在 U-SQL 腳本運行之前，參考的資料庫環境會部署到 (local-project) 帳戶。 在這裡了解本機執行與「local-machine」和「local-project」帳戶之間的差異。

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

1. 以滑鼠右鍵按兩下 [方案總管]中的 U-SQL 專案，然後選擇 [[新增 U-SQL Database 參考...]。

   

2. 在目前的方案或 U-SQL 資料庫封裝檔案中，配置 U-SQL 資料庫專案的資料庫參考。

3. 提供資料庫的名稱。

   

後續步驟

• 如何為 Azure Data Lake Analytics 設定 CI/CD 管線
• 如何測試 Azure Data Lake Analytics 程式代碼
• 在本機計算機上執行U-SQL腳本