Komma igång med elastiska databasverktygGet started with Elastic Database Tools

Det här dokumentet introducerar dig till utvecklarupplevelsen för klientbiblioteket för elastiska databaser genom att hjälpa dig att köra 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 fragmenterat program och utforskar viktiga funktioner i funktionen Elastiska 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ändningsfall för fragmentkarthantering, databeroende routningoch frågar för flera fragment.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. Klientbiblioteket är tillgängligt för .NET samt Java.The client library is available for .NET as well as Java.

Elastiska databasverktyg för JavaElastic Database Tools for Java

KravPrerequisites

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

Ladda ned och kör exempelappenDownload and run the sample app

Så här skapar du JAR-filerna och kommer igång med exempelprojektet:To build the JAR files and get started with the sample project, do the following:

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

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

    mvn install
    
  4. Om du vill starta exempelprojektet kör du 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 klientbibliotekets funktioner kan du experimentera med de olika alternativen.To learn more about the client library capabilities, experiment with the various options. Känn dig fri att utforska koden för att lära sig mer om exempelappimplementeringen.Feel free to explore the code to learn about the sample app implementation.

    Framsteg-java

Grattis!Congratulations! Du har skapat och kört ditt första fragmenterade program med hjälp av elastiska databasverktyg i 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 snabb titt på de shards som exemplet har skapat.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 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 klientbiblioteket 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> 

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

KravPrerequisites

Ladda ned och kör exempelappenDownload 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 exempelappen som beskrivs i följande avsnitt.The library is installed with the sample app that's described in the following section.

Så här hämtar och kör du exemplet:To download and run the sample, follow these steps:

  1. Ladda ned exemplet Elastiska DB-verktyg för Azure SQL - Komma igång.Download the Elastic DB Tools for Azure SQL - Getting Started sample. 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 elasticscaleStarterKit.sln-lösningen 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 instruktionerna i filen för att lägga till servernamnet för Azure SQL Database 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 att aktivera 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 klientbiblioteket för elastisk databas från NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Om du vill veta mer om klientbibliotekets funktioner 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 konsolen utgång, och gärna 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.

    Förlopp

Grattis!Congratulations! Du har skapat och kört ditt första fragmenterade program med hjälp av elastiska databasverktyg i 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 snabb titt på de shards som exemplet har skapat.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 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.

Viktiga delar av kodexempletKey pieces of the code sample

  • Hantera shards och shard kartor: Koden illustrerar hur man 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 fragmentkarthanteraren.For more information, see Scale out databases with the shard map manager.

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

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

  • Lägga till tomma shards: Den iterativa tillägg av nya tomma 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 fragmentkarthanteraren.For more information, see Scale out databases with the shard map manager.

Andra elastiska skaloperationerOther elastic scale operations

KostnadCost

Biblioteket Med elastiska databasverktyg är gratis.The Elastic Database Tools library is free. När du använder elastiska databasverktyg ådra dig 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.

Exempelprogrammet skapar till exempel nya databaser.For example, the sample application creates new databases. Kostnaden för den här funktionen beror på den 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.

Prisinformation finns i prisinformation för SQL Database.For pricing information, see SQL Database pricing details.

Nästa stegNext steps

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