API instans SQL Server Express LocalDB

Applies to: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. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

Instans LocalDB otomatis

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. 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, 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.

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 v karakter. 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 (karakter hilang 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

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. 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

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). 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, dan kuotasi ("), kurang dari (<), lebih besar dari (>), pipa (|), backspace (), tab (\t\b), 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 bernama LocalDB tidak dapat memiliki nama yang mengikuti pola penamaan untuk instans otomatis, seperti yang dijelaskan sebelumnya di bagian Aturan penamaan instans otomatis . Upaya untuk membuat instans bernama dengan nama yang mengikuti pola penamaan instans otomatis secara efektif membuat instans default.

Related tasks

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.
LocalDBCreateInstance Function	Menjelaskan fungsi untuk membuat instans LocalDB baru.
LocalDBDeleteInstance Function	Menjelaskan fungsi untuk menghapus instans LocalDB.
LocalDBFormatMessage Function	Menjelaskan fungsi untuk mengembalikan deskripsi yang dilokalkan untuk kesalahan LocalDB.
LocalDBGetInstanceInfo Function	Menjelaskan fungsi untuk mendapatkan informasi untuk instans LocalDB, seperti apakah ada, informasi versi, apakah itu berjalan, dan sebagainya.
LocalDBGetInstances Function	Menjelaskan fungsi untuk mengembalikan semua instans LocalDB dengan versi tertentu.
LocalDBGetVersionInfo Function	Menjelaskan fungsi untuk mengembalikan informasi untuk versi LocalDB tertentu.
LocalDBGetVersions Function	Menjelaskan fungsi untuk mengembalikan semua versi LocalDB yang tersedia di komputer.
LocalDBShareInstance Function	Menjelaskan fungsi untuk berbagi instans LocalDB tertentu.
LocalDBStartInstance Function	Menjelaskan fungsi untuk memulai instans LocalDB tertentu.
LocalDBStartTracing Function	Menjelaskan fungsi untuk mengaktifkan pelacakan API untuk pengguna.
LocalDBStopInstance Function	Menjelaskan fungsi untuk menghentikan instans LocalDB tertentu agar tidak berjalan.
LocalDBStopTracing Function	Menjelaskan fungsi untuk menonaktifkan pelacakan API untuk pengguna.
LocalDBUnshareInstance Function	Menjelaskan fungsi untuk berhenti berbagi instans LocalDB tertentu.