Upgrade aplikace tak, aby používala nejnovější klientskou knihovnu elastické databáze

Platí pro:Azure SQL Database

Nové verze klientské knihovny Elastic Database jsou dostupné prostřednictvím NuGetu a rozhraní Správce balíčků NuGet v sadě Visual Studio. Upgrady obsahují opravy chyb a podporu nových funkcí klientské knihovny.

Nejnovější verzi: Přejděte na Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Znovu sestavte aplikaci s novou knihovnou a změňte stávající metadata Správce mapování horizontálních oddílů uložená v databázích ve službě Azure SQL Database tak, aby podporovala nové funkce.

Provedením těchto kroků zajistíte, že při aktualizaci objektů metadat už nebudou ve vašem prostředí existovat staré verze klientských knihoven. To znamená, že se po upgradu nevytvoří objekty metadat staré verze.

Kroky při upgradu

1. Upgradujte své aplikace. V sadě Visual Studio si stáhněte a odkazujte na nejnovější verzi klientské knihovny do všech vašich vývojových projektů, které tuto knihovnu používají; pak znovu sestavíte a nasadíte.

• V řešení sady Visual Studio vyberte Nástroje -->NuGet Správce balíčků -->Manage NuGet Packages for Solution.
• (Visual Studio 2013) Na levém panelu vyberte Aktualizace a pak vyberte tlačítko Aktualizovat v balíčku Klientská knihovna elastického škálování služby Azure SQL Database, která se zobrazí v okně.
• (Visual Studio 2015) Nastavte pole Filtr na možnost Upgradovat k dispozici. Vyberte balíček, který chcete aktualizovat, a vyberte tlačítko Aktualizovat .
• (Visual Studio 2017) V horní části dialogového okna vyberte Aktualizace. Vyberte balíček, který chcete aktualizovat, a vyberte tlačítko Aktualizovat .
• Sestavení a nasazení

2. Upgradujte skripty. Pokud ke správě horizontálních oddílů používáte skripty PowerShellu , stáhněte si novou verzi knihovny a zkopírujte ji do adresáře, ze kterého spouštíte skripty.

3. Upgradujte službu split-merge. Pokud k opětovnému uspořádání horizontálně dělených dat použijete nástroj pro rozdělení elastické databáze, stáhněte a nasaďte nejnovější verzi nástroje. Podrobné kroky upgradu pro službu najdete tady.

4. Upgradujte databáze Správce mapování horizontálních oddílů. Upgradujte metadata podporující Mapy horizontálních oddílů ve službě Azure SQL Database. Existují dva způsoby, jak toho dosáhnout pomocí PowerShellu nebo jazyka C#. Obě možnosti jsou uvedené níže.

Možnost 1: Upgrade metadat pomocí PowerShellu

1. Stáhněte si nejnovější nástroj příkazového řádku pro NuGet a uložte ho do složky.
2. Otevřete příkazový řádek, přejděte do stejné složky a spusťte příkaz: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Přejděte do podsložky obsahující novou verzi klientské knihovny DLL, kterou jste stáhli, například: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Stáhněte skript pro upgrade klienta elastické databáze z Centra skriptů a uložte ho do stejné složky obsahující knihovnu DLL.
5. Z této složky spusťte PowerShell .\upgrade.ps1 příkazový řádek a postupujte podle pokynů.

Možnost 2: Upgrade metadat pomocí jazyka C#

Případně vytvořte aplikaci sady Visual Studio, která otevře ShardMapManager, iteruje všechny horizontální oddíly a provede upgrade metadat voláním metod UpgradeLocalStore a UpgradeGlobalStore jako v tomto příkladu:

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

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

Tyto techniky pro upgrady metadat je možné použít vícekrát, aniž by došlo k poškození. Pokud například starší verze klienta neúmyslně vytvoří horizontální oddíl po aktualizaci, můžete upgrade spustit znovu napříč všemi horizontálními oddíly, abyste zajistili, že se ve vaší infrastruktuře nachází nejnovější verze metadat.

Poznámka: Nové verze klientské knihovny publikované k datu nadále fungují s předchozími verzemi metadat Správce mapování horizontálních oddílů ve službě Azure SQL Database a naopak. Pokud ale chcete využívat některé nové funkce v nejnovějším klientovi, je potřeba metadata upgradovat. Upgrady metadat neovlivní žádná uživatelská data ani data specifická pro aplikaci, pouze objekty vytvořené a používané Správcem mapování horizontálních oddílů. Aplikace budou dál fungovat v posloupnosti upgradu popsané výše.

Historie verzí klienta elastické databáze

V případě historie verzí přejděte na Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Další materiály

Ještě nepoužíváte nástroje elastické databáze? Podívejte se na naši příručku Začínáme. Pokud máte dotazy, kontaktujte nás na stránce otázek Microsoft Q&A pro SLUŽBU SQL Database a žádosti o funkce, přidejte nové nápady nebo hlasujte pro stávající nápady ve fóru pro zpětnou vazbu ke službě SQL Database.