Aracılığıyla paylaş

SQL Server Express LocalDB (Yerel Veritabanı Motoru)

Şunlar için geçerlidir: SQL Server

Microsoft SQL Server Express LocalDB, geliştiricileri hedefleyen bir SQL Server Express özelliğidir. Gelişmiş Hizmetler ile SQL Server Express sürümünde kullanılabilir. SQL Server 2025 (17.x) ve sonraki sürümlerinde SQL Server Express sürümünde kullanılabilir.

LocalDB yüklemesi, SQL Server Veritabanı Altyapısı'nı başlatmak için gereken en az sayıda dosyayı kopyalar. LocalDB yüklendikten sonra, özel bir bağlantı dizesi kullanarak bağlantı başlatabilirsiniz. Bağlandığınızda, gerekli SQL Server altyapısı otomatik olarak oluşturulur ve başlatılır ve uygulamanın veritabanını karmaşık yapılandırma görevleri olmadan kullanmasını sağlar. Geliştirici Araçları, geliştiricilere SQL Server'ın tam sunucu örneğini yönetmek zorunda kalmadan Transact-SQL kodu yazmalarına ve test etmelerine olanak tanıyan bir SQL Server Veritabanı Altyapısı sağlayabilir.

Kurulum medyası

LocalDB, SQL Server Express yüklemesi sırasında seçtiğiniz bir özelliktir ve medyayı indirdiğinizde kullanılabilir. Medyayı indirirseniz Hızlı Gelişmiş'i veya LocalDB paketini seçin.

Visual Studio 2019 ve Visual Studio 2022 kullanan müşterilerin SQL Server 2019 Express sürümünü yüklemesi gerekir.

LocalDB yükleyicisi SqlLocalDB.msi , Express Core dışındaki tüm sürümler için yükleme medyasında kullanılabilir. <installation_media_root>\<LCID>_ENU_LP\x64\Setup\x64 klasöründe yer almaktadır. LCID bir yerel ayar tanımlayıcısı veya dil kodudur. Örneğin, 1033 LCID değeri, en-US yerel ayarına karşılık gelir.

Alternatif olarak, LocalDB'yi Visual Studio Yükleyicisi aracılığıyla, Veri Depolama ve İşleme iş yükünün, ASP.NET ve web geliştirme iş yükünün bir parçası olarak veya tek bir bileşen olarak yükleyebilirsiniz.

LocalDB'yi yükleme

Yükleme sihirbazı aracılığıyla veya SqlLocalDB.msi programını kullanarak LocalDB'yi yükleyin. LocalDB, SQL Server Express LocalDB yüklenirken kullanılan bir seçenektir.

Yükleme sırasında Özellik Seçimi/Paylaşılan Özellikler sayfasında LocalDB'yi seçin. Her ana SQL Server Veritabanı Altyapısı sürümü için LocalDB ikili dosyalarının yalnızca bir yüklemesi olabilir. Birden çok Veritabanı Altyapısı işlemi başlatılabilir ve tümü aynı ikili dosyaları kullanır. LocalDB ile başlatılan BIR SQL Server Veritabanı Altyapısı örneği, SQL Server Express ile aynı sınırlamalara sahiptir.

SQL Server Express LocalDB'nin bir örneği, SqlLocalDB.exe yardımcı programı kullanılarak yönetilir. KULLANıM dışı bırakılan SQL Server Express kullanıcı örneği özelliği yerine SQL Server Express LocalDB kullanılmalıdır.

Açıklama

LocalDB kurulum programı, gerekli dosyaları bilgisayara yüklemek için programı kullanır SqlLocalDB.msi . Yüklendikten sonra LocalDB, SQL Server veritabanları oluşturabilen ve açabilen bir SQL Server Express örneğidir. Veritabanının sistem dosyaları, normalde gizli olan yerel AppData yolunda saklanır. Örneğin, C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\. Kullanıcı veritabanı dosyaları, genellikle kullanıcının belirlediği, klasörün içindeki C:\Users\<user>\Documents\ bir yerde depolanır.

Bir uygulamaya LocalDB ekleme hakkında daha fazla bilgi için bkz. Visual Studio Yerel Verilerine Genel Bakış, Veritabanı oluşturma ve Visual Studio'da tablo ekleme.

LocalDB API'si hakkında daha fazla bilgi için bkz. SQL Server Express LocalDB başvurusu.

Yardımcı SqlLocalDB program, LocalDB'nin yeni örneklerini oluşturabilir, LocalDB örneğini başlatıp durdurabilir ve LocalDB'yi yönetmenize yardımcı olacak seçenekler içerir. Yardımcı program SqlLocalDB hakkında daha fazla bilgi için bkz. SqlLocalDB yardımcı programı.

LocalDB için örnek sıralaması SQL_Latin1_General_CP1_CI_AS olarak ayarlanmıştır ve değiştirilemez. Veritabanı düzeyinde, sütun düzeyinde ve ifade düzeyinde harmanlamalar normal şekilde desteklenir. Kapsanan veritabanları, tempdb harmanlamaları tarafından tanımlanan meta veriler ve harmanlama kurallarını izler.

Kısıtlamalar

  • LocalDB, SQL Server Management Studio aracılığıyla uzaktan yönetilemiyor.

  • LocalDB, birleştirme çoğaltma abonesi olamaz.

  • LocalDB FILESTREAM'i desteklemez.

  • LocalDB yalnızca Hizmet Aracısı için yerel kuyruklara izin verir.

  • Gibi NT AUTHORITY\SYSTEM yerleşik hesapların sahip olduğu bir LocalDB örneği, Windows dosya sistemi yeniden yönlendirmesi nedeniyle yönetilebilirlik sorunlarına sahip olabilir. Bunun yerine sahibi olarak normal bir Windows hesabı kullanın.

Otomatik ve adlandırılmış örnekler

LocalDB iki tür örneği destekler: otomatik örnekler ve adlandırılmış örnekler. Bir bilgisayarın farklı kullanıcıları aynı ada sahip örneklere sahip olabilir. Her örnek kendi işleminde ilgili kullanıcı olarak çalışır.

Otomatik örnekler

LocalDB'nin otomatik örnekleri geneldir. Bunlar kullanıcı için otomatik olarak oluşturulur ve yönetilir ve herhangi bir uygulama tarafından kullanılabilir. Kullanıcının bilgisayarında yüklü olan her LocalDB sürümü için bir otomatik LocalDB örneği vardır. LocalDB'nin otomatik örnekleri sorunsuz örnek yönetimi sağlar. Örneği oluşturmanıza gerek yoktur; Sadece işe yarıyor. Bu özellik, uygulamanın kolayca yüklenmesini ve farklı bir bilgisayara geçirilmesini sağlar. Hedef makinede belirtilen LocalDB sürümü yüklüyse, hedef makinede de bu sürüm için LocalDB'nin otomatik örneği kullanılabilir. LocalDB'nin otomatik örnekleri, ayrılmış bir ad alanına ait örnek adı için özel bir desene sahiptir. Otomatik örnekler, LocalDB'nin adlandırılmış örnekleriyle ad çakışmalarını önler. Otomatik örneğin adı şeklindedir MSSQLLocalDB.

Adlandırılmış örnekler

LocalDB'nin adlandırılmış örnekleri özeldir. Bunlar, örneği oluşturmak ve yönetmekle sorumlu olan tek bir uygulamaya aittir. Adlandırılmış örnekler diğer örneklerden yalıtım sağlar ve diğer veritabanı kullanıcılarıyla kaynak çekişmesini azaltarak performansı artırabilir. Adlandırılmış örnekleri oluşturmak için LocalDB yönetim API'sini açıkça ya da app.config dosyası yoluyla yönetilen bir uygulama için örtük olarak kullanmanız gerekir (ancak, yönetilen uygulama API'yi de kullanabilir, eğer tercih edilirse). LocalDB'nin her adlandırılmış örneği, ilgili LocalDB ikili dosyaları kümesine işaret eden ilişkili bir LocalDB sürümüne sahiptir. LocalDB'nin örnek adı sysname veri türüdür ve en fazla 128 karakter içerebilir. (Bu örnek adı, adları 15 ASCII karakterden oluşan normal NetBIOS adlarıyla sınırlayan SQL Server'ın normal adlandırılmış örneklerinden farklıdır.) LocalDB örneğinin adı, dosya adı içinde yasal olan tüm Unicode karakterlerini içerebilir. Otomatik örnek adı kullanan adlandırılmış örnek, otomatik örnek haline gelir.

LocalDB'nin paylaşılan örnekleri

Bilgisayarın birden çok kullanıcısının tek bir LocalDB örneğine bağlanması gereken senaryoları desteklemek için LocalDB örnek paylaşımını destekler. Örnek sahibi, bilgisayardaki diğer kullanıcıların örneğe bağlanmasına izin vermeyi seçebilir. LocalDB'nin hem otomatik hem de adlandırılmış örnekleri paylaşılabilir. Bir LocalDB örneğini paylaşmak için kullanıcı paylaşılan bir ad (takma ad) seçer. Paylaşılan ad bilgisayarın tüm kullanıcıları tarafından görülebildiğinden, bu paylaşılan ad bilgisayarda benzersiz olmalıdır. LocalDB örneğinin paylaşılan adı, LocalDB'nin adlandırılmış örneğiyle aynı biçime sahiptir.

Yalnızca bilgisayardaki bir yönetici LocalDB'nin paylaşılan bir örneğini oluşturabilir. LocalDB'nin paylaşılan bir örneği, bir yönetici veya paylaşılan örneğin sahibi tarafından paylaşımsız hale getirilebilir. Bir LocalDB örneğini paylaşmak ve paylaşımını kapatmak için LocalDB API'sinin LocalDBShareInstance ve LocalDBUnShareInstance yöntemlerini veya SqlLocalDB yardımcı programının paylaşım ve paylaşımını kapatma seçeneklerini kullanın.

LocalDB'yi başlatma ve LocalDB'ye bağlanma

Bu bölümde otomatik örneğe, adlandırılmış örneğe veya paylaşılan örneğe nasıl bağlanıldığı açıklanmaktadır.

Otomatik örneğe bağlanma

LocalDB kullanmanın en kolay yolu, bağlantı dizesini Server=(localdb)\MSSQLLocalDB;Integrated Security=truekullanarak geçerli kullanıcının sahip olduğu otomatik örneğe bağlanmaktır. Dosya adını kullanarak belirli bir veritabanına bağlanmak için, benzeri Server=(LocalDB)\MSSQLLocalDB;Integrated Security=true;AttachDbFileName=D:\Data\MyDB1.mdfbir bağlantı dizesi kullanarak bağlanın.

Uyarı

Bilgisayardaki bir kullanıcı LocalDB'ye ilk kez bağlanmaya çalıştığında, otomatik örneğin hem oluşturulması hem de başlatılması gerekir. Örneğin oluşturulması için ek süre, bağlantı girişiminin zaman aşımı iletisiyle başarısız olmasına neden olabilir. Bu durumda, oluşturma işleminin tamamlanmasını sağlamak için birkaç saniye bekleyin ve yeniden bağlanın.

Adlandırılmış örnek oluşturma ve bu örneğe bağlanma

LocalDB, otomatik örneğe ek olarak adlandırılmış örnekleri de destekler. LocalDB'nin SqlLocalDB.exe adlandırılmış bir örneğini oluşturmak, başlatmak ve durdurmak için programı kullanın. hakkında SqlLocalDB.exedaha fazla bilgi için bkz . SqlLocalDB yardımcı programı.

REM Create an instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" create LocalDBApp1
REM Start the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" start LocalDBApp1
REM Gather information about the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" info LocalDBApp1

Önceki kod örneğindeki son satır, aşağıdaki tabloya benzer bilgiler döndürür.

Kategori Değer
İsim LocalDBApp1
Sürüm <Current version>
Paylaşılan ad ""
Sahibi <Your Windows user>
Otomatik oluşturma No
Eyalet Running
Son başlangıç saati <Date and time>
Örnek kanalı adı np:\\.\pipe\LOCALDB#F365A78E\tsql\query

Uyarı

Uygulamanız 4.0.2'den önce bir .NET Framework sürümü kullanıyorsa, doğrudan LocalDB'nin adlandırılmış kanalına bağlanmanız gerekir. Örnek kanal adı değeri, LocalDB örneğinin dinlediği adlandırılmış kanaldır. Örnek kanal adının sonraki LOCALDB# bölümü, LocalDB örneği her başlatıldığında değişir. SQL Server Management Studio kullanarak LocalDB örneğine bağlanmak için, Veritabanı Altyapısına Bağlan iletişim kutusunun Sunucu adı kutusuna örnek kanalı adını yazın. Özel programınızdan şuna benzer bir bağlantı dizesi kullanarak LocalDB örneğine bağlantı kurabilirsiniz: SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");

LocalDB'nin paylaşılan bir örneğine bağlanma

LocalDB'nin paylaşılan bir örneğine bağlanmak için, paylaşılan örnekler için ayrılmış ad alanına başvurmak üzere bağlantı dizesine \.\ (ters eğik çizgi + nokta + ters eğik çizgi) ekleyin. Örneğin, AppData adlı paylaşılan bir LocalDB örneğine bağlanmak için, (localdb)\.\AppData gibi bir bağlantı dizesi kullanın. Sahibi olmadığı paylaşılan bir LocalDB örneğine bağlanmak isteyen bir kullanıcının, Windows Kimlik Doğrulaması veya SQL Server Kimlik Doğrulaması giriş bilgileri olmalıdır.

Sorun giderme

LocalDB sorunlarını giderme hakkında bilgi için bkz. Bilinen SQL Server 2012 kurulum ve geçiş sorunları.

İzinler

SQL Server Express LocalDB örneği, bir kullanıcı tarafından kullanımı için oluşturulan bir örnektir. Bilgisayardaki herhangi bir kullanıcı LocalDB örneğini kullanarak veritabanı oluşturabilir, dosyaları kendi kullanıcı profili altında depolayabilir ve işlemi kimlik bilgileri altında çalıştırabilir. Varsayılan olarak, LocalDB örneğine erişim sahibiyle sınırlıdır. LocalDB'de yer alan veriler, veritabanı dosyalarına dosya sistemi erişimiyle korunur. Kullanıcı veritabanı dosyaları paylaşılan bir konumda depolanıyorsa, veritabanı, sahip olduğu bir LocalDB örneği kullanılarak bu konuma dosya sistemi erişimi olan herkes tarafından açılabilir. Veritabanı dosyaları kullanıcılar veri klasörü gibi korumalı bir konumdaysa, veritabanını yalnızca o kullanıcı ve bu klasöre erişimi olan tüm yöneticiler açabilir. LocalDB dosyaları bir kerede yalnızca bir LocalDB örneği tarafından açılabilir.

LocalDB her zaman kullanıcının güvenlik bağlamı altında çalışır. LocalDB hiçbir zaman yerel Yönetici grubunun kimlik bilgileriyle çalıştırılmaz. Bu, LocalDB örneği tarafından kullanılan tüm veritabanı dosyalarına, yerel Administrators grubu üyeliği düşünülmeden sahip olan kullanıcının Windows hesabı kullanılarak erişilebilir olması gerektiği anlamına gelir.

İlgili içerik

  • Last updated on