Alkalmazás frissítése a legújabb rugalmas adatbázis-ügyfélkódtár használatára

A következőre vonatkozik: Azure SQL Database

Az Elastic Database-ügyfélkódtár új verziói a NuGet és a NuGet Csomagkezelő felületén keresztül érhetők el a Visual Studióban. A frissítések hibajavításokat és az ügyfélkódtár új képességeinek támogatását tartalmazzák.

A legújabb verzió: Nyissa meg a Microsoft.Azure.SqlDatabase.ElasticScale.Client webhelyet.

Építse újra az alkalmazást az új kódtárral, és módosítsa az Azure SQL Database adatbázisaiban tárolt meglévő Shard Map Manager-metaadatokat az új funkciók támogatásához.

Ezeknek a lépéseknek a végrehajtásával biztosítható, hogy az ügyfélkódtár régi verziói már ne legyenek jelen a környezetben metaadat-objektumok frissítésekor, ami azt jelenti, hogy a frissítés után a régi verziójú metaadat-objektumok nem jönnek létre.

Frissítési lépések

1. Frissítse az alkalmazásokat. A Visual Studióban töltse le és hivatkozzon a legújabb ügyfélkódtár-verzióra az összes olyan fejlesztési projektben, amely a kódtárat használja; majd újraépítés és üzembe helyezés.

• A Visual Studio-megoldásban válassza az Eszközök -->NuGet Csomagkezelő -->Manage NuGet Packages for Solution (NuGet-csomagok kezelése megoldáshoz) lehetőséget.
• (Visual Studio 2013) A bal oldali panelen válassza a Frissítések, majd az ablakban megjelenő Azure SQL Database Rugalmas méretezésű ügyfélkódtár csomag Frissítés gombját.
• (Visual Studio 2015) Állítsa a Szűrő mezőt a Frissítés elérhetőre. Válassza ki a frissíteni kívánt csomagot, és válassza a Frissítés gombot.
• (Visual Studio 2017) A párbeszédpanel tetején válassza a Frissítések. Válassza ki a frissíteni kívánt csomagot, és válassza a Frissítés gombot.
• Buildelés és üzembe helyezés.

2. Frissítse a szkripteket. Ha PowerShell-szkripteket használ a szegmensek kezeléséhez, töltse le az új kódtár-verziót, és másolja abba a könyvtárba, amelyből szkripteket hajt végre.

3. Frissítse a split-merge szolgáltatást. Ha a rugalmas adatbázis-felosztási egyesítési eszközt használja a szegmenses adatok átrendezéséhez, töltse le és telepítse az eszköz legújabb verzióját. A szolgáltatás részletes frissítési lépéseit itt találja.

4. Frissítse a Shard Map Manager-adatbázisokat. Frissítse a Shard Térképek támogató metaadatokat az Azure SQL Database-ben. Ezt kétféleképpen teheti meg a PowerShell vagy a C# használatával. Mindkét lehetőség alább látható.

1. lehetőség: Metaadatok frissítése a PowerShell használatával

1. Töltse le innen a NuGet legújabb parancssori segédprogramát, és mentsen egy mappába.
2. Nyisson meg egy parancssort, lépjen ugyanarra a mappára, és adja ki a parancsot: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Keresse meg a letöltött új ügyfél DLL-verziót tartalmazó almappát, például: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Töltse le a rugalmas adatbázis-ügyfélfrissítési szkriptet a Szkriptközpontból, és mentse ugyanabba a mappába, amely a DLL-t tartalmazza.
5. Ebből a mappából futtassa PowerShell .\upgrade.ps1 a parancssorból, és kövesse az utasításokat.

2. lehetőség: Metaadatok frissítése C használatával#

Másik lehetőségként hozzon létre egy Visual Studio-alkalmazást, amely megnyitja a ShardMapManagert, iterálja az összes szegmenst, és végrehajtja a metaadatok frissítését az UpgradeLocalStore és az UpgradeGlobalStore metódus meghívásával, ahogyan az alábbi példában látható:

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

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

Ezek a metaadat-frissítési technikák többször is alkalmazhatók sérülés nélkül. Ha például egy régebbi ügyfélverzió véletlenül létrehoz egy szegmenst, miután már frissítette, a frissítést újra futtathatja az összes szegmensben, így biztosítva, hogy a legújabb metaadat-verzió jelen legyen az infrastruktúrában.

Megjegyzés: Az ügyfélkódtár eddig közzétett új verziói továbbra is működnek a Shard Map Manager metaadatainak korábbi verzióival az Azure SQL Database-ben, és fordítva. Ahhoz azonban, hogy kihasználhassa a legújabb ügyfél néhány új funkcióját, frissíteni kell a metaadatokat. A metaadatok frissítései nem érintik a felhasználói adatokat vagy az alkalmazásspecifikus adatokat, csak a Shard Map Manager által létrehozott és használt objektumokat. Az alkalmazások továbbra is a fent leírt frissítési sorrenden keresztül működnek.

Rugalmas adatbázis-ügyfél verzióelőzményei

A verzióelőzményekhez lépjen a Microsoft.Azure.SqlDatabase.ElasticScale.Client webhelyre

További erőforrások

Még nem használ rugalmas adatbázis-eszközöket? Tekintse meg az első lépések útmutatót. Ha kérdése van, lépjen kapcsolatba velünk az SQL Database-hez készült Microsoft Q&A kérdésoldalon, és a funkciókérésekért, adjon hozzá új ötleteket, vagy szavazzon a meglévő ötletekre az SQL Database visszajelzési fórumában.