開始使用彈性資料庫工具

適用于:Azure SQL資料庫

本文將協助您執行範例應用程式,以介紹彈性資料庫用戶端程式庫的開發人員體驗。 範例應用程式會建立簡易的分區化應用程式,並探討 Azure SQL Database 彈性資料庫工具功能的主要功能。 它著重在分區對應管理資料相依路由多分區查詢的使用案例。 用戶端程式庫可供 .NET 和 Java 取得。

適用於 Java 的彈性資料庫工具

先決條件

  • Java Developer Kit (JDK) 1.8 版或更新版本
  • Maven
  • SQL Database 或本機 SQL Server 執行個體

下載及執行範例應用程式

若要建置 JAR 檔案並開始使用範例專案,請執行下列步驟:

  1. 複製包含用戶端程式庫和範例應用程式的 GitHub 存放庫

  2. 編輯 ./sample/src/main/resources/resource.properties 檔案,以設定下列項目:

    • TEST_CONN_USER
    • TEST_CONN_PASSWORD
    • TEST_CONN_SERVER_NAME
  3. 若要建置範例專案,請在 ./sample 目錄中執行下列命令:

    mvn install
    
  4. 若要啟動範例專案,請在 ./sample 目錄中執行下列命令:

    mvn -q exec:java "-Dexec.mainClass=com.microsoft.azure.elasticdb.samples.elasticscalestarterkit.Program"
    
  5. 若要深入了解用戶端程式庫功能,請利用各種選項進行實驗。 請隨意探索程式碼,以了解範例應用程式的實作。

    進度 - Java

恭喜! 您已使用彈性資料庫工具,在 Azure SQL Database 上成功建置並執行您的第一個分區化應用程式。 請使用 Visual Studio 或 SQL Server Management Studio 連線至您的資料庫,並快速瀏覽範例建立的分區。 您會看見範例所建立的新範例分區資料庫和分區對應管理員資料庫。

若要將用戶端程式庫加入您自己的 Maven 專案中,請在您的 POM 檔案中加入下列相依性:

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>elastic-db-tools</artifactId>
    <version>1.0.0</version>
</dependency>

適用於 .NET 的彈性資料庫工具

先決條件

  • 含 C# 的 Visual Studio 2012 或更新版本。 請在 Visual Studio 下載上下載免費版本。
  • NuGet 2.7 或更新版本。 若要取得最新版本,請參閱安裝 NuGet

下載及執行範例應用程式

若要安裝程式庫,請移至 Microsoft.Azure.SqlDatabase.ElasticScale.Client。 程式庫是使用範例應用程式所安裝,如下一節所述。

若要下載及執行範例,請遵循下列步驟:

  1. 下載適用於 Azure SQL 的彈性 DB 工具 - 使用者入門範例。 將範例解壓縮至您選擇的位置。

  2. 若要建立專案,請從 elastic-db-tools-master 目錄開啟 ElasticDatabaseTools.sln 解決方案。

  3. ElasticScaleStarterKit 專案設為啟動專案。

  4. ElasticScaleStarterKit 專案中,開啟 [App.config] 檔案。 然後遵循檔案中的指示,新增您的伺服器名稱和登入資訊 (使用者名稱和密碼)。

  5. 建置並執行應用程式。 出現提示時,允許 Visual Studio 還原解決方案的 NuGet 套件。 此動作會從 NuGet 下載最新版的彈性資料庫用戶端程式庫。

  6. 若要深入了解用戶端程式庫功能,請利用各種選項進行實驗。 請記下應用程式在主控台輸出中採用的步驟,並盡情探索其後的程式碼。

    進度

恭喜! 您已使用彈性資料庫工具,在 SQL Database 上成功建置並執行您的第一個分區化應用程式。 請使用 Visual Studio 或 SQL Server Management Studio 連線至您的資料庫,並快速瀏覽範例建立的分區。 您會看見範例所建立的新範例分區資料庫和分區對應管理員資料庫。

重要

建議您一律使用最新版的 Management Studio,如此就能與 Azure 及 SQL Database 更新保持同步。 更新 SQL Server Management Studio

程式碼範例的主要部分

  • 管理分區和分區對應:此程式碼會解說如何使用 ShardManagementUtils.cs 檔案中的分區、範圍和對應。 如需詳細資訊,請參閱使用分區對應管理員相應放大資料庫

  • 資料相依路由DataDependentRoutingSample.cs 檔案中示範如何將交易路由傳送至正確的分區。 如需詳細資訊,請參閱資料相依路由

  • 查詢多個分區MultiShardQuerySample.cs 檔案中說明如何在各個分區間進行查詢。 如需詳細資訊,請參閱多分區查詢

  • 新增空的分區:反覆新增空分區的作業,是由 CreateShardSample.cs 檔案中的程式碼所執行。 如需詳細資訊,請參閱使用分區對應管理員相應放大資料庫

其他 Elastic Scale 作業

Cost

彈性資料庫工具程式庫是免費的。 當您使用彈性資料庫工具時,不會衍生除了您的 Azure 使用成本以外的任何額外費用。

例如,範例應用程式會建立新資料庫。 此容量的費用取決於您選擇的 SQL Database 版本,以及您應用程式的 Azure 使用量。

如需價格資訊,請參閱 SQL Database 定價詳細資料

下一步

如需有關彈性資料庫工具的詳細資訊,請參閱下列文章: