API instans SQL Server Express LocalDB

Berlaku untuk:SQL Server

Di dunia SQL Server tradisional berbasis layanan, instans SQL Server individual yang diinstal pada satu komputer dipisahkan secara fisik. 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 bersifat 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. Nama instans LocalDB otomatis adalah MSSQLLocalDB.

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, selama 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 dibuat ulang pada operasi Mulai berikutnya. Menghapus instans otomatis mungkin diperlukan jika database sistem menjadi rusak.

Instans LocalDB bernama

Instans LocalDB bernama bersifat pribadi; 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 app.config file untuk aplikasi terkelola. Aplikasi terkelola mungkin juga 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 128 karakter (tipe data sysname memberlakukan batas ini). Batas ini merupakan perbedaan yang signifikan dibandingkan dengan nama instans SQL Server tradisional, yang terbatas pada nama NetBIOS dengan 15 karakter ASCII. Alasan perbedaan ini adalah bahwa LocalDB memperlakukan database sebagai file, dan oleh karena itu menyiratkan semantik berbasis file, sehingga pengguna 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, dan kuotasi ("), kurang dari (<), lebih besar dari (>), pipa (|), backspace (), tab (\b\t), titik dua (:), tanda bintang (*), tanda tanya (?), garis miring terbalik (\), dan garis miring ke depan (/). Karakter null (\0) diizinkan karena digunakan untuk penghentian string; semuanya setelah karakter null pertama diabaikan.

Note

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

Spasi putih di awal dan akhir dalam nama instans diabaikan dan dipangkas.

Untuk menghindari konflik penamaan, instans LocalDB bernama tidak dapat menggunakan nama MSSQLLocalDBinstans otomatis yang dicadangkan. Upaya untuk membuat instans bernama dengan nama tersebut secara efektif membuat instans default.

Tugas terkait

Article	Description
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.