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

Det här dokumentet ger en introduktion till utvecklarupplevelsen för den klientbibliotek för elastiska databaser genom att hjälpa 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 nyckelfunktioner av funktionen Verktyg för elastiska databaser 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 fragmentkarthantering, databeroende routning, och Multi-shard-frågor.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. Det finns klientbiblioteket för .NET och Java.The client library is available for .NET as well as Java.

Elastiska 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öra exempelappenDownload and run the sample app

Om du vill skapa JAR-filerna och kom igång med i exempelprojektet kan du göra 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 exempelappen.Clone the GitHub repository containing the client library, along with the sample app.

  2. Redigera den ./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. 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 i 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. Experimentera med de olika alternativen om du vill veta mer om funktionerna för klient-biblioteket.To learn more about the client library capabilities, experiment with the various options. Passa på att utforska kod som du vill veta mer om app-implementeringen av exemplet.Feel free to explore the code to learn about the sample app implementation.

    Progress-java

Grattis!Congratulations! Du har skapat och kör ditt första delat program med hjälp av verktyg för elastiska databaser 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 skapat exemplet.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 Exempeldatabaser shard och en databas som exemplet har skapats.You will notice new sample shard databases and a shard map manager database that the sample has created.

Lägg till klientbiblioteket till dina egna Maven-projekt genom att lägga till följande beroende i 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> 

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

FörutsättningarPrerequisites

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

Installera biblioteket genom att 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.

Hämta och kör exemplet genom att följa dessa steg:To download and run the sample, follow these steps:

  1. Ladda ned den elastiska DB-verktyg för Azure SQL - exemplet Getting Started 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, öppna den ElasticScaleStarterKit.sln lösning från den C# directory.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

  3. I lösningen för exempelprojektet, öppna 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ör 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 elastiska databaser från NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Experimentera med de olika alternativen om du vill veta mer om funktionerna för klient-biblioteket.To learn more about the client library capabilities, experiment with the various options. Observera de steg som programmet tar i konsolen utdata och passa på 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ör ditt första delat program med hjälp av verktyg för elastiska databaser i 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 din SQL-databas och ta en titt på shards som skapat exemplet.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 Exempeldatabaser shard och en databas som exemplet har skapats.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 alltid är synkroniserad med uppdateringar av 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.

Viktiga delar av kodexempletKey pieces of the code sample

  • Hantera shards och shard: koden visar hur du arbetar med fragment, 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 fragmentkartehanteraren.For more information, see Scale out databases with the shard map manager.

  • Databeroende routning: routning av transaktioner till rätt fragment 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 databeroende routning.For more information, see Data-dependent routing.

  • Fråga över flera shard: fråga ö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 Multi-shard-frågor.For more information, see Multi-shard querying.

  • Att lägga till tom shards: iterativ tillägg av nya tom fragmenten 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 fragmentkartehanteraren.For more information, see Scale out databases with the shard map manager.

Andra åtgärder med elastisk skalningOther elastic scale operations

KostnadCost

Elastiska Databasverktyg-biblioteket är gratis.The Elastic Database Tools library is free. När du använder Verktyg för elastiska databaser, medför 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.

Exempelprogrammet skapar till exempel nya databaser.For example, the sample application creates new databases. Kostnaden för den här funktionen är beroende av SQL Database-utgåva du väljer och Azure-användning 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 prisinformation.For pricing information, see SQL Database pricing details.

Nästa stegNext steps

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