Bagikan melalui

Tingkatkan aplikasi untuk menggunakan pustaka klien database elastis terbaru

  • Artikel

Berlaku untuk: Azure SQL Database

Versi baru pustaka klien Elastic Database tersedia melalui NuGet dan antarmuka NuGet Package Manager di Visual Studio. Peningkatan berisi perbaikan bug dan dukungan untuk kemampuan baru pustaka klien.

Untuk versi terbaru: Buka Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Bangun ulang aplikasi Anda dengan pustaka baru, dan ubah metadata Shard Map Manager yang sudah ada yang disimpan dalam database Anda di Azure SQL Database untuk mendukung fitur baru.

Melakukan langkah-langkah ini untuk memastikan bahwa versi lama pustaka klien tidak lagi ada di lingkungan Anda ketika objek metadata diperbarui, yang berarti bahwa objek metadata versi lama tidak akan dibuat setelah peningkatan.

Langkah-langkah peningkatan

1. Tingkatkan aplikasi Anda. Di Visual Studio, unduh dan referensikan versi pustaka klien terbaru ke semua proyek pengembangan Anda yang menggunakan pustaka; lalu bangun kembali dan sebarkan.

  • Di solusi Visual Studio Anda, pilih Alat ->Manajer Paket NuGet -->Kelola Paket NuGet untuk Solusi.
  • (Visual Studio 2013) Di panel kiri, pilih Pembaruan, lalu pilih tombol Perbarui pada paket Azure SQL Database Elastic Scale Client Library yang muncul di jendela.
  • (Visual Studio 2015) Atur kotak Filter ke Peningkatan yang tersedia. Pilih paket yang akan diperbarui, dan pilih tombol Perbarui .
  • (Visual Studio 2017) Di bagian atas dialog, pilih Pembaruan. Pilih paket yang akan diperbarui, dan pilih tombol Perbarui .
  • Bangun dan Sebarkan.

2. Tingkatkan skrip Anda. Jika Anda menggunakan skrip PowerShell untuk mengelola shard, unduh versi pustaka baru dan salin ke direktori tempat Anda menjalankan skrip.

3. Tingkatkan layanan pisah-gabung Anda. Jika Anda menggunakan alat split-merge database elastis untuk mengatur ulang data yang di-shard, unduh dan sebarkan versi terbaru alat. Langkah-langkah peningkatan mendetail untuk Layanan dapat ditemukan di sini.

4. Tingkatkan database Shard Map Manager Anda. Meningkatkan metadata yang mendukung Shard Maps Anda di Azure SQL Database. Ada dua cara untuk mencapainya, menggunakan PowerShell atau C#. Kedua opsi ditunjukkan di bawah ini.

Opsi 1: Meningkatkan metadata menggunakan PowerShell

  1. Unduh utilitas baris perintah terbaru untuk NuGet dari sini dan simpan ke folder.
  2. Buka Perintah, navigasikan ke folder yang sama, dan terbitkan perintah: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
  3. Navigasi ke subfolder yang berisi versi DLL klien baru yang telah Anda unduh, misalnya: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
  4. Unduh skrip peningkatan klien database elastis dari Pusat Skrip, dan simpan ke folder yang sama yang berisi DLL.
  5. Dari folder tersebut, jalankan PowerShell .\upgrade.ps1 dari prompt perintah dan ikuti perintah.

Opsi 2: Meningkatkan metadata menggunakan C#

Atau, buat aplikasi Visual Studio yang membuka ShardMapManager Anda, iterasi semua shard, dan lakukan peningkatan metadata dengan panggilan metode UpgradeLocalStore dan UpgradeGlobalStore seperti dalam contoh ini:

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

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

Teknik-teknik untuk peningkatan metadata dapat diterapkan beberapa kali tanpa bahaya. Misalnya, jika versi klien yang lebih lama secara tidak sengaja membuat shard setelah diperbarui, Anda dapat menjalankan peningkatan lagi di semua shard untuk memastikan bahwa versi metadata terbaru ada di seluruh infrastruktur Anda.

Catatan: Versi baru pustaka klien yang diterbitkan hingga saat ini terus berfungsi dengan versi metadata Manajer Peta Pecahan sebelumnya di Azure SQL Database, dan sebaliknya. Namun untuk memanfaatkan beberapa fitur baru di klien terbaru, metadata perlu ditingkatkan. Peningkatan metadata tidak akan memengaruhi data pengguna atau data khusus aplikasi, hanya objek yang dibuat dan digunakan oleh Shard Map Manager. Dan aplikasi terus beroperasi melalui urutan peningkatan yang dideskripsikan di atas.

Riwayat versi klien database elastis

Untuk versi riwayat, buka Microsoft.Azure.SqlDatabase.ElasticScale.Client

Konten terkait

Belum menggunakan alat database elastis? Lihat Panduan Memulai kami. Jika memiliki pertanyaan, hubungi kami di halaman pertanyaan Tanya Jawab Microsoft untuk SQL Database dan untuk permintaan fitur, tambahkan ide-ide baru atau ambil suara terbanyak untuk ide yang sudah ada di forum umpan balik SQL Database.