Iniziare a usare gli strumenti di database elasticoGet started with Elastic Database Tools

Questo documento presenta l'esperienza di sviluppo per la libreria client del database elastico tramite l'esecuzione dell'app di esempio.This document introduces you to the developer experience for the elastic database client library by helping you run a sample app. Nell'esempio viene creata una semplice applicazione partizionata e si esplorano le funzionalità chiave degli strumenti di database elastico del database SQL di Microsoft Azure.The sample app creates a simple sharded application and explores key capabilities of the Elastic Database Tools feature of Azure SQL Database. L'applicazione è incentrata sui casi d'uso per la gestione delle mappe delle partizioni, il routing dipendente dai dati e l'esecuzione di query su più partizioni.It focuses on use cases for shard map management, data-dependent routing, and multi-shard querying. La libreria client è disponibile su .NET e Java.The client library is available for .NET as well as Java.

Strumenti di database elastico per JavaElastic Database Tools for Java

prerequisitiPrerequisites

  • Java Developer Kit (JDK) versione 1.8 o successivaA Java Developer Kit (JDK), version 1.8 or later
  • MavenMaven
  • Un server logico in Azure o in un'istanza di SQL Server localeA logical server in Azure or a local SQL Server instance

Scaricare ed eseguire l'app di esempioDownload and run the sample app

Per compilare i file JAR e iniziare a usare il progetto di esempio, eseguire i passaggi seguenti:To build the JAR files and get started with the sample project, do the following:

  1. Clonare il repository GitHub che contiene la libreria client e l'app di esempio.Clone the GitHub repository containing the client library, along with the sample app.

  2. Modificare il file ./sample/src/main/resources/resource.properties nel modo seguente: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. Per compilare il progetto di esempio, eseguire il comando seguente nella directory ./sample:To build the sample project, in the ./sample directory, run the following command:

    mvn install
    
  4. Per avviare il progetto di esempio, eseguire il comando seguente nella directory ./sample: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. Provare a usare le varie opzioni per scoprire di più sulle funzionalità della libreria client.To learn more about the client library capabilities, experiment with the various options. È possibile esplorare il codice per avere informazioni sull'implementazione di app di esempio.Feel free to explore the code to learn about the sample app implementation.

    Progress-java

Congratulazioni!Congratulations! È stata creata ed eseguita la prima applicazione partizionata usando gli strumenti di database elastico nel database SQL di Microsoft Azure.You have successfully built and run your first sharded application by using Elastic Database Tools on Azure SQL Database. Usare Visual Studio o SQL Server Management Studio per connettersi al database SQL e osservare rapidamente le partizioni create dall'esempio.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. Si noteranno nuovi database con partizionamento e un database di gestione delle mappe con partizionamento creati dall'applicazione di esempio.You will notice new sample shard databases and a shard map manager database that the sample has created.

Per aggiungere la libreria client al progetto Maven, aggiungere la dipendenza seguente al file POM: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> 

Strumenti di database elastico per .NETElastic Database Tools for .NET

prerequisitiPrerequisites

Scaricare ed eseguire l'app di esempioDownload and run the sample app

Per installare la libreria, visitare Microsoft.Azure.SqlDatabase.ElasticScale.Client.To install the library, go to Microsoft.Azure.SqlDatabase.ElasticScale.Client. La libreria viene installata con l'app di esempio descritta nella sezione seguente.The library is installed with the sample app that's described in the following section.

Per scaricare ed eseguire l'applicazione di esempio, seguire questa procedura:To download and run the sample, follow these steps:

  1. Scaricare l'esempio Elastic DB Tools for Azure SQL - Getting Started (Strumenti di database elastici per SQL Azure - Guida introduttiva) da MSDN.Download the Elastic DB Tools for Azure SQL - Getting Started sample from MSDN. Decomprimere l'esempio nel percorso desiderato.Unzip the sample to a location that you choose.

  2. Per creare un progetto, aprire la soluzione ElasticScaleStarterKit.sln dalla directory C#.To create a project, open the ElasticScaleStarterKit.sln solution from the C# directory.

  3. Nella soluzione per l'esempio di progetto aprire il file app.config.In the solution for the sample project, open the app.config file. Seguire quindi le istruzioni nel file per aggiungere il nome del server del database SQL di Azure e le informazioni di accesso (nome utente e password).Then follow the instructions in the file to add your Azure SQL Database server name and your sign-in information (username and password).

  4. Compilare ed eseguire l'applicazione.Build and run the application. Quando viene richiesto, consentire a Visual Studio di ripristinare i pacchetti NuGet della soluzione.When you are prompted, enable Visual Studio to restore the NuGet packages of the solution. Viene scaricata la versione più recente della libreria client dei database elastici da NuGet.This action downloads the latest version of the elastic database client library from NuGet.

  5. Provare a usare le varie opzioni per scoprire di più sulle funzionalità della libreria client.To learn more about the client library capabilities, experiment with the various options. Annotare i passaggi eseguiti dall'applicazione nell'output della console ed esplorare liberamente il codice sottostante.Note the steps that the application takes in the console output, and feel free to explore the code behind the scenes.

    Avanzamento

Congratulazioni!Congratulations! È stata creata ed eseguita la prima applicazione partizionata usando gli strumenti di database elastico nel database SQL.You have successfully built and run your first sharded application by using Elastic Database Tools on SQL Database. Usare Visual Studio o SQL Server Management Studio per connettersi al database SQL e osservare rapidamente le partizioni create dall'esempio.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. Si noteranno nuovi database con partizionamento e un database di gestione delle mappe con partizionamento creati dall'applicazione di esempio.You will notice new sample shard databases and a shard map manager database that the sample has created.

Importante

È consigliabile usare sempre la versione più aggiornata di Management Studio per restare sincronizzati con gli aggiornamenti per Azure e per il database SQL.We recommend that you always use the latest version of Management Studio so that you stay synchronized with updates to Azure and SQL Database. Aggiornare SQL Server Management Studio.Update SQL Server Management Studio.

Elementi chiave dell'esempio di codiceKey pieces of the code sample

Altre operazioni di scalabilità elasticaOther elastic scale operations

CostiCost

La libreria di strumenti di database elastico è gratuita.The Elastic Database Tools library is free. L'uso di strumenti di database elastico non comporta costi aggiuntivi oltre a quelli applicati per l'uso di Azure.When you use Elastic Database Tools, you incur no additional charges beyond the cost of your Azure usage.

Quindi, nel caso dei nuovi database creati dall'applicazione di esempio,For example, the sample application creates new databases. il costo dipende dall'edizione del database SQL scelta e dall'uso di Azure da parte dell'applicazione.The cost of this capability depends on the SQL Database edition you choose and the Azure usage of your application.

Per informazioni sui prezzi, vedere Prezzi del database SQL.For pricing information, see SQL Database pricing details.

Passaggi successiviNext steps

Per altre informazioni sugli strumenti di database elastico, vedere gli articoli seguenti:For more information about Elastic Database Tools, see the following articles: