Aan de slag met Elastic Database-Hulpprogram Ma'sGet started with Elastic Database Tools

Dit document bevat een inleiding tot de ervaring voor ontwikkel aars voor de client bibliotheek voor Elastic data base door u te helpen een voor beeld-app uit te voeren.This document introduces you to the developer experience for the elastic database client library by helping you run a sample app. Met de voor beeld-app wordt een eenvoudige Shard-toepassing gemaakt en worden de belangrijkste functies van de functie Hulpprogram Ma's voor Elastic Database van Azure SQL Database verkend.The sample app creates a simple sharded application and explores key capabilities of the Elastic Database Tools feature of Azure SQL Database. Het richt zich op het gebruik van cases voor Shard-toewijzings beheer, gegevens afhankelijke route ringen query's met meerdere Shard.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. De client bibliotheek is beschikbaar voor .NET en in Java.The client library is available for .NET as well as Java.

Elastic Database-Hulpprogram Ma's voor JavaElastic Database Tools for Java

VereistenPrerequisites

  • Een JDK (Java Developer Kit), versie 1,8 of hogerA Java Developer Kit (JDK), version 1.8 or later
  • MavenMaven
  • Een SQL Database-Server in azure of een lokale SQL Server instantieA SQL Database server in Azure or a local SQL Server instance

De voor beeld-app downloaden en uitvoerenDownload and run the sample app

Ga als volgt te werk om de JAR-bestanden te maken en aan de slag te gaan met het voorbeeld project:To build the JAR files and get started with the sample project, do the following:

  1. Kloon de github-opslag plaats met de client bibliotheek, samen met de voor beeld-app.Clone the GitHub repository containing the client library, along with the sample app.

  2. Bewerk het ./sample/src/main/resources/resource.Properties -bestand om het volgende in te stellen: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. Als u het voorbeeld project wilt maken, voert u in de map ./sample de volgende opdracht uit:To build the sample project, in the ./sample directory, run the following command:

    mvn install
    
  4. Als u het voorbeeld project wilt starten, voert u in de map ./sample de volgende opdracht uit: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. Voor meer informatie over de mogelijkheden van de client bibliotheek kunt u experimenteren met de verschillende opties.To learn more about the client library capabilities, experiment with the various options. U kunt de code verkennen voor meer informatie over de implementatie van de voor beeld-app.Feel free to explore the code to learn about the sample app implementation.

    Voortgang-java

Gefeliciteerd.Congratulations! U hebt uw eerste Shard-toepassing gemaakt en uitgevoerd met behulp van Elastic Database-Hulpprogram Ma's op Azure SQL Database.You have successfully built and run your first sharded application by using Elastic Database Tools on Azure SQL Database. Gebruik Visual Studio of SQL Server Management Studio om verbinding te maken met uw SQL database en Bekijk een kort overzicht van de Shards waarin het voor beeld is gemaakt.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. U ziet nieuwe voor beelden van Shard-data bases en een Shard map Manager-Data Base die het voor beeld heeft gemaakt.You will notice new sample shard databases and a shard map manager database that the sample has created.

Voeg de volgende afhankelijkheden toe aan uw POM-bestand om de client bibliotheek toe te voegen aan uw eigen Maven-project: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-Hulpprogram Ma's voor .NETElastic Database Tools for .NET

VereistenPrerequisites

De voor beeld-app downloaden en uitvoerenDownload and run the sample app

Als u de bibliotheek wilt installeren, gaat u naar micro soft. Azure. SqlDatabase. ElasticScale. client.To install the library, go to Microsoft.Azure.SqlDatabase.ElasticScale.Client. De-bibliotheek wordt geïnstalleerd met de voor beeld-app die wordt beschreven in de volgende sectie.The library is installed with the sample app that's described in the following section.

Voer de volgende stappen uit om het voor beeld te downloaden en uit te voeren:To download and run the sample, follow these steps:

  1. Down load de elastische DB-Hulpprogram ma's voor het voor beeld van Azure SQL-aan de slag van MSDN.Download the Elastic DB Tools for Azure SQL - Getting Started sample from MSDN. Decomprimeer het voor beeld naar een locatie die u kiest.Unzip the sample to a location that you choose.

  2. Als u een project wilt maken, opent u de oplossing ElasticScaleStarterKit. SLN vanuit de C# Directory.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

  3. Open het bestand app. config in de oplossing voor het voorbeeld project.In the solution for the sample project, open the app.config file. Volg vervolgens de instructies in het bestand om de naam van uw Azure SQL Database-Server toe te voegen en uw aanmeldings gegevens (gebruikers naam en wacht woord).Then follow the instructions in the file to add your Azure SQL Database server name and your sign-in information (username and password).

  4. Bouw en voer de toepassing uit.Build and run the application. Wanneer u hierom wordt gevraagd, schakelt u Visual Studio in om de NuGet-pakketten van de oplossing te herstellen.When you are prompted, enable Visual Studio to restore the NuGet packages of the solution. Met deze actie wordt de meest recente versie van de client bibliotheek voor Elastic data base gedownload van NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Voor meer informatie over de mogelijkheden van de client bibliotheek kunt u experimenteren met de verschillende opties.To learn more about the client library capabilities, experiment with the various options. Let op de stappen die de toepassing uitvoert in de-console-uitvoer en u kunt de code op de achtergrond verkennen.Note the steps that the application takes in the console output, and feel free to explore the code behind the scenes.

    gang

Gefeliciteerd.Congratulations! U hebt uw eerste Shard-toepassing gemaakt en uitgevoerd met behulp van Elastic Database-Hulpprogram Ma's op SQL Database.You have successfully built and run your first sharded application by using Elastic Database Tools on SQL Database. Gebruik Visual Studio of SQL Server Management Studio om verbinding te maken met uw SQL database en Bekijk een kort overzicht van de Shards waarin het voor beeld is gemaakt.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. U ziet nieuwe voor beelden van Shard-data bases en een Shard map Manager-Data Base die het voor beeld heeft gemaakt.You will notice new sample shard databases and a shard map manager database that the sample has created.

Belangrijk

U wordt aangeraden altijd de nieuwste versie van Management Studio te gebruiken, zodat u gesynchroniseerd blijft met updates voor Azure en 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. SQL Server Management Studio bijwerken.Update SQL Server Management Studio.

Belangrijkste onderdelen van het code voorbeeldKey pieces of the code sample

  • Shards-en Shard-kaarten beheren: de code illustreert hoe u kunt werken met Shards, bereiken en toewijzingen in het ShardManagementUtils.cs -bestand.Managing shards and shard maps: The code illustrates how to work with shards, ranges, and mappings in the ShardManagementUtils.cs file. Zie data bases schalen met Shard-toewijzings beheervoor meer informatie.For more information, see Scale out databases with the shard map manager.

  • Gegevens afhankelijke route ring: route ring van trans acties naar de juiste Shard wordt weer gegeven in het DataDependentRoutingSample.cs -bestand.Data-dependent routing: Routing of transactions to the right shard is shown in the DataDependentRoutingSample.cs file. Zie gegevens afhankelijke route ringvoor meer informatie.For more information, see Data-dependent routing.

  • Query's uitvoeren via meerdere Shards: het uitvoeren van query's op Shards wordt ge├»llustreerd in het MultiShardQuerySample.cs -bestand.Querying over multiple shards: Querying across shards is illustrated in the MultiShardQuerySample.cs file. Zie multi-Shard query'svoor meer informatie.For more information, see Multi-shard querying.

  • Lege Shards toevoegen: het iteratieve toevoegen van nieuwe lege Shards wordt uitgevoerd door de code in het CreateShardSample.cs -bestand.Adding empty shards: The iterative adding of new empty shards is performed by the code in the CreateShardSample.cs file. Zie data bases schalen met Shard-toewijzings beheervoor meer informatie.For more information, see Scale out databases with the shard map manager.

Andere Elastic Scale-bewerkingenOther elastic scale operations

KostenCost

De bibliotheek met Elastic Database Hulpprogram Ma's is gratis.The Elastic Database Tools library is free. Wanneer u Elastic Database-Hulpprogram Ma's gebruikt, zijn er geen extra kosten in rekening gebracht dan de kosten van uw Azure-gebruik.When you use Elastic Database Tools, you incur no additional charges beyond the cost of your Azure usage.

De voorbeeld toepassing maakt bijvoorbeeld nieuwe data bases.For example, the sample application creates new databases. De kosten van deze mogelijkheid zijn afhankelijk van de SQL Database versie die u kiest en het Azure-gebruik van uw toepassing.The cost of this capability depends on the SQL Database edition you choose and the Azure usage of your application.

Zie SQL database prijsinformatie voor prijzen.For pricing information, see SQL Database pricing details.

Volgende stappenNext steps

Raadpleeg de volgende artikelen voor meer informatie over Elastic Database-Hulpprogram Ma's:For more information about Elastic Database Tools, see the following articles: