Uaktualnianie aplikacji w celu korzystania z najnowszej elastycznej biblioteki klienta bazy danych

Dotyczy:Azure SQL Database

Nowe wersje biblioteki klienta elastycznej bazy danych są dostępne za pośrednictwem pakietu NuGet i interfejsu Menedżer pakietów NuGet w programie Visual Studio. Uaktualnienia zawierają poprawki błędów i obsługę nowych możliwości biblioteki klienta.

Najnowsza wersja: przejdź do pozycji Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Ponownie skompiluj aplikację przy użyciu nowej biblioteki i zmień istniejące metadane menedżera map fragmentów przechowywane w bazach danych w usłudze Azure SQL Database, aby obsługiwać nowe funkcje.

Wykonanie tych kroków w kolejności gwarantuje, że stare wersje biblioteki klienta nie są już obecne w środowisku podczas aktualizowania obiektów metadanych, co oznacza, że obiekty metadanych starej wersji nie zostaną utworzone po uaktualnieniu.

Kroki uaktualniania

1. Uaktualnij aplikacje. W programie Visual Studio pobierz i odwołaj się do najnowszej wersji biblioteki klienta we wszystkich projektach programistycznych korzystających z biblioteki; następnie ponownie skompiluj i wdróż.

• W rozwiązaniu programu Visual Studio wybierz pozycję Narzędzia -->NuGet Menedżer pakietów -->Zarządzaj pakietami NuGet dla rozwiązania.
• (Visual Studio 2013) W panelu po lewej stronie wybierz pozycję Aktualizacje, a następnie wybierz przycisk Aktualizuj w pakiecie Azure SQL Database Elastic Scale Client Library, który zostanie wyświetlony w oknie.
• (Visual Studio 2015) W polu Filtr ustaw opcję Uaktualnij. Wybierz pakiet do zaktualizowania, a następnie wybierz przycisk Aktualizuj .
• (Visual Studio 2017) W górnej części okna dialogowego wybierz pozycję Aktualizacje. Wybierz pakiet do zaktualizowania, a następnie wybierz przycisk Aktualizuj .
• Kompilowanie i wdrażanie.

2. Uaktualnij skrypty. Jeśli używasz skryptów programu PowerShell do zarządzania fragmentami, pobierz nową wersję biblioteki i skopiuj ją do katalogu, z którego są wykonywane skrypty.

3. Uaktualnij usługę scalania podzielonego. Jeśli używasz narzędzia do dzielenia i scalania elastycznej bazy danych w celu reorganizacji danych podzielonych na fragmenty, pobierz i wdróż najnowszą wersję narzędzia. Szczegółowe kroki uaktualniania usługi można znaleźć tutaj.

4. Uaktualnij bazy danych menedżera map fragmentów. Uaktualnij metadane obsługujące Mapy fragmentów w usłudze Azure SQL Database. Istnieją dwa sposoby, aby to osiągnąć, przy użyciu programu PowerShell lub języka C#. Poniżej przedstawiono obie opcje.

Opcja 1. Uaktualnianie metadanych przy użyciu programu PowerShell

1. Pobierz z tego miejsca najnowsze narzędzie wiersza polecenia dla narzędzia NuGet i zapisz je w folderze.
2. Otwórz wiersz polecenia, przejdź do tego samego folderu i wydaj polecenie : nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Przejdź do podfolderu zawierającego pobraną nową wersję biblioteki DLL klienta, na przykład: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Pobierz skrypt uaktualniania klienta elastycznej bazy danych z Centrum skryptów i zapisz go w tym samym folderze zawierającym bibliotekę DLL.
5. W tym folderze uruchom polecenie PowerShell .\upgrade.ps1 w wierszu polecenia i postępuj zgodnie z instrukcjami.

Opcja 2. Uaktualnianie metadanych przy użyciu języka C#

Alternatywnie utwórz aplikację programu Visual Studio, która otwiera element ShardMapManager, iteruje wszystkie fragmenty i wykonuje uaktualnienie metadanych, wywołując metody UpgradeLocalStore i UpgradeGlobalStore , jak w tym przykładzie:

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

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

Te techniki uaktualniania metadanych można stosować wiele razy bez szkody. Jeśli na przykład starsza wersja klienta przypadkowo tworzy fragment po zakończeniu aktualizacji, możesz ponownie uruchomić uaktualnienie we wszystkich fragmentach, aby upewnić się, że najnowsza wersja metadanych jest obecna w całej infrastrukturze.

Uwaga: Nowe wersje biblioteki klienta opublikowane do tej pory nadal działają z poprzednimi wersjami metadanych programu Shard Map Manager w usłudze Azure SQL Database i na odwrót. Jednak aby móc korzystać z niektórych nowych funkcji najnowszego klienta, należy uaktualnić metadane. Uaktualnienia metadanych nie będą mieć wpływu na żadne dane użytkownika ani dane specyficzne dla aplikacji, tylko obiekty utworzone i używane przez Menedżera map fragmentów. Aplikacje nadal działają w ramach opisanej powyżej sekwencji uaktualniania.

Historia wersji klienta elastycznej bazy danych

Aby uzyskać informacje o historii wersji, przejdź do pozycji Microsoft.Azure.SqlDatabase.ElasticScale.Client

Dodatkowe zasoby

Jeszcze nie korzystasz z narzędzi elastycznych baz danych? Zapoznaj się z naszym przewodnikiem Wprowadzenie. W przypadku pytań skontaktuj się z nami na stronie pytań i odpowiedzi dotyczących usługi SQL Database oraz w przypadku żądań funkcji, dodaj nowe pomysły lub zagłosuj na istniejące pomysły na forum opinii usługi SQL Database.