SQL Server Express LocalDB örneği API'leri

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

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

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Kullanıcının bilgisayarına yüklenen her LocalDB sürümü için bir otomatik LocalDB örneği vardır.

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.

Otomatik örnek adlandırma kuralları

Otomatik LocalDB örnekleri, ayrılmış bir ad alanına ait örnek adı için özel bir desene sahiptir. Bu, adlandırılmış LocalDB örnekleriyle ad çakışmalarını önlemek için gereklidir.

Otomatik örnek adı, tek v bir karakterden önce gelen LocalDB temel sürüm numarasıdır. Bu, aralarında nokta olan iki sayıya benzer v ; örneğin, v11.0 veya V12.00.

Geçersiz otomatik örnek adları şunlardır:

• 11.0 (başındaki karakter eksik v )
• v11 (bir nokta ve sürümün ikinci numarası eksik)
• v11. (sürümün ikinci numarası eksik)
• v11.0.1.2 (sürüm numarasının ikiden fazla bölümü vardır)

Adlandırılmış LocalDB örnekleri

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

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Bu, 16 ASCII karakterden oluşan NetBIOS adlarla sınırlı olan geleneksel SQL Server örnek adlarına kıyasla önemli bir farktır. Bu farkın nedeni, LocalDB'nin veritabanlarını dosya olarak işlemesi ve bu nedenle dosya tabanlı semantiği ifade ediyor olmasıdır, bu nedenle kullanıcıların örnek adlarını seçme konusunda daha fazla özgürlüğe sahip olması sezgiseldir.

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 çakışmalarını önlemek için, LocalDB örnekleri, otomatik örnek adlandırma kuralları bölümünde daha önce açıklandığı gibi otomatik örnekler için adlandırma desenine uygun bir ada sahip olamaz. Otomatik örnek adlandırma desenini izleyen bir ada sahip adlandırılmış örnek oluşturma girişimi, varsayılan örneği etkili bir şekilde oluşturur.

Related tasks

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 Function	Yeni bir LocalDB örneği oluşturma işlevini açıklar.
LocalDBDeleteInstance Function	LocalDB örneğini kaldırma işlevini açıklar.
LocalDBFormatMessage Function	LocalDB hatası için yerelleştirilmiş açıklama döndürme işlevini açıklar.
LocalDBGetInstanceInfo Function	LocalDB örneğinin var olup olmadığı, sürüm bilgileri, çalışıp çalışmadığı gibi bilgileri almaya yönelik işlevi açıklar.
LocalDBGetInstances Function	Belirtilen sürüme sahip tüm LocalDB örneklerini döndürme işlevini açıklar.
LocalDBGetVersionInfo Function	Belirtilen LocalDB sürümü için bilgi döndürme işlevini açıklar.
LocalDBGetVersions Function	Bir bilgisayarda kullanılabilen tüm LocalDB sürümlerini döndürme işlevini açıklar.
LocalDBShareInstance Function	Belirtilen bir LocalDB örneğini paylaşma işlevini açıklar.
LocalDBStartInstance Function	Belirtilen bir LocalDB örneğini başlatma işlevini açıklar.
LocalDBStartTracing Function	Bir kullanıcı için API izlemeyi etkinleştirme işlevini açıklar.
LocalDBStopInstance Function	Belirtilen bir LocalDB örneğinin çalışmasını durdurma işlevini açıklar.
LocalDBStopTracing Function	Bir kullanıcı için API izlemeyi devre dışı bırakma işlevini açıklar.
LocalDBUnshareInstance Function	Belirtilen LocalDB örneğini paylaşmayı durdurma işlevini açıklar.