Kom igång med Elastic Database Tools

  • Artikel

Gäller för:Azure SQL Database

Det här dokumentet beskriver utvecklarupplevelsen för klientbiblioteket för elastiska databaser genom att hjälpa dig att köra en exempelapp. Exempelappen skapar ett enkelt fragmenterat program och utforskar viktiga funktioner i funktionen Elastic Database Tools i Azure SQL Database. Den fokuserar på användningsfall för hantering av fragmentkartor, databeroende routning och frågor med flera fragment. Klientbiblioteket är tillgängligt för .NET och Java.

Elastic Database Tools för Java

Förutsättningar

  • Ett Java Developer Kit (JDK), version 1.8 eller senare
  • Maven
  • SQL Database eller en lokal SQL Server-instans

Ladda ned och kör exempelappen

Gör följande för att skapa JAR-filerna och komma igång med exempelprojektet:

  1. Klona GitHub-lagringsplatsen som innehåller klientbiblioteket, tillsammans med exempelappen.

  2. Redigera filen ./sample/src/main/resources/resource.properties för att ange följande:

    • TEST_CONN_USER
    • TEST_CONN_PASSWORD
    • TEST_CONN_SERVER_NAME

  3. Om du vill skapa exempelprojektet kör du följande kommando i katalogen ./sample :

    mvn install

  4. Starta exempelprojektet genom att köra följande kommando i katalogen ./sample :

    mvn -q exec:java "-Dexec.mainClass=com.microsoft.azure.elasticdb.samples.elasticscalestarterkit.Program"

  5. Om du vill veta mer om klientbiblioteksfunktionerna kan du experimentera med de olika alternativen. Utforska koden för att lära dig mer om implementeringen av exempelappen.

    Progress-java

Klar! Du har skapat och kört ditt första fragmenterade program med hjälp av Elastic Database Tools i Azure SQL Database. Använd Visual Studio eller SQL Server Management Studio för att ansluta till databasen och ta en snabb titt på de shards som exemplet skapade. Du kommer att märka nya shard-exempeldatabaser och en shard map manager-databas som exemplet har skapat.

Om du vill lägga till klientbiblioteket i ditt eget Maven-projekt lägger du till följande beroende i POM-filen:

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>elastic-db-tools</artifactId>
    <version>1.0.0</version>
</dependency>

Elastic Database Tools för .NET

Förutsättningar

Ladda ned och kör exempelappen

Om du vill installera biblioteket går du till Microsoft.Azure.SqlDatabase.ElasticScale.Client. Biblioteket installeras med exempelappen som beskrivs i följande avsnitt.

Följ dessa steg för att ladda ned och köra exemplet:

  1. Ladda ned exemplet Elastic DB Tools for Azure SQL – Komma igång. Packa upp exemplet till en plats som du väljer.

  2. Om du vill skapa ett projekt öppnar du ElasticDatabaseTools.sln-lösningen från katalogen elastic-db-tools-master .

  3. Ange Projektet ElasticScaleStarterKit som startprojekt.

  4. Öppna filen App.config i projektet ElasticScaleStarterKit. Följ sedan anvisningarna i filen för att lägga till servernamnet och inloggningsinformationen (användarnamn och lösenord).

  5. Skapa och kör programmet. När du uppmanas att göra det kan du aktivera Visual Studio för att återställa NuGet-paketen för lösningen. Den här åtgärden laddar ned den senaste versionen av klientbiblioteket för elastisk databas från NuGet.

  6. Om du vill veta mer om klientbiblioteksfunktionerna kan du experimentera med de olika alternativen. Observera de steg som programmet tar i konsolens utdata och utforska koden i bakgrunden.

    Progress

Klar! Du har skapat och kört ditt första fragmenterade program med hjälp av Elastic Database Tools i SQL Database. Använd Visual Studio eller SQL Server Management Studio för att ansluta till databasen och ta en snabb titt på de shards som exemplet skapade. Du kommer att märka nya shard-exempeldatabaser och en shard map manager-databas som exemplet har skapat.

Viktigt!

Vi rekommenderar att du alltid använder den senaste versionen av Management Studio så att du förblir synkroniserad med uppdateringar av Azure och SQL Database. Uppdatera SQL Server Management Studio.

Viktiga delar av kodexemplet

  • Hantera shards och shardkartor: Koden visar hur du arbetar med shards, intervall och mappningar i filen ShardManagementUtils.cs . Mer information finns i Skala ut databaser med shard map manager.

  • Databeroende routning: Routning av transaktioner till rätt shard visas i filen DataDependentRoutingSample.cs . Mer information finns i Databeroende routning.

  • Köra frågor mot flera shards: Frågor mellan shards illustreras i filen MultiShardQuerySample.cs . Mer information finns i Frågor med flera fragment.

  • Lägga till tomma shards: Iterativt tillägg av nya tomma shards utförs av koden i filen CreateShardSample.cs . Mer information finns i Skala ut databaser med shard map manager.

Andra elastiska skalningsåtgärder

Kostnad

Elastic Database Tools-biblioteket är kostnadsfritt. När du använder Elastic Database Tools debiteras du inga ytterligare avgifter utöver kostnaden för din Azure-användning.

Exempelprogrammet skapar till exempel nya databaser. Kostnaden för den här funktionen beror på vilken SQL Database-version du väljer och azure-användningen av ditt program.

Prisinformation finns i prisinformation för SQL Database.

Nästa steg

Mer information om Elastic Database Tools finns i följande artiklar: