SQL Server Express LocalDB örneği API'leri

Şunlar için geçerlidir: SQL Server

Geleneksel, hizmet tabanlı SQL Server dünyasında, tek bir bilgisayara yüklenen tek tek SQL Server örnekleri fiziksel olarak ayrılır. Her örnek ayrı olarak yüklenip kaldırılmalı, ayrı bir ikili dosya kümesine sahip olmalı ve ayrı bir hizmet işlemi altında çalıştırılmalıdır. SQL Server örneği adı, kullanıcının hangi SQL Server örneğine bağlanmak istediğini belirtmek için kullanılır.

SQL Server Express LocalDB örneği API'sinde basitleştirilmiş, basit bir örnek modeli kullanılır. Tek tek LocalDB örnekleri diskte ve kayıt defterinde ayrılmış olsa da, aynı paylaşılan LocalDB ikili dosyalarını kullanır. Ayrıca, LocalDB hizmetleri kullanmaz. LocalDB örnekleri, LocalDB örneği API çağrıları aracılığıyla isteğe bağlı olarak başlatılır. LocalDB'de, kullanıcının hangi LocalDB örnekleriyle çalışmak istediğini belirtmek için örnek adı kullanılır.

Bir LocalDB örneği her zaman tek bir kullanıcıya aittir ve örnek paylaşımı etkinleştirilmediği sürece yalnızca bu kullanıcının bağlamında görünür ve erişilebilir.

Teknik olarak LocalDB örnekleri geleneksel SQL Server örnekleriyle aynı olmasa da, amaçlanan kullanımları benzerdir. Bu benzerliği vurgulamak ve SQL Server kullanıcıları için daha sezgisel hale getirmek amacıyla örnekler olarak adlandırılır.

LocalDB iki tür örneği destekler: otomatik örnekler (AI) ve adlandırılmış örnekler (NI). LocalDB örneğinin tanımlayıcısı örnek adıdır.

Otomatik LocalDB örnekleri

Otomatik LocalDB örnekleri halka açıktır; Kullanıcılar için otomatik olarak oluşturulur ve yönetilir ve herhangi bir uygulama tarafından kullanılabilir. Kullanıcının bilgisayarına yüklenen her LocalDB sürümü için bir otomatik LocalDB örneği vardır. Otomatik LocalDB örneğinin MSSQLLocalDBadı .

Otomatik LocalDB örnekleri sorunsuz örnek yönetimi sağlar. Kullanıcının örneği oluşturması gerekmez. Bu, kullanıcıların uygulamaları kolayca yüklemesine ve farklı bilgisayarlara geçişine olanak tanır. Hedef bilgisayarda belirtilen LocalDB sürümü yüklüyse, bu sürüm için otomatik LocalDB örneği de bu bilgisayarda kullanılabilir.

Otomatik örnek yönetimi

Kullanıcının otomatik bir LocalDB örneği oluşturması gerekmez. Belirtilen LocalDB sürümü kullanıcının bilgisayarında kullanılabildiği sürece örnek ilk kez kullanıldığında, örnek lazily oluşturulur. Kullanıcının bakış açısından, LocalDB ikili dosyaları varsa otomatik örnek her zaman bulunur.

Delete, Share ve Unshare gibi diğer örnek yönetimi işlemleri de otomatik örnekler için çalışır. Özellikle, bir otomatik örneğin silinmesi örneği etkili bir şekilde sıfırlar ve bir sonraki Başlangıç işleminde yeniden oluşturulur. Sistem veritabanları bozulursa otomatik örneği silmeniz gerekebilir.

Adlandırılmış LocalDB örnekleri

Adlandırılmış LocalDB örnekleri özeldir; Bir örnek, örneği oluşturup yönetmekten sorumlu tek bir uygulamaya aittir. Adlandırılmış LocalDB örnekleri yalıtım sağlar ve performansı artırır.

Adlandırılmış örnek oluşturma

Kullanıcının adlandırılmış örnekleri açıkça LocalDB yönetim API'si aracılığıyla veya yönetilen bir uygulamanın dosyası aracılığıyla app.config örtük olarak oluşturması gerekir. Yönetilen bir uygulama da API'yi kullanabilir.

Her adlandırılmış örneğin ilişkili bir LocalDB sürümü vardır; yani, belirtilen bir LocalDB ikili dosyaları kümesine işaret eder. Adlandırılmış örneğin sürümü, örnek oluşturma işlemi sırasında ayarlanır.

Adlandırılmış örnek adlandırma kuralları

Bir LocalDB örnek adı 128 karaktere kadar olabilir ( sysname veri tipi bu sınırı getirir). Bu sınır, geleneksel SQL Server örnek adlarıyla karşılaştırıldığında önemli bir farktır; çünkü bu isimler 15 ASCII karakterli NetBIOS adlarıyla sınırlıdır. Bu farkın nedeni, LocalDB'nin veritabanlarını dosya olarak ele alması ve bu nedenle dosya tabanlı anlamanlam ima etmesidir; böylece kullanıcılar örnek adlarını seçmede daha fazla özgürlüğe sahiptir.

LocalDB örneği adı, dosya adı bileşeninde yasal olan herhangi bir Unicode karakteri içerebilir. Dosya adı bileşenindeki geçersiz karakterler genellikle şu karakterleri içerir: ASCII/Unicode karakterleri 1 ile 31 arasında ve tırnak işareti ("), küçüktür (<), büyüktür (>), kanal (|), geri al (), sekme (\b), iki nokta üst üste (\t:), yıldız işareti (), soru işareti (*?), ters eğik çizgi (\) ve eğik çizgi (/). Dize sonlandırma için kullanıldığından null karaktere (\0) izin verilir; ilk null karakterden sonraki her şey yoksayılır.

Note

Geçersiz karakter listesi işletim sistemine bağlı olabilir ve gelecek sürümlerde değişebilir.

Örnek adlarındaki baştaki ve sondaki boşluklar yoksayılır ve kırpılır.

Adlandırma çatışmalarını önlemek için, adlandırılmış bir LocalDB örneği rezerve edilmiş otomatik örnek MSSQLLocalDBadını kullanamaz. Bu isimle adlandırılmış bir örnek oluşturma girişimi varsayılan bir örnek oluşturur.

Article Description
SQL Server Express LocalDB üst bilgisi ve sürüm bilgileri LocalDB örneği API'sini bulmak için üst bilgi dosyası bilgilerini ve kayıt defteri anahtarlarını sağlar.
Command-Line Yönetim Aracı: SqlLocalDB.exe Komut satırından LocalDB örneklerini yönetmeye yönelik bir araç olan SqlLocalDB.exeaçıklar.
LocalDBCreateInstance Fonksiyonu Yeni bir LocalDB örneği oluşturma işlevini açıklar.
LocalDBDeleteInstance Fonksiyonu LocalDB örneğini kaldırma işlevini açıklar.
LocalDBFormatMessage Fonksiyonu LocalDB hatası için yerelleştirilmiş açıklama döndürme işlevini açıklar.
LocalDBGetInstanceInfo Fonksiyonu LocalDB örneğinin var olup olmadığı, sürüm bilgileri, çalışıp çalışmadığı gibi bilgileri almaya yönelik işlevi açıklar.
LocalDBGetInstances Fonksiyonu Belirtilen sürüme sahip tüm LocalDB örneklerini döndürme işlevini açıklar.
LocalDBGetVersionInfo Fonksiyonu Belirtilen LocalDB sürümü için bilgi döndürme işlevini açıklar.
LocalDBGetVersions Fonksiyonu Bir bilgisayarda kullanılabilen tüm LocalDB sürümlerini döndürme işlevini açıklar.
LocalDBShareInstance Fonksiyonu Belirtilen bir LocalDB örneğini paylaşma işlevini açıklar.
LocalDBStartInstance Fonksiyonu Belirtilen bir LocalDB örneğini başlatma işlevini açıklar.
LocalDBStartTracing Fonksiyonu Bir kullanıcı için API izlemeyi etkinleştirme işlevini açıklar.
LocalDBStopInstance Fonksiyonu Belirtilen bir LocalDB örneğinin çalışmasını durdurma işlevini açıklar.
LocalDBStopTracing Fonksiyonu Bir kullanıcı için API izlemeyi devre dışı bırakma işlevini açıklar.
LocalDBUnshareInstance Fonksiyonu Belirtilen LocalDB örneğini paylaşmayı durdurma işlevini açıklar.
  • Last updated on