Bir uygulamayı en son elastik veritabanı istemci kitaplığını kullanacak şekilde yükseltme

Şunlar için geçerlidir:Azure SQL Veritabanı

Elastik Veritabanı istemci kitaplığının yeni sürümleri, Visual Studio'daki NuGet ve NuGet Paket Yöneticisi arabirimi aracılığıyla kullanılabilir. Yükseltmeler hata düzeltmeleri ve istemci kitaplığının yeni özellikleri için destek içerir.

En son sürüm için: Microsoft.Azure.SqlDatabase.ElasticScale.Client adresine gidin.

Uygulamanızı yeni kitaplıkla yeniden derleyin ve yeni özellikleri desteklemek için Azure SQL Veritabanı veritabanlarınızda depolanan mevcut Parça Eşleme Yöneticisi meta verilerinizi değiştirin.

Bu adımların sırayla gerçekleştirilmesi, meta veri nesneleri güncelleştirildiğinde istemci kitaplığının eski sürümlerinin ortamınızda artık bulunmamasını sağlar ve bu da eski sürüm meta veri nesnelerinin yükseltmeden sonra oluşturulmayacağı anlamına gelir.

Yükseltme adımları

1. Uygulamalarınızı yükseltin. Visual Studio'da, kitaplığı kullanan tüm geliştirme projelerinize en son istemci kitaplığı sürümünü indirin ve başvurun; ardından yeniden derleyin ve dağıtın.

• Visual Studio çözümünüzde Araçlar -->NuGet Paket Yöneticisi -->Çözüm için NuGet Paketlerini Yönet'i seçin.
• (Visual Studio 2013) Sol panelde Güncelleştirmeler'ı seçin ve ardından pencerede görünen Elastik Ölçek İstemci Kitaplığı'Azure SQL Veritabanı paketteki Güncelleştir düğmesini seçin.
• (Visual Studio 2015) Filtre kutusunu Yükseltme kullanılabilir olarak ayarlayın. Güncelleştirilecek paketi seçin ve Güncelleştir düğmesini seçin.
• (Visual Studio 2017) İletişim kutusunun üst kısmında Güncelleştirmeler'ı seçin. Güncelleştirilecek paketi seçin ve Güncelleştir düğmesini seçin.
• Derleme ve Dağıtma.

2. Betiklerinizi yükseltin. Parçaları yönetmek için PowerShell betikleri kullanıyorsanız yeni kitaplık sürümünü indirin ve betikleri yürüttüğüniz dizine kopyalayın.

3. Bölünmüş birleştirme hizmetinizi yükseltin. Parçalanmış verileri yeniden düzenlemek için elastik veritabanı bölünmüş birleştirme aracını kullanıyorsanız aracın en son sürümünü indirin ve dağıtın. Hizmet için ayrıntılı yükseltme adımlarına buradan ulaşabilirsiniz.

4. Parça Eşleme Yöneticisi veritabanlarınızı yükseltin. Azure SQL Veritabanı'da Parça Haritalar destekleyen meta verileri yükseltin. PowerShell veya C# kullanarak bunu yapmanın iki yolu vardır. Her iki seçenek de aşağıda gösterilmiştir.

1. Seçenek: PowerShell kullanarak meta verileri yükseltme

1. NuGet için en son komut satırı yardımcı programını buradan indirin ve bir klasöre kaydedin.
2. Bir Komut İstemi açın, aynı klasöre gidin ve komutu verin: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. İndirdiğiniz yeni istemci DLL sürümünü içeren alt klasöre gidin, örneğin: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Betik Merkezi'nden elastik veritabanı istemci yükseltme betiğini indirin ve DLL'yi içeren aynı klasöre kaydedin.
5. Bu klasörden komut isteminden komutunu çalıştırın PowerShell .\upgrade.ps1 ve istemleri izleyin.

2. Seçenek: C kullanarak meta verileri yükseltme#

Alternatif olarak, ShardMapManager'ınızı açan, tüm parçalar üzerinde yineleyen ve bu örnekte olduğu gibi UpgradeLocalStore ve UpgradeGlobalStore yöntemlerini çağırarak meta veri yükseltmesi gerçekleştiren bir Visual Studio uygulaması oluşturun:

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

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

Meta veri yükseltmeleri için bu teknikler zarar vermeden birden çok kez uygulanabilir. Örneğin, eski bir istemci sürümü önceden güncelleştirdikten sonra yanlışlıkla bir parça oluşturursa, altyapınızda en son meta veri sürümünün mevcut olduğundan emin olmak için yükseltmeyi tüm parçalar arasında yeniden çalıştırabilirsiniz.

Not: Bugüne kadar yayımlanan istemci kitaplığının yeni sürümleri, Azure SQL Veritabanı'da Parça Eşleme Yöneticisi meta verilerinin önceki sürümleriyle çalışmaya devam eder ve bunun tersi de geçerlidir. Ancak en son istemcideki bazı yeni özelliklerden yararlanmak için meta verilerin yükseltilmesi gerekir. Meta veri yükseltmeleri kullanıcı verilerini veya uygulamaya özgü verileri etkilemez, yalnızca Parça Eşleme Yöneticisi tarafından oluşturulan ve kullanılan nesneleri etkiler. Uygulamalar, yukarıda açıklanan yükseltme dizisi aracılığıyla çalışmaya devam eder.

Elastik veritabanı istemcisi sürüm geçmişi

Sürüm geçmişi için Microsoft.Azure.SqlDatabase.ElasticScale.Client adresine gidin

Ek kaynaklar

Elastik veritabanı araçlarını henüz kullanmıyor musunuz? Başlarken Kılavuzumuza göz atın. Sorular için, SQL Veritabanı ve özellik istekleri için Microsoft Soru-Cevap soru sayfasından bizimle iletişime geçin, yeni fikirler ekleyin veya SQL Veritabanı geri bildirim forumunda mevcut fikirler için oy verin.