Dela via

Uppgradera en app för att använda det senaste klientbiblioteket för elastisk databas

  • Artikel

Gäller för:Azure SQL Database

Nya versioner av Elastic Database-klientbiblioteket är tillgängliga via NuGet och NuGet Package Manager-gränssnittet i Visual Studio. Uppgraderingar innehåller felkorrigeringar och stöd för nya funktioner i klientbiblioteket.

För den senaste versionen: Gå till Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Återskapa programmet med det nya biblioteket och ändra befintliga Shard Map Manager-metadata som lagras i dina databaser i Azure SQL Database för att stödja nya funktioner.

Genom att utföra de här stegen ser du till att gamla versioner av klientbiblioteket inte längre finns i din miljö när metadataobjekt uppdateras, vilket innebär att metadataobjekt i gammal version inte skapas efter uppgraderingen.

Uppgraderingssteg

1. Uppgradera dina program. I Visual Studio laddar du ned och refererar till den senaste klientbiblioteksversionen i alla dina utvecklingsprojekt som använder biblioteket. sedan återskapa och distribuera.

  • I din Visual Studio-lösning väljer du Verktyg -->NuGet Package Manager --Hantera NuGet-paket> för lösning.
  • (Visual Studio 2013) I den vänstra panelen väljer du Uppdateringar och väljer sedan knappen Uppdatera i paketet Azure SQL Database Elastic Scale Client Library som visas i fönstret.
  • (Visual Studio 2015) Ange rutan Filter till Uppgradera tillgänglig. Välj det paket som ska uppdateras och välj knappen Uppdatera .
  • (Visual Studio 2017) Längst upp i dialogrutan väljer du Uppdateringar. Välj det paket som ska uppdateras och välj knappen Uppdatera .
  • Skapa och distribuera.

2. Uppgradera skripten. Om du använder PowerShell-skript för att hantera shards laddar du ned den nya biblioteksversionen och kopierar den till katalogen som du kör skript från.

3. Uppgradera split-merge-tjänsten. Om du använder verktyget för delad sammanfogning av elastisk databas för att organisera om fragmenterade data laddar du ned och distribuerar den senaste versionen av verktyget. Detaljerade uppgraderingssteg för tjänsten finns här.

4. Uppgradera dina Shard Map Manager-databaser. Uppgradera metadata som stöder Shard-Kartor i Azure SQL Database. Det finns två sätt att åstadkomma detta med hjälp av PowerShell eller C#. Båda alternativen visas nedan.

Alternativ 1: Uppgradera metadata med PowerShell

  1. Ladda ned det senaste kommandoradsverktyget för NuGet härifrån och spara till en mapp.
  2. Öppna en kommandotolk, navigera till samma mapp och utfärda kommandot: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
  3. Navigera till undermappen som innehåller den nya klient-DLL-versionen som du har laddat ned, till exempel: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
  4. Ladda ned skriptet för klientuppgradering av elastisk databas från Script Center och spara det i samma mapp som innehåller DLL:en.
  5. Från den mappen kör du PowerShell .\upgrade.ps1 från kommandotolken och följer anvisningarna.

Alternativ 2: Uppgradera metadata med C#

Du kan också skapa ett Visual Studio-program som öppnar ShardMapManager, itererar över alla shards och utför metadatauppgradering genom att anropa metoderna UpgradeLocalStore och UpgradeGlobalStore som i det här exemplet:

    ShardMapManager smm =
       ShardMapManagerFactory.GetSqlShardMapManager
       (connStr, ShardMapManagerLoadPolicy.Lazy);
    smm.UpgradeGlobalStore();

    foreach (ShardLocation loc in
     smm.GetDistinctShardLocations())
    {
       smm.UpgradeLocalStore(loc);
    }

Dessa tekniker för metadatauppgraderingar kan användas flera gånger utan skada. Om en äldre klientversion till exempel oavsiktligt skapar en shard när du redan har uppdaterat kan du köra uppgraderingen igen över alla shards för att säkerställa att den senaste metadataversionen finns i hela infrastrukturen.

Obs! Nya versioner av klientbiblioteket som publicerats hittills fortsätter att fungera med tidigare versioner av Shard Map Manager-metadata i Azure SQL Database och vice versa. Men för att kunna dra nytta av några av de nya funktionerna i den senaste klienten måste metadata uppgraderas. Metadatauppgraderingar påverkar inte användardata eller programspecifika data, endast objekt som skapas och används av Shard Map Manager. Och programmen fortsätter att fungera via uppgraderingssekvensen som beskrivs ovan.

Versionshistorik för elastisk databasklient

För versionshistorik går du till Microsoft.Azure.SqlDatabase.ElasticScale.Client

Ytterligare resurser

Använder du inte elastiska databasverktyg än? Kolla in vår komma igång-guide. Om du har frågor kan du kontakta oss på microsofts Q&A-frågesida för SQL Database och för funktionsförfrågningar, lägga till nya idéer eller rösta på befintliga idéer i SQL Database-feedbackforumet.