Referensi API Instans SQL Server Express LocalDB

Di dunia SQL Server tradisional berbasis layanan, instans SQL Server individual yang diinstal pada satu komputer dipisahkan secara fisik; artinya, setiap instans harus diinstal dan dihapus secara terpisah, memiliki sekumpulan biner terpisah, dan berjalan di bawah proses layanan terpisah. Nama instans SQL Server digunakan untuk menentukan instans SQL Server mana yang ingin disambungkan pengguna.

API instans SQL Server Express LocalDB menggunakan model instans "ringan" yang disederhanakan. Meskipun instans LocalDB individual dipisahkan pada disk dan di registri, instans tersebut menggunakan kumpulan biner LocalDB bersama yang sama. Selain itu, LocalDB tidak menggunakan layanan; Instans LocalDB diluncurkan sesuai permintaan melalui panggilan API instans LocalDB. Di LocalDB, nama instans digunakan untuk menentukan instans LocalDB mana yang ingin dikerjakan pengguna.

Instans LocalDB selalu dimiliki oleh satu pengguna dan hanya terlihat dan dapat diakses dari konteks pengguna ini, kecuali berbagi instans diaktifkan.

Meskipun secara teknis instans LocalDB tidak sama dengan instans SQL Server tradisional, penggunaan yang dimaksudkan serupa. Mereka disebut instans untuk menekankan kesamaan ini dan membuatnya lebih intuitif bagi pengguna SQL Server.

LocalDB mendukung dua jenis instans: instans otomatis (AI) dan instans bernama (NI). Pengidentifikasi untuk instans LocalDB adalah nama instans.

Instans LocalDB Otomatis

Instans LocalDB otomatis adalah "publik"; mereka dibuat dan dikelola secara otomatis untuk pengguna dan dapat digunakan oleh aplikasi apa pun. Satu instans LocalDB otomatis ada untuk setiap versi LocalDB yang diinstal di komputer pengguna.

Instans LocalDB otomatis menyediakan manajemen instans yang mulus. Pengguna tidak perlu membuat instans. Ini memungkinkan pengguna untuk dengan mudah menginstal aplikasi dan bermigrasi ke komputer yang berbeda. Jika komputer target telah menginstal versi LocalDB yang ditentukan, instans LocalDB otomatis untuk versi tersebut juga tersedia di komputer tersebut.

Manajemen Instans Otomatis

Pengguna tidak perlu membuat instans LocalDB otomatis. Instans dibuat dengan malas saat pertama kali instans digunakan, asalkan versi LocalDB yang ditentukan tersedia di komputer pengguna. Dari sudut pandang pengguna, instans otomatis selalu ada jika biner LocalDB ada.

Operasi manajemen instans lainnya, seperti Hapus, Bagikan, dan Batalkan pembagian, juga berfungsi untuk instans otomatis. Secara khusus, menghapus instans otomatis secara efektif mengatur ulang instans, yang akan dibuat ulang pada operasi Mulai berikutnya. Menghapus instans otomatis mungkin diperlukan jika database sistem menjadi rusak.

Aturan Penamaan Instans Otomatis

Instans LocalDB otomatis memiliki pola khusus untuk nama instans milik namespace layanan yang dipesan. Ini diperlukan untuk mencegah konflik nama dengan instans LocalDB bernama.

Nama instans otomatis adalah nomor versi rilis garis besar LocalDB yang didahului oleh satu karakter "v". Ini terlihat seperti "v" ditambah dua angka dengan titik di antara mereka; misalnya, v11.0 atau V12.00.

Contoh nama instans otomatis ilegal adalah:

• 11.0 (tidak memiliki karakter "v" di awal)

• v11 (kehilangan titik dan nomor kedua versi)

• v11. (tidak memiliki nomor kedua versi)

• v11.0.1.2 (nomor versi memiliki lebih dari dua bagian)

Instans LocalDB Bernama

Instans LocalDB bernama "privat"; instans dimiliki oleh satu aplikasi yang bertanggung jawab untuk membuat dan mengelola instans. Instans LocalDB bernama menyediakan isolasi dan meningkatkan performa.

Pembuatan Instans Bernama

Pengguna harus membuat instans bernama secara eksplisit melalui API manajemen LocalDB, atau secara implisit melalui file app.config untuk aplikasi terkelola. Aplikasi terkelola juga dapat menggunakan API.

Setiap instans bernama memiliki versi LocalDB terkait; artinya, menunjuk ke sekumpulan biner LocalDB tertentu. Versi untuk instans bernama diatur selama proses pembuatan instans.

Aturan Penamaan Instans Bernama

Nama instans LocalDB dapat memiliki hingga total 128 karakter (batas diberlakukan oleh sysname jenis data). Ini adalah perbedaan yang signifikan dibandingkan dengan nama instans SQL Server tradisional, yang terbatas pada nama NetBIOS 16 karakter ASCII. Alasan perbedaan ini adalah bahwa LocalDB memperlakukan database sebagai file, dan oleh karena itu menyiratkan semantik berbasis file, sehingga intuitif bagi pengguna untuk memiliki lebih banyak kebebasan dalam memilih nama instans.

Nama instans LocalDB dapat berisi karakter Unicode apa pun yang legal dalam komponen nama file. Karakter ilegal dalam komponen nama file umumnya mencakup karakter berikut: karakter ASCII/Unicode 1 hingga 31, serta kutipan ("), kurang dari (<), lebih besar dari (>), pipa (|), backspace (\b), tab (\t), titik dua (:), tanda bintang (*), tanda tanya (?), garis miring terbalik (\), dan garis miring (/). Perhatikan bahwa karakter null (\0) diizinkan karena digunakan untuk penghentian string; semuanya setelah karakter null pertama akan diabaikan.

Nota

Daftar karakter ilegal dapat bergantung pada sistem operasi dan dapat berubah dalam rilis mendatang.

Spasi putih di depan dan di belakang dalam nama instans diabaikan dan akan dipangkas.

Untuk menghindari konflik penamaan, instans bernama LocalDB tidak dapat memiliki nama yang mengikuti pola penamaan untuk instans otomatis, seperti yang dijelaskan sebelumnya dalam "Aturan Penamaan Instans Otomatis." Upaya untuk membuat instans bernama dengan nama yang mengikuti pola penamaan instans otomatis secara efektif membuat instans default.

Topik Referensi SQL Server Express LocalDB

Informasi Header dan Versi SQL Server Express LocalDB
Menyediakan informasi file header dan kunci registri untuk menemukan API instans LocalDB.

Alat Manajemen Baris Perintah: SqlLocalDB.exe
Menjelaskan SqlLocalDB.exe, alat untuk mengelola instans LocalDB dari baris perintah.

Fungsi LocalDBCreateInstance
Menjelaskan fungsi untuk membuat instans LocalDB baru.

Fungsi LocalDBDeleteInstance
Menjelaskan fungsi untuk menghapus instans LocalDB.

Fungsi LocalDBFormatMessage
Menjelaskan fungsi untuk mengembalikan deskripsi yang dilokalkan untuk kesalahan LocalDB.

Fungsi LocalDBGetInstanceInfo
Menjelaskan fungsi untuk mendapatkan informasi untuk instans LocalDB, seperti apakah ada, informasi versi, apakah itu berjalan, dan sebagainya.

Fungsi LocalDBGetInstances
Menjelaskan fungsi untuk mengembalikan semua instans LocalDB dengan versi tertentu.

Fungsi LocalDBGetVersionInfo
Menjelaskan fungsi untuk mengembalikan informasi untuk versi LocalDB tertentu.

Fungsi LocalDBGetVersions
Menjelaskan fungsi untuk mengembalikan semua versi LocalDB yang tersedia di komputer.

Fungsi LocalDBShareInstance
Menjelaskan fungsi untuk berbagi instans LocalDB tertentu.

Fungsi LocalDBStartInstance
Menjelaskan fungsi untuk memulai instans LocalDB tertentu.

Fungsi LocalDBStartTracing
Menjelaskan fungsi untuk mengaktifkan pelacakan API untuk pengguna.

Fungsi LocalDBStopInstance
Menjelaskan fungsi untuk menghentikan instans LocalDB tertentu agar tidak berjalan.

Fungsi LocalDBStopTracing
Menjelaskan fungsi untuk menonaktifkan pelacakan API untuk pengguna.

Fungsi LocalDBUnshareInstance
Menjelaskan fungsi untuk berhenti berbagi instans LocalDB tertentu.