Kom igång med Elastic Database verktygGet started with Elastic Database Tools

I det här dokumentet får du en introduktion till utvecklaren för klient biblioteket för Elastic Database genom att hjälpa dig att köra en exempel App.This document introduces you to the developer experience for the elastic database client library by helping you run a sample app. Exempel appen skapar ett enkelt shardade-program och utforskar viktiga funktioner i Elastic Database tools-funktionen i Azure SQL Database.The sample app creates a simple sharded application and explores key capabilities of the Elastic Database Tools feature of Azure SQL Database. Den fokuserar på användnings fall för Shard Map Management, data beroende routningoch multi-Shard-frågor.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. Klient biblioteket är tillgängligt för .NET och Java.The client library is available for .NET as well as Java.

Elastic Database verktyg för JavaElastic Database Tools for Java

FörutsättningarPrerequisites

  • Java Developer Kit (JDK), version 1,8 eller senareA Java Developer Kit (JDK), version 1.8 or later
  • Maven 3.Maven
  • En SQL Database-Server i Azure eller en lokal SQL Server instansA SQL Database server in Azure or a local SQL Server instance

Hämta och kör exempel appenDownload and run the sample app

Gör följande för att skapa JAR-filerna och komma igång med exempelprojektet:To build the JAR files and get started with the sample project, do the following:

  1. Klona GitHub -lagringsplatsen som innehåller klient biblioteket, tillsammans med exempel appen.Clone the GitHub repository containing the client library, along with the sample app.

  2. Redigera ./Sample/src/main/Resources/Resource.Properties -filen för att ange följande:Edit the ./sample/src/main/resources/resource.properties file to set the following:

    • TEST_CONN_USERTEST_CONN_USER
    • TEST_CONN_PASSWORDTEST_CONN_PASSWORD
    • TEST_CONN_SERVER_NAMETEST_CONN_SERVER_NAME
  3. Om du vill skapa exempelprojektet i katalogen ./Sample kör du följande kommando:To build the sample project, in the ./sample directory, run the following command:

    mvn install
    
  4. Starta exempelprojektet genom att köra följande kommando i /Sample -katalogen:To start the sample project, in the ./sample directory, run the following command:

    mvn -q exec:java "-Dexec.mainClass=com.microsoft.azure.elasticdb.samples.elasticscalestarterkit.Program"
    
  5. Om du vill veta mer om klient biblioteks funktionerna kan du experimentera med de olika alternativen.To learn more about the client library capabilities, experiment with the various options. Titta gärna på koden för att lära dig mer om exempel på implementering av appen.Feel free to explore the code to learn about the sample app implementation.

    Progress-java

Grattis!Congratulations! Du har skapat och kört ditt första shardade-program genom att använda Elastic Database verktyg på Azure SQL Database.You have successfully built and run your first sharded application by using Elastic Database Tools on Azure SQL Database. Använd Visual Studio eller SQL Server Management Studio för att ansluta till din SQL-databas och ta en titt på Shards som exemplet skapade.Use Visual Studio or SQL Server Management Studio to connect to your SQL database and take a quick look at the shards that the sample created. Du kommer att märka nya exempel på Shard-databaser och en Shard Map Manager-databas som exemplet har skapat.You will notice new sample shard databases and a shard map manager database that the sample has created.

Om du vill lägga till klient biblioteket i ditt eget Maven-projekt lägger du till följande beroende i din POM-fil:To add the client library to your own Maven project, add the following dependency in your POM file:

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

Elastic Database verktyg för .NETElastic Database Tools for .NET

FörutsättningarPrerequisites

Hämta och kör exempel appenDownload and run the sample app

Om du vill installera biblioteket går du till Microsoft. Azure. SqlDatabase. ElasticScale. client.To install the library, go to Microsoft.Azure.SqlDatabase.ElasticScale.Client. Biblioteket installeras med exempel appen som beskrivs i följande avsnitt.The library is installed with the sample app that's described in the following section.

Följ dessa steg om du vill hämta och köra exemplet:To download and run the sample, follow these steps:

  1. Hämta de elastiska DB-verktygen för Azure SQL – komma igång exemplet från MSDN.Download the Elastic DB Tools for Azure SQL - Getting Started sample from MSDN. Packa upp exemplet på en plats som du väljer.Unzip the sample to a location that you choose.

  2. Om du vill skapa ett projekt öppnar du lösningen ElasticScaleStarterKit. SLN från C# katalogen.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

  3. Öppna filen app. config i lösningen för exempelprojektet.In the solution for the sample project, open the app.config file. Följ sedan anvisningarna i filen för att lägga till Azure SQL Database-servernamnet och inloggnings informationen (användar namn och lösen ord).Then follow the instructions in the file to add your Azure SQL Database server name and your sign-in information (username and password).

  4. Skapa och kör programmet.Build and run the application. När du uppmanas till det aktiverar du Visual Studio för att återställa NuGet-paketen för lösningen.When you are prompted, enable Visual Studio to restore the NuGet packages of the solution. Den här åtgärden hämtar den senaste versionen av klient biblioteket för Elastic Database från NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Om du vill veta mer om klient biblioteks funktionerna kan du experimentera med de olika alternativen.To learn more about the client library capabilities, experiment with the various options. Observera de steg som programmet tar i konsolens utdata och Känn dig kostnads fritt för att utforska koden bakom kulisserna.Note the steps that the application takes in the console output, and feel free to explore the code behind the scenes.

    Pågår

Grattis!Congratulations! Du har skapat och kört ditt första shardade-program genom att använda Elastic Database verktyg på SQL Database.You have successfully built and run your first sharded application by using Elastic Database Tools on SQL Database. Använd Visual Studio eller SQL Server Management Studio för att ansluta till din SQL-databas och ta en titt på Shards som exemplet skapade.Use Visual Studio or SQL Server Management Studio to connect to your SQL database and take a quick look at the shards that the sample created. Du kommer att märka nya exempel på Shard-databaser och en Shard Map Manager-databas som exemplet har skapat.You will notice new sample shard databases and a shard map manager database that the sample has created.

Viktigt

Vi rekommenderar att du alltid använder den senaste versionen av Management Studio så att du förblir synkroniserad med uppdateringar till Azure och SQL Database.We recommend that you always use the latest version of Management Studio so that you stay synchronized with updates to Azure and SQL Database. Uppdatera SQL Server Management Studio.Update SQL Server Management Studio.

Huvud delar av kod exempletKey pieces of the code sample

  • Hantera Shards-och Shard-kartor: Koden illustrerar hur du arbetar med Shards, intervall och mappningar i ShardManagementUtils.cs -filen.Managing shards and shard maps: The code illustrates how to work with shards, ranges, and mappings in the ShardManagementUtils.cs file. Mer information finns i skala ut databaser med Shard Map Manager.For more information, see Scale out databases with the shard map manager.

  • Data beroende routning: Routning av transaktioner till rätt Shard visas i DataDependentRoutingSample.cs -filen.Data-dependent routing: Routing of transactions to the right shard is shown in the DataDependentRoutingSample.cs file. Mer information finns i data beroende routning.For more information, see Data-dependent routing.

  • Fråga över flera Shards: Frågor över Shards illustreras i MultiShardQuerySample.cs -filen.Querying over multiple shards: Querying across shards is illustrated in the MultiShardQuerySample.cs file. Mer information finns i multi-Shard-frågor.For more information, see Multi-shard querying.

  • Lägger till Tom Shards: Upprepnings tillägg av ny tom Shards utförs av koden i CreateShardSample.cs -filen.Adding empty shards: The iterative adding of new empty shards is performed by the code in the CreateShardSample.cs file. Mer information finns i skala ut databaser med Shard Map Manager.For more information, see Scale out databases with the shard map manager.

Andra elastiska skalnings åtgärderOther elastic scale operations

KostnadCost

Elastic Database tools-biblioteket är kostnads fritt.The Elastic Database Tools library is free. När du använder Elastic Database verktyg debiteras du inga ytterligare avgifter utöver kostnaden för din Azure-användning.When you use Elastic Database Tools, you incur no additional charges beyond the cost of your Azure usage.

Exempel programmet skapar till exempel nya databaser.For example, the sample application creates new databases. Kostnaden för den här funktionen beror på vilken SQL Database-utgåva du väljer och Azure-användningen av ditt program.The cost of this capability depends on the SQL Database edition you choose and the Azure usage of your application.

Information om priser finns i SQL Database pris information.For pricing information, see SQL Database pricing details.

Nästa stegNext steps

Mer information om Elastic Database-verktyg finns i följande artiklar:For more information about Elastic Database Tools, see the following articles: