Aan de slag met elastische Databasehulpprogramma 'sGet started with Elastic Database Tools

Dit document bevat een inleiding tot de ervaring voor ontwikkelaars voor het clientbibliotheek voor elastic database doordat u een voorbeeld-app uitvoeren.This document introduces you to the developer experience for the elastic database client library by helping you run a sample app. De voorbeeld-app een eenvoudige sharded toepassing maakt en gaat in op de belangrijkste mogelijkheden van de functie Elastic Database-hulpprogramma's van 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. Dit artikel gaat over gebruiksvoorbeelden voor shard-Toewijzingsbeheer, gegevensafhankelijke routering, en meerdere shards uitvoeren van query's.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. De clientbibliotheek is beschikbaar voor zowel .NET als Java.The client library is available for .NET as well as Java.

Hulpprogramma's voor elastische databases voor JavaElastic Database Tools for Java

VereistenPrerequisites

  • Een Java Developer Kit (JDK), 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-exemplaarA SQL Database server in Azure or a local SQL Server instance

De voorbeeldapp downloaden en uitvoerenDownload and run the sample app

Voor het bouwen van de JAR-bestanden en aan de slag met het voorbeeldproject, het volgende doen:To build the JAR files and get started with the sample project, do the following:

  1. Kloon de GitHub-opslagplaats met de clientbibliotheek, samen met de voorbeeld-app.Clone the GitHub repository containing the client library, along with the sample app.

  2. Bewerk de ./sample/src/main/resources/resource.properties -bestand naar het volgende instellen: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. Het voorbeeldproject in bouwen de . / voorbeeld directory, voert u de volgende opdracht uit:To build the sample project, in the ./sample directory, run the following command:

    mvn install
    
  4. Om te beginnen het voorbeeldproject met de . / voorbeeld directory, voert u 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. Experimenteer met de verschillende opties voor meer informatie over de mogelijkheden voor de bibliotheek.To learn more about the client library capabilities, experiment with the various options. U kunt de code voor meer informatie over de voorbeeld-app-implementatie verkennen.Feel free to explore the code to learn about the sample app implementation.

    Progress-java

Gefeliciteerd!Congratulations! U hebt gemaakt en uitvoeren van uw eerste shard-toepassing met behulp van hulpprogramma's voor elastische databases 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 verbinding maken met uw SQL-database en een beknopt overzicht van de shards die het voorbeeld hebt 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 zult de nieuwe voorbeeld shard-databases en een shard map manager-database die het voorbeeld is gemaakt.You will notice new sample shard databases and a shard map manager database that the sample has created.

De clientbibliotheek toevoegen aan uw eigen Maven-project, toevoegen de volgende afhankelijkheden in het POM-bestand: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> 

Hulpprogramma's voor elastische databases voor .NETElastic Database Tools for .NET

VereistenPrerequisites

De voorbeeldapp downloaden en uitvoerenDownload and run the sample app

Voor het installeren van de bibliotheek, gaat u naar Microsoft.Azure.SqlDatabase.ElasticScale.Client.To install the library, go to Microsoft.Azure.SqlDatabase.ElasticScale.Client. De bibliotheek is geïnstalleerd met de voorbeeld-app die wordt beschreven in de volgende sectie.The library is installed with the sample app that's described in the following section.

Als u wilt downloaden en uitvoeren van het voorbeeld, de volgende stappen uit:To download and run the sample, follow these steps:

  1. Download de elastische DB-hulpprogramma's voor Azure SQL - aan de slag-voorbeeld van MSDN.Download the Elastic DB Tools for Azure SQL - Getting Started sample from MSDN. Pak deze uit het voorbeeld naar een locatie die u kiest.Unzip the sample to a location that you choose.

  2. Als u wilt een project maakt, opent u de ElasticScaleStarterKit.sln oplossing uit de C# directory.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

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

  4. Ontwikkel en voer de toepassing.Build and run the application. Wanneer u wordt gevraagd, zodat u Visual Studio de NuGet-pakketten van de oplossing te herstellen.When you are prompted, enable Visual Studio to restore the NuGet packages of the solution. Deze actie downloadt de nieuwste versie van de elastische database-clientbibliotheek vanuit NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Experimenteer met de verschillende opties voor meer informatie over de mogelijkheden voor de bibliotheek.To learn more about the client library capabilities, experiment with the various options. Houd er rekening mee de stappen die de toepassing in de console wordt uitgevoerd en u kunt de code achter de schermen worden besproken.Note the steps that the application takes in the console output, and feel free to explore the code behind the scenes.

    Wordt uitgevoerd

Gefeliciteerd!Congratulations! U hebt gemaakt en u hebt uw eerste shard-toepassing uitvoeren met behulp van hulpprogramma's voor elastische databases in 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 verbinding maken met uw SQL-database en een beknopt overzicht van de shards die het voorbeeld hebt 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 zult de nieuwe voorbeeld shard-databases en een shard map manager-database die het voorbeeld is gemaakt.You will notice new sample shard databases and a shard map manager database that the sample has created.

Belangrijk

Raden wij aan dat u altijd de meest recente versie van Management Studio zodat u gesynchroniseerd met updates voor Azure en SQL-Database blijven.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.

Belangrijke onderdelen van het codevoorbeeld vanKey pieces of the code sample

  • Beheer van shards en shard-kaarten: De code laat zien hoe u werkt met shards, bereiken en -toewijzingen in de 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 voor meer informatie, Scale-out databases met de shard-Toewijzingsbeheer.For more information, see Scale out databases with the shard map manager.

  • Gegevensafhankelijke routering: Routering van transacties naar de juiste shard wordt weergegeven in de DataDependentRoutingSample.cs bestand.Data-dependent routing: Routing of transactions to the right shard is shown in the DataDependentRoutingSample.cs file. Zie voor meer informatie, gegevensafhankelijke routering.For more information, see Data-dependent routing.

  • Uitvoeren van query's over meerdere shards: Het opvragen van meerdere shards wordt weergegeven in de MultiShardQuerySample.cs bestand.Querying over multiple shards: Querying across shards is illustrated in the MultiShardQuerySample.cs file. Zie voor meer informatie, meerdere shards uitvoeren van query's.For more information, see Multi-shard querying.

  • Lege shards toe te voegen: Het toevoegen van nieuwe lege shards iteratieve wordt uitgevoerd door de code in de CreateShardSample.cs bestand.Adding empty shards: The iterative adding of new empty shards is performed by the code in the CreateShardSample.cs file. Zie voor meer informatie, Scale-out databases met de shard-Toewijzingsbeheer.For more information, see Scale out databases with the shard map manager.

Andere bewerkingen elastisch schalenOther elastic scale operations

KostenCost

De hulpprogramma's voor elastische Database-bibliotheek is gratis.The Elastic Database Tools library is free. Wanneer u Elastic Database-hulpprogramma's gebruikt, worden er geen extra kosten berekend boven de kosten van uw gebruik van Azure.When you use Elastic Database Tools, you incur no additional charges beyond the cost of your Azure usage.

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

Zie voor informatie over de prijzen SQL-Database prijsinformatie.For pricing information, see SQL Database pricing details.

Volgende stappenNext steps

Zie de volgende artikelen voor meer informatie over hulpprogramma's voor elastische databases:For more information about Elastic Database Tools, see the following articles: