Kom igång med elastisk DatabasverktygGet started with Elastic Database Tools

Det här dokumentet ger en introduktion till utvecklare upplevelsen för den klientbibliotek för elastisk databas genom att du kör en exempelapp.This document introduces you to the developer experience for the elastic database client library by helping you run a sample app. Exempelappen skapar ett enkelt delat program och utforskar viktiga funktioner för funktionen elastisk Databasverktyg 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ändningsområden för Fragmentera kartan management, data beroende routning, och flera Fragmentera frågar.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. Klientbiblioteket är tillgänglig för .NET och Java.The client library is available for .NET as well as Java.

Elastisk Databasverktyg för JavaElastic Database Tools for Java

FörutsättningarPrerequisites

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

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

För att bygga JAR-filer och kom igång med exempelprojektet, gör du följande:To build the JAR files and get started with the sample project, do the following:

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

  2. Redigera den ./sample/src/main/resources/resource.properties fil 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. Att skapa exempelprojektet, i den . / exempel directory, kör du följande kommando:To build the sample project, in the ./sample directory, run the following command:

    mvn install
    
  4. Starta exempelprojektet, i den . / exempel directory, kör du följande kommando: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. Mer information om biblioteket klientfunktioner experimentera med olika alternativ.To learn more about the client library capabilities, experiment with the various options. Du kan utforska koden att lära dig om exempel app implementering.Feel free to explore the code to learn about the sample app implementation.

    Progress-java

Grattis!Congratulations! Du har skapat och köra ditt första delat program med elastiska Databasverktyg 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 SQL-databasen och ta en titt på shards som exemplet skapas.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 ser nya exempeldatabaserna Fragmentera och en Fragmentera kartan manager-databas som har skapats av exemplet.You will notice new sample shard databases and a shard map manager database that the sample has created.

Lägg till klientbiblioteket egna Maven-projekt genom att lägga till följande beroende på POM-filen: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> 

Elastisk Databasverktyg för .NETElastic Database Tools for .NET

FörutsättningarPrerequisites

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

Om du vill installera biblioteket, gå till Microsoft.Azure.SqlDatabase.ElasticScale.Client.To install the library, go to Microsoft.Azure.SqlDatabase.ElasticScale.Client. Biblioteket har installerats med exempelappen 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 den elastisk DB-verktyg för Azure SQL - komma igång exempel på 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, öppna den ElasticScaleStarterKit.sln lösningar från den C# directory.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

  3. Öppna i lösningen för exempelprojektet den app.config fil.In the solution for the sample project, open the app.config file. Följ sedan instruktionerna i filen för att lägga till din Azure SQL Database-servernamn och din inloggningsinformation (användarnamn och lösenord).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öra programmet.Build and run the application. När du uppmanas aktivera Visual Studio för att återställa NuGet-paket 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 klientbiblioteket för elastisk databas från NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Mer information om biblioteket klientfunktioner experimentera med olika alternativ.To learn more about the client library capabilities, experiment with the various options. Observera de steg som programmet tar i konsolen utdata och gärna att utforska koden i bakgrunden.Note the steps that the application takes in the console output, and feel free to explore the code behind the scenes.

    Förlopp

Grattis!Congratulations! Du har skapat och köra ditt första delat program med elastiska Databasverktyg på SQL-databas.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 SQL-databasen och ta en titt på shards som exemplet skapas.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 ser nya exempeldatabaserna Fragmentera och en Fragmentera kartan manager-databas som har skapats av exemplet.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 vara synkroniserat med uppdateringar till Azure och SQL-databas.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.

Nyckelinformation kodexempletKey pieces of the code sample

  • Hantera delar och Fragmentera: koden illustrerar hur du arbetar med shards, intervall och avbildningar i den ShardManagementUtils.cs fil.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 Fragmentera kartan manager.For more information, see Scale out databases with the shard map manager.

  • Data dependent routning: routning av transaktioner till rätt Fragmentera visas i den DataDependentRoutingSample.cs fil.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 delar: frågar över shards illustreras i den MultiShardQuerySample.cs fil.Querying over multiple shards: Querying across shards is illustrated in the MultiShardQuerySample.cs file. Mer information finns i flera Fragmentera frågar.For more information, see Multi-shard querying.

  • Lägga till tomma shards: iterativ tillägg av ny tom shards utförs av koden i den CreateShardSample.cs fil.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 Fragmentera kartan manager.For more information, see Scale out databases with the shard map manager.

Andra åtgärder elastisk skalbarhetOther elastic scale operations

KostnadCost

Elastisk Databasverktyg biblioteket är gratis.The Elastic Database Tools library is free. När du använder elastisk Databasverktyg innebära utan ytterligare kostnader utöver kostnaden för din användning av Azure.When you use Elastic Database Tools, you incur no additional charges beyond the cost of your Azure usage.

Till exempel skapas exempelprogrammet nya databaser.For example, the sample application creates new databases. Kostnaden för den här funktionen är beroende av SQL Database-utgåvan som 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 SQL-databas prisinformation.For pricing information, see SQL Database pricing details.

Nästa stegNext steps

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