Mettre à niveau une application pour utiliser la dernière version de la bibliothèque cliente de bases de données élastiques

S’applique à Azure SQL Database

Les nouvelles versions de la bibliothèque de client de bases de données élastiques sont disponibles par le biais de NuGet et de l’interface du Gestionnaire de package NuGet dans Visual Studio. Les mises à niveau contiennent des résolutions de bogues et offrent une prise en charge des nouvelles fonctionnalités de la bibliothèque cliente.

Pour vous procurer la version la plus récente : accédez à Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Regénérez votre application avec la nouvelle bibliothèque et modifiez les métadonnées du gestionnaire de cartes de partitions qui sont stockées dans vos bases de données dans Azure SQL Database pour qu’elles prennent en charge les nouvelles fonctionnalités.

Effectuez ces étapes afin de vous assurer qu’il ne reste aucune version antérieure de la bibliothèque cliente dans votre environnement après la mise à jour des objets de métadonnées. Cela signifie qu’aucun objet de métadonnées d’une version antérieure n’est créé après la mise à niveau.

Étapes de la mise à niveau

1. Mettez à niveau vos applications. Dans Visual Studio, téléchargez la dernière version de la bibliothèque cliente et ajoutez une référence à cette bibliothèque dans tous vos projets de développement qui utilisent la bibliothèque. Ensuite, régénérez et déployez les applications.

• Dans votre solution Visual Studio, sélectionnez Outils -->Gestionnaire de package NuGet -->Gérer les packages NuGet pour la solution.
• (Visual Studio 2013) Dans le volet gauche, sélectionnez Mises à jour, puis cliquez sur le bouton Mettre à jour dans le package Bibliothèque cliente de mise à l’échelle élastique Azure SQL Database qui s’affiche dans la fenêtre.
• (Visual Studio 2015) Définissez la zone de filtre sur Mise à niveau disponible. Sélectionnez le package à mettre à jour puis cliquez sur le bouton Mettre à jour .
• (Visual Studio 2017) En haut de la boîte de dialogue, sélectionnez Mises à jour. Sélectionnez le package à mettre à jour puis cliquez sur le bouton Mettre à jour .
• Générez et déployez les applications.

2. Mettez à niveau vos scripts. Si vous utilisez des scripts PowerShell pour gérer des partitions, téléchargez la nouvelle version de la bibliothèque et copiez-la dans le répertoire à partir duquel vous exécutez ces scripts.

3. Mettez à niveau votre service de fractionnement/fusion. Si vous utilisez l’outil de fractionnement/fusion de la mise à l’échelle élastique pour réorganiser les données partitionnées, téléchargez et déployez la dernière version de l’outil. Vous trouverez plus d’informations sur les étapes de mise à niveau du service ici.

4. Mettez à niveau vos bases de données du Gestionnaire de cartes de partitions. Mettez à niveau les métadonnées de prise en charge de vos cartes de partitions dans Azure SQL Database. Vous pouvez effectuer cette opération avec PowerShell ou C#. Ces deux options sont expliquées ci-dessous.

Option 1 : mise à niveau des métadonnées à l’aide de PowerShell

1. Téléchargez ici la dernière version de l’utilitaire de ligne de commande de NuGet et enregistrez-la dans un dossier.
2. Ouvrez une invite de commandes, accédez au dossier choisi et exécutez cette commande : nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Accédez au sous-dossier contenant la nouvelle version de la DLL du client que vous venez de télécharger. Par exemple : cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Téléchargez le scriptlet de la mise à niveau du client de la base de données élastique à partir du centre de scripts et enregistrez-le dans le dossier contenant la DLL.
5. Dans ce dossier, exécutez PowerShell .\upgrade.ps1 à partir de l’invite de commandes et suivez les invites.

Option n°2 : mise à niveau des métadonnées en utilisant C#

Une autre solution consiste à créer une application Visual Studio qui ouvre votre gestionnaire de mappages de partitions, effectue une itération sur toutes les partitions, et met à niveau les métadonnées en appelant les méthodes UpgradeLocalStore et UpgradeGlobalStore. Voici un exemple :

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

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

Ces méthodes de mise à niveau des métadonnées peuvent être appliquées plusieurs fois sans risque. Par exemple, si une version antérieure du client crée une partition à tort après la mise à jour, vous pouvez effectuer une nouvelle mise à niveau des métadonnées de toutes les partitions pour vous assurer que votre infrastructure contient bien la dernière version des métadonnées.

Remarque : les nouvelles versions de la bibliothèque cliente publiées à ce jour continuent de fonctionner avec les versions antérieures des métadonnées du Gestionnaire de cartes de partitions sur Azure SQL Database et inversement. Toutefois, pour tirer parti de certaines nouvelles fonctionnalités de la dernière version client, les métadonnées doivent être mises à niveau. Notez que les mises à niveau des métadonnées n’affectent pas les données utilisateur ou les données spécifiques à l’application, mais uniquement les objets créés et utilisés par le Gestionnaire de mappages de partitions. Et les applications continuent de fonctionner à travers la séquence de mise à niveau décrite ci-dessus.

Historique des versions du client des bases de données élastiques

Pour l’historique des versions, accédez à Microsoft.Azure.SqlDatabase.ElasticScale.Client

Ressources supplémentaires

Vous n’utilisez pas encore d’outils de base de données élastique ? Consultez notre Guide de prise en main. Pour toute question, contactez-nous par le biais de la page de questions Microsoft Q&A sur SQL Database et, pour vos demandes de fonctionnalités, ajoutez de nouvelles idées ou votez pour les idées existantes sur le forum de commentaires SQL Database.