Upgrade einer App auf die neueste Clientbibliothek für elastische Datenbanken

Artikel
02/01/2024

Neue Versionen der Clientbibliothek für elastische Datenbanken stehen über NuGet und die NuGet-Paket-Manager-Schnittstelle in Visual Studio zur Verfügung. Upgrades bieten Fehlerkorrekturen und Unterstützung für die neuen Funktionen der Clientbibliothek.

Aktuelle Version: Besuchen Sie Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Erstellen Sie die Anwendung mit der neuen Bibliothek neu, und ändern Sie Ihre vorhandenen Shard Map Manager-Metadaten, die in Ihren Datenbanken in Azure SQL-Datenbank gespeichert sind, um neue Funktionen zu unterstützen.

Durch Ausführen dieser Schritte in dieser Reihenfolge wird sichergestellt, dass alte Versionen der Clientbibliothek nicht mehr in Ihrer Umgebung vorhanden sind, wenn Metadatenobjekte aktualisiert werden. Dies bedeutet, dass Metadatenobjekte der alten Version nach dem Upgrade nicht mehr erstellt werden.

Upgradeschritte

1. Aktualisieren Sie Ihre Anwendungen. Laden Sie in Visual Studio die neueste Version der Clientbibliothek herunter, und verweisen Sie in allen Ihren Entwicklungsprojekten, die die Bibliothek verwenden, darauf. Führen Sie dann die Schritte zur Neuerstellung und Bereitstellung aus.

Wählen Sie in Ihrer Visual Studio-Projektmappe Extras -->NuGet Package Manager -->NuGet-Pakete für Projektmappe verwalten aus.
(Visual Studio 2013) Wählen Sie im linken Bereich Updates aus, und klicken Sie dann für das Paket Azure SQL Database Elastic Scale Client Library, das im Fenster angezeigt wird, auf die Schaltfläche Aktualisieren.
(Visual Studio 2015) Legen Sie das Filterfeld auf Upgrade verfügbarfest. Wählen Sie das zu aktualisierende Paket aus, und wählen Sie die Schaltfläche Aktualisieren .
(Visual Studio 2017) Wählen Sie im oberen Bereich des Dialogfelds Updates aus. Wählen Sie das zu aktualisierende Paket aus, und wählen Sie die Schaltfläche Aktualisieren .
Führen Sie die Schritte zur Erstellung und Bereitstellung aus.

2. Aktualisieren Sie Ihre Skripts. Wenn Sie PowerShell-Skripts zum Verwalten von Shards verwenden, laden Sie die neue Bibliotheksversion herunter, und kopieren Sie sie in das Verzeichnis, in dem Sie Skripts ausführen.

3. Aktualisieren Sie den Split-Merge-Dienst. Wenn Sie das Split-Merge-Tool für elastische Datenbanken zum Reorganisieren von Shardingdaten verwenden, laden Sie die neueste Version des Tools herunter und stellen diese bereit. Detaillierte Upgradeschritte für den Dienst finden Sie hier.

4. Aktualisieren Sie Ihre Shardzuordnungs-Manager-Datenbanken. Aktualisieren Sie die Metadaten, die Ihre Shard Maps in der Azure SQL-Datenbank unterstützen. Es gibt hierfür zwei Möglichkeiten: PowerShell oder C#. Beide Optionen werden nachstehend vorgestellt.

Option 1: Aktualisieren von Metadaten mithilfe von PowerShell

Laden Sie das neueste Befehlszeilendienstprogramm für NuGet hier herunter, und speichern Sie es in einem Ordner.
Öffnen Sie eine Eingabeaufforderung, navigieren Sie zum selben Ordner, und geben Sie folgenden Befehl aus: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
Navigieren Sie zum Unterordner mit der neuen Client-DLL-Version, die Sie heruntergeladen haben, z. B.: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
Laden Sie das Script für das Clientupgrade der elastischen Datenbank aus dem Script Center herunter, und speichern Sie es in dem Ordner, der bereits die DLL enthält.
Führen Sie in diesem Ordner an der Befehlszeile PowerShell .\upgrade.ps1 aus, und folgen Sie den Anweisungen.

Option 2: Aktualisieren von Metadaten mithilfe von C#

Erstellen Sie alternativ eine Visual Studio-Anwendung, die Ihren ShardMapManager öffnet, alle Shards durchläuft und die Aktualisierung der Metadaten durch Aufrufen der Methoden UpgradeLocalStore und UpgradeGlobalStore durchführt, wie im folgenden Beispiel gezeigt:

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

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

Diese Techniken für die Metadatenaktualisierung können ohne Probleme mehrmals angewendet werden. Wenn beispielsweise eine ältere Clientversion versehentlich einen Shard erstellt, den Sie bereits aktualisiert haben, können Sie die Aktualisierung für alle Shards wiederholen, um sicherzustellen, dass die neueste Metadatenversion in der gesamten Infrastruktur vorhanden ist.

Hinweis: Bis dato veröffentlichte neue Versionen der Clientbibliothek funktionieren weiterhin mit früheren Versionen der Shard Map Manager-Metadaten für Azure SQL-Datenbank und umgekehrt. Doch um einige der neuen Features im neuesten Client nutzen zu können, müssen Metadaten aktualisiert werden. Aktualisierungen von Metadaten betreffen keine benutzer- oder anwendungsspezifischen Daten, sondern nur Objekte, die von Shard Map Manager erstellt und verwendet werden. Zudem setzen Anwendungen ihren Betrieb während der zuvor beschriebenen Upgradesequenz fort.

Elastischer Datenbank-Client – Versionsverlauf

Einen Versionsverlauf erhalten Sie unter Microsoft.Azure.SqlDatabase.ElasticScale.Client

Zusätzliche Ressourcen

Verwenden Sie noch keine elastischen Datenbanktools? Sehen Sie sich unseren Leitfaden zu den ersten Schritten an. Wenden Sie sich bei Fragen auf der Frageseite von Microsoft Q&A für SQL-Datenbank und für Featureanforderungen an uns, fügen Sie neue Ideen hinzu, oder stimmen Sie im SQL-Datenbank-Feedbackforumüber vorhandene Ideen ab.