Delen via

Een app upgraden om de meest recente clientbibliotheek voor elastische databases te gebruiken

  • Artikel

Van toepassing op: Azure SQL Database

Nieuwe versies van de Elastic Database-clientbibliotheek zijn beschikbaar via NuGet en de NuGet-interface Pakketbeheer in Visual Studio. Upgrades bevatten oplossingen voor fouten en ondersteuning voor nieuwe mogelijkheden van de clientbibliotheek.

Ga naar Microsoft.Azure.SqlDatabase.ElasticScale.Client voor de nieuwste versie.

Bouw uw toepassing opnieuw met de nieuwe bibliotheek en wijzig de bestaande Shard Map Manager-metagegevens die zijn opgeslagen in uw databases in Azure SQL Database om nieuwe functies te ondersteunen.

Als u deze stappen uitvoert, zorgt u ervoor dat oude versies van de clientbibliotheek niet meer aanwezig zijn in uw omgeving wanneer metagegevensobjecten worden bijgewerkt. Dit betekent dat metagegevensobjecten van oude versies niet worden gemaakt na de upgrade.

Upgradestappen

1. Uw toepassingen upgraden. Download en verwijs in Visual Studio naar de nieuwste versie van de clientbibliotheek in al uw ontwikkelprojecten die gebruikmaken van de bibliotheek; vervolgens herbouwen en implementeren.

  • Selecteer Tools -->NuGet Pakketbeheer -->Manage NuGet Packages for Solution in uw Visual Studio-oplossing.
  • (Visual Studio 2013) Selecteer Updates in het linkerdeelvenster en selecteer vervolgens de knop Bijwerken in het pakket azure SQL Database Elastic Scale-clientbibliotheek die wordt weergegeven in het venster.
  • (Visual Studio 2015) Stel het filtervak in op Upgrade beschikbaar. Selecteer het pakket dat u wilt bijwerken en selecteer de knop Bijwerken .
  • (Visual Studio 2017) Selecteer Updates bovenaan het dialoogvenster. Selecteer het pakket dat u wilt bijwerken en selecteer de knop Bijwerken .
  • Bouwen en implementeren.

2. Werk uw scripts bij. Als u PowerShell-scripts gebruikt om shards te beheren, downloadt u de nieuwe bibliotheekversie en kopieert u deze naar de map waaruit u scripts uitvoert.

3. Voer een upgrade uit van uw split-merge-service. Als u het hulpprogramma voor splitsen en samenvoegen van elastische databases gebruikt om shard-gegevens opnieuw te orden, downloadt en implementeert u de nieuwste versie van het hulpprogramma. Gedetailleerde upgradestappen voor de service vindt u hier.

4. Werk uw Shard Map Manager-databases bij. Werk de metagegevens bij die uw Shard-Kaarten ondersteunen in Azure SQL Database. U kunt dit op twee manieren doen met behulp van PowerShell of C#. Beide opties worden hieronder weergegeven.

Optie 1: Metagegevens upgraden met Behulp van PowerShell

  1. Download hier het nieuwste opdrachtregelprogramma voor NuGet en sla het bestand op in een map.
  2. Open een opdrachtprompt, navigeer naar dezelfde map en voer de opdracht uit: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
  3. Navigeer naar de submap met de nieuwe dll-versie van de client die u hebt gedownload, bijvoorbeeld: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
  4. Download het upgradescript voor de elastic database-client vanuit het Script Center en sla het op in dezelfde map met het DLL-bestand.
  5. Voer vanuit die map uit PowerShell .\upgrade.ps1 vanaf de opdrachtprompt en volg de aanwijzingen.

Optie 2: Metagegevens upgraden met C#

U kunt ook een Visual Studio-toepassing maken waarmee uw ShardMapManager wordt geopend, alle shards worden herhaald en de metagegevensupgrade worden uitgevoerd door de methoden UpgradeLocalStore en UpgradeGlobalStore aan te roepen, zoals in dit voorbeeld:

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

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

Deze technieken voor metagegevensupgrades kunnen meerdere keren worden toegepast zonder schade. Als een oudere clientversie bijvoorbeeld per ongeluk een shard maakt nadat u al hebt bijgewerkt, kunt u de upgrade opnieuw uitvoeren op alle shards om ervoor te zorgen dat de meest recente metagegevensversie aanwezig is in uw infrastructuur.

Opmerking: nieuwe versies van de clientbibliotheek die tot nu toe zijn gepubliceerd, blijven werken met eerdere versies van de Shard Map Manager-metagegevens in Azure SQL Database en omgekeerd. Als u echter wilt profiteren van enkele van de nieuwe functies in de nieuwste client, moeten metagegevens worden bijgewerkt. Metagegevensupgrades zijn niet van invloed op gebruikersgegevens of toepassingsspecifieke gegevens, alleen objecten die zijn gemaakt en gebruikt door Shard-toewijzingsbeheer. En toepassingen blijven werken via de hierboven beschreven upgradevolgorde.

Versiegeschiedenis van elastic database-client

Ga naar Microsoft.Azure.SqlDatabase.ElasticScale.Client voor versiegeschiedenis

Aanvullende bronnen

Gebruikt u nog geen hulpprogramma's voor elastische databases? Bekijk de handleiding Aan de slag. Neem voor vragen contact met ons op op de microsoft Q&A-vragenpagina voor SQL Database en voor functieaanvragen, voeg nieuwe ideeën toe of stem op bestaande ideeën in het feedbackforum van SQL Database.