SQL Server Express LocalDBSQL Server Express LocalDB

適用対象: はいSQL Server いいえAzure SQL Database いいえAzure Synapse Analytics (SQL DW) いいえParallel Data Warehouse APPLIES TO: YesSQL Server NoAzure SQL Database NoAzure Synapse Analytics (SQL DW) NoParallel Data Warehouse

Microsoft SQL Server Express LocalDB は、開発者を対象とした SQL Server Express の機能です。Microsoft SQL Server Express LocalDB is a feature of SQL Server Express targeted to developers. SQL Server Express with Advanced Services で利用できます。It is available on SQL Server Express with Advanced Services.

LocalDB のインストールでは、SQL Server データベース エンジンSQL Server Database Engine の開始に最低限必要なファイルがコピーされます。LocalDB installation copies a minimal set of files necessary to start the SQL Server データベース エンジンSQL Server Database Engine. LocalDB のインストール後に、特殊な接続文字列を使用して接続を開始できます。Once LocalDB is installed, you can initiate a connection using a special connection string. 接続時に、必要な SQL ServerSQL Server インフラストラクチャが自動的に作成および開始されるため、複雑な構成タスクを行わなくてもアプリケーションでデータベースを使用できます。When connecting, the necessary SQL ServerSQL Server infrastructure is automatically created and started, enabling the application to use the database without complex configuration tasks. 開発者ツールによって、開発者は SQL Server データベース エンジンSQL Server Database Engine を使用して Transact-SQLTransact-SQL コードを記述してテストすることができ、 SQL ServerSQL Serverの完全なサーバー インスタンスを管理する必要はありません。Developer Tools can provide developers with a SQL Server データベース エンジンSQL Server Database Engine that lets them write and test Transact-SQLTransact-SQL code without having to manage a full server instance of SQL ServerSQL Server.

インストール メディアInstallation media

LocalDB は、SQL Server Express のインストール中に選択する機能で、メディアをダウンロードするときに使用できます。LocalDB is a feature you select during SQL Server Express installation, and is available when you download the media. メディアをダウンロードする場合は、 [Express Advanced] または [LocalDB] パッケージを選択します。If you download the media, either choose Express Advanced or the LocalDB package.

あるいは、データの保存と処理ワークロードや ASP.NET と Web 開発ワークロードの一部として、または個別のコンポーネントとし、Visual Studio インストーラーで LocalDB をインストールすることもできます。Alternatively, you can install LocalDB through the Visual Studio Installer, as part of the Data Storage and Processing workload, the ASP.NET and web development workload, or as an individual component.

LocalDB をインストールするInstall LocalDB

インストール ウィザードまたは SqlLocalDB.msi プログラムを使用して、LocalDB をインストールします。Install LocalDB through the installation wizard or by using the SqlLocalDB.msi program. LocalDB は SQL Server Express LocalDB をインストールするときのオプションです。LocalDB is an option when installing SQL Server Express LocalDB.

インストール時に [Feature Selection/Shared Features](機能の選択/共有機能) ページで [LocalDB] を選択します。Select LocalDB on the Feature Selection/Shared Features page during installation. 主要な SQL Server データベース エンジンSQL Server Database Engineのバージョンごとに LocalDB のバイナリ ファイルのインストールが 1 つだけ表示されます。There can be only one installation of the LocalDB binary files for each major SQL Server データベース エンジンSQL Server Database Engine version. 複数の データベース エンジンDatabase Engine プロセスを開始することができ、すべてのプロセスが使用するバイナリは同じです。Multiple データベース エンジンDatabase Engine processes can be started and will all use the same binaries. LocalDB として開始された SQL Server データベース エンジンSQL Server Database Engine のインスタンスには、SQL Server ExpressSQL Server Express と同じ制限があります。An instance of the SQL Server データベース エンジンSQL Server Database Engine started as the LocalDB has the same limitations as SQL Server ExpressSQL Server Express.

SQL Server ExpressSQL Server Express LocalDB のインスタンスは、SqlLocalDB.exe ユーティリティを使用して管理されます。An instance of SQL Server ExpressSQL Server Express LocalDB is managed by using the SqlLocalDB.exe utility. SQL Server ExpressSQL Server Express ユーザー インターフェイス機能は非推奨であるため、代わりに SQL Server ExpressSQL Server Express LocalDB を使用してください。LocalDB should be used in place of the SQL Server ExpressSQL Server Express user instance feature, which was deprecated.

説明Description

LocalDB セットアップ プログラムでは、SqlLocalDB.msi プログラムを使用して、コンピューターに必要なファイルがインストールされます。The LocalDB setup program uses the SqlLocalDB.msi program to install the necessary files on the computer. LocalDB はインストールされると SQL Server ExpressSQL Server Express のインスタンスとなり、SQL ServerSQL Server データベースを作成して開くことができます。Once installed, LocalDB is an instance of SQL Server ExpressSQL Server Express that can create and open SQL ServerSQL Server databases. データベースのシステム データベース ファイルは、通常は非表示になっているローカル AppData パスに格納されます。The system database files for the database are stored in the local AppData path, which is normally hidden. たとえば、「 C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\ 」のように入力します。For example, C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\. ユーザー データベース ファイルは、ユーザーが指定する場所 (通常は C:\Users\<user>\Documents\ フォルダー内の任意の場所) に格納されます。User database files are stored where the user designates, typically somewhere in the C:\Users\<user>\Documents\ folder.

LocalDB をアプリケーション内に組み込む手順の詳細については、Visual StudioVisual Studio の「ローカル データの概要」と「Visual Studio でデータベースを作成し、テーブルを追加する」を参照してください。For more information about including LocalDB in an application, see Visual StudioVisual Studio Local Data Overview, Create a database and add tables in Visual Studio.

LocalDB API の詳細については、「SQL Server Express LocalDB リファレンス」を参照してください。For more information about the LocalDB API, see SQL Server Express LocalDB Reference.

SqlLocalDb ユーティリティでは、LocalDB インスタンスの新規作成、起動、および終了を行うことができます。このユーティリティには、LocalDB の管理に役立つオプションが含まれています。SqlLocalDb ユーティリティの詳細については、「SqlLocalDB ユーティリティ」を参照してください。The SqlLocalDb utility can create new instances of LocalDB, start and stop an instance of LocalDB, and includes options to help you manage LocalDB.For more information about the SqlLocalDb utility, see SqlLocalDB Utility.

LocalDB のインスタンスの照合順序は SQL_Latin1_General_CP1_CI_AS に設定されており、変更することはできません。The instance collation for LocalDB is set to SQL_Latin1_General_CP1_CI_AS and cannot be changed. データベース レベル、列レベル、および式レベルの照合順序は正常にサポートされます。Database-level, column-level, and expression-level collations are supported normally. 包含データベースは、「包含データベースの照合順序」で定義されているメタデータおよび tempdb の照合順序ルールに従います。Contained databases follow the metadata and tempdb collations rules defined by Contained Database Collations.

制限Restrictions

  • LocalDB はマージ レプリケーションのサブスクライバーとして使用することはできません。LocalDB cannot be a merge replication subscriber.

  • LocalDB では FILESTREAM がサポートされていません。LocalDB does not support FILESTREAM.

  • LocalDB では Service Broker に対してローカル キューのみが許可されます。LocalDB only allows local queues for Service Broker.

  • NT AUTHORITY\SYSTEM などの組み込みのアカウントが所有する LocalDB のインスタンスには、Windows ファイル システムのリダイレクトのため管理の容易性の問題が生じることがあります。An instance of LocalDB owned by the built-in accounts such as NT AUTHORITY\SYSTEM can have manageability issues due to windows file system redirection. 代わりに、所有者として通常の Windows アカウントを使用してください。Instead use a normal windows account as the owner.

自動インスタンスと名前付きインスタンスAutomatic and named instances

LocalDB では、2 種類のインスタンス、自動インスタンスと名前付きインスタンスがサポートされています。LocalDB supports two kinds of instances: Automatic instances and named instances.

  • LocalDB の自動インスタンスはパブリックです。Automatic instances of LocalDB are public. ユーザーのために自動的に作成および管理され、任意のアプリケーションから使用できます。They are created and managed automatically for the user and can be used by any application. ユーザーのコンピューターにインストールされているどのバージョンの LocalDB についても、LocalDB の自動インスタンスが 1 つ存在します。One automatic instance of LocalDB exists for every version of LocalDB installed on the user's computer. LocalDB の自動インスタンスを使用すると、シームレスなインスタンス管理を実行できます。Automatic instances of LocalDB provide seamless instance management. インスタンスを作成する必要はありません。それだけで動作します。There is no need to create the instance; it just works. この機能により、アプリケーションのインストールと別のコンピューターへの移行が簡単になります。This feature allows for easy application installation and migration to a different computer. 対象コンピューターに指定バージョンの LocalDB がインストールされている場合、その対象コンピューターでも同じバージョンの LocalDB の自動インスタンスを使用できます。If the target machine has the specified version of LocalDB installed, the automatic instance of LocalDB for that version is available on the target machine as well. LocalDB の自動インスタンスのインスタンス名には特殊なパターンがあり、これは予約済み名前空間に属します。Automatic instances of LocalDB have a special pattern for the instance name that belongs to a reserved namespace. 自動インスタンスにより、LocalDB の名前付きインスタンスとの名前の競合が防止されます。Automatic instances prevents name conflicts with named instances of LocalDB. 自動インスタンスの名前は MSSQLLocalDBです。The name for the automatic instance is MSSQLLocalDB.

  • LocalDB の名前付きインスタンスはプライベートです。Named instances of LocalDB are private. これらは、そのインスタンスの作成と管理を行う単一のアプリケーションによって所有されます。They are owned by a single application that is responsible for creating and managing the instance. 名前付きインスタンスは他のインスタンスからの分離を可能にし、他のデータベース ユーザーとのリソースの競合を減らすことによってパフォーマンスを向上させることができます。Named instances provide isolation from other instances and can improve performance by reducing resource contention with other database users. 名前付きインスタンスは、ユーザーが LocalDB 管理 API を通じて明示的に作成するか、マネージド アプリケーションの app.config ファイルを通じて暗黙的に作成する必要があります (ただし、マネージド アプリケーションでは必要に応じて API も使用できます)。Named instances must be created explicitly by the user through the LocalDB management API or implicitly via the app.config file for a managed application (although managed application may also use the API, if desired). LocalDB の各名前付きインスタンスには、LocalDB バイナリの特定のセットを指す特定の LocalDB バージョンが関連付けられています。Each named instance of LocalDB has an associated LocalDB version that points to the respective set of LocalDB binaries. LocalDB のインスタンス名は sysname データ型で、最大文字数は 128 文字ですThe instance name of a LocalDB is sysname data type and can have up to 128 characters. (これは、SQL ServerSQL Server の正規の名前付きインスタンスとは異なり、16 の ASCII 文字で構成される正規の NetBIOS 名に制限されることはありません)。LocalDB のインスタンス名には、ファイル名内で有効な任意の Unicode 文字を使用できます。自動インスタンス名を使用する名前付きインスタンスは、自動インスタンスになります。(This differs from regular named instances of SQL ServerSQL Server, which limits names to regular NetBIOS names of 16 ASCII chars.) The name of an instance of LocalDB can contain any Unicode characters that are legal within a filename.A named instance that uses an automatic instance name becomes an automatic instance.

コンピューターの異なるユーザーが同じ名前のインスタンスを持つことができます。Different users of a computer can have instances with the same name. 各インスタンスは、別のユーザーとして実行している別のプロセスです。Each instance is a different processes running as a different user.

LocalDB の共有インスタンスShared instances of LocalDB

コンピューターの複数のユーザーが LocalDBの単一インスタンスに接続する必要のあるシナリオをサポートするために、LocalDB はインスタンス共有をサポートします。To support scenarios where multiple users of the computer need to connect to a single instance of LocalDB, LocalDB supports instance sharing. インスタンスの所有者は、コンピューター上の他のユーザーに自分のインスタンスへの接続を許可することを選択できます。An instance owner can choose to allow the other users on the computer to connect the instance. LocalDB の自動インスタンスと名前付きインスタンスの両方を共有できます。Both automatic and named instances of LocalDB can be shared. LocalDB のインスタンスを共有するには、ユーザーがその共有名 (別名) を選択します。To share an instance of LocalDB, a user selects a shared name (alias) for it. 共有名はコンピューターのすべてのユーザーから参照できるため、この共有名はコンピューター上で一意である必要があります。Because the shared name is visible to all users of the computer, this shared name must be unique on the computer. LocalDB のインスタンスの共有名は、LocalDB の名前付きインスタンスと同じ形式です。The shared name for an instance of LocalDB has the same format as the named instance of LocalDB.

コンピューターの管理者だけが、LocalDB の共有インスタンスを作成できます。Only an administrator on the computer can create a shared instance of LocalDB. LocalDB の共有インスタンスは、管理者または LocalDB の共有インスタンスの所有者が共有解除できます。A shared instance of LocalDB can be unshared by an administrator or by the owner of the shared instance of LocalDB. LocalDB のインスタンスを共有または共有解除するには、LocalDB API の LocalDBShareInstance メソッドと LocalDBUnShareInstance メソッドを使用するか、SqlLocalDb ユーティリティの共有および共有解除オプションを使用します。To share and unshared an instance of LocalDB, use the LocalDBShareInstance and LocalDBUnShareInstance methods of the LocalDB API, or the share and unshared options of the SqlLocalDb utility.

LocalDB の起動および LocalDB への接続Start LocalDB and connect to LocalDB

自動インスタンスへの接続Connect to the automatic instance

LocalDB を使用する最も簡単な方法は、接続文字列 Server=(localdb)\MSSQLLocalDB;Integrated Security=true を使用して、現在のユーザーが所有する自動インスタンスに接続することです。The easiest way to use LocalDB is to connect to the automatic instance owned by the current user by using the connection string Server=(localdb)\MSSQLLocalDB;Integrated Security=true. ファイル名を使用して特定のデータベースに接続するには、Server=(LocalDB)\MSSQLLocalDB; Integrated Security=true ;AttachDbFileName=D:\Data\MyDB1.mdf のような接続文字列を使用して接続します。To connect to a specific database by using the file name, connect using a connection string similar to Server=(LocalDB)\MSSQLLocalDB; Integrated Security=true ;AttachDbFileName=D:\Data\MyDB1.mdf.

LocalDB 形式の名前付け規則と接続文字列は、SQL Server 2014 で変更されました。The naming convention and connection string for LocalDB format changed in SQL Server 2014. 以前のインスタンス名は、単一の文字 v の後に LocalDB とバージョン番号を付けたものでした。Previously, the instance name was a single v character followed by LocalDB and the version number. SQL Server 2014 以降では、このインスタンス名の形式はサポートされなくなり、前に説明した接続文字列を代わりに使用する必要があります。Starting with SQL Server 2014, this instance name format is no longer supported, and the connection string mentioned previously should be used instead.

注意

  • あるコンピューター上でユーザーが初めて LocalDB への接続を試みるときは、自動インスタンスを作成し、なおかつ開始する必要があります。The first time a user on a computer tries to connect to LocalDB, the automatic instance must be both created and started. インスタンスの作成に時間がかかり、接続がタイムアウト メッセージで失敗する可能性があります。The extra time for the instance to be created can cause the connection attempt to fail with a timeout message. この場合は、作成プロセスが完了するまで数秒待ってから再び接続します。When this happens, wait a few seconds to let the creation process complete, and then connect again.

名前付きインスタンスの作成および接続Create and connect to a named instance

LocalDB では、自動インスタンスに加えて名前付きインスタンスもサポートされます。In addition to the automatic instance, LocalDB also supports named instances. LocalDB の名前付きインスタンスを作成、開始、および停止するには、SqlLocalDB.exe プログラムを使用します。Use the SqlLocalDB.exe program to create, start, and stop a named instance of LocalDB. SqlLocalDB.exe の詳細については、「 SqlLocalDB ユーティリティ」を参照してください。For more information about SqlLocalDB.exe, see SqlLocalDB Utility.

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

上記の最後の行によって、次のような情報が返されます。The last line above, returns information similar to the following.

名前Name LocalDBApp1
VersionVersion <現在のバージョン><Current Version>
共有名Shared name """"
所有者Owner "<Windows ユーザー>""<Your Windows User>"
自動作成Auto create いいえNo
StateState 実行中running
前回の開始時刻Last start time <日付と時刻><Date and Time>
インスタンス パイプ名Instance pipe name np:\\.\pipe\LOCALDB#F365A78E\tsql\querynp:\\.\pipe\LOCALDB#F365A78E\tsql\query

注意

アプリケーションで .NET 4.0.2 より前のバージョンが使用されている場合、LocalDB の名前付きパイプに直接接続する必要があります。If your application uses a version of .NET before 4.0.2 you must connect directly to the named pipe of the LocalDB. インスタンス パイプ名の値は、LocalDB のインスタンスがリッスンしている名前付きパイプです。The Instance pipe name value is the named pipe that the instance of LocalDB is listening on. LOCALDB# の後ろのインスタンス パイプ名の部分は、LocalDB のインスタンスが開始されるたびに変わります。The portion of the Instance pipe name after LOCALDB# will change each time the instance of LocalDB is started. SQL Server Management StudioSQL Server Management Studio を使用して LocalDB のインスタンスに接続するには、 [データベース エンジンDatabase Engineへの接続] ダイアログ ボックスにある [サーバー名] ボックスにインスタンス パイプ名を入力します。To connect to the instance of LocalDB by using SQL Server Management StudioSQL Server Management Studio, type the instance pipe name in the Server name box of the Connect to データベース エンジンDatabase Engine dialog box. カスタム プログラムから LocalDB のインスタンスへの接続を確立するには、次のような接続文字列を使用します。SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");From your custom program you can establish connection to the instance of LocalDB using a connection string similar to SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");

LocalDB の共有インスタンスへの接続Connect to a shared instance of LocalDB

LocalDB の共有インスタンスに接続するには、\.\ (円記号 + ドット + 円記号) を接続文字列に追加して、共有インスタンス用に予約されている名前空間を参照します。To connect to a shared instance of LocalDB add \.\ (backslash + dot + backslash) to the connection string to reference the namespace reserved for shared instances. たとえば、AppData という名前の LocalDB の共有インスタンスに接続するには、接続文字列の一部として (localdb)\.\AppData などの接続文字列を使用します。For example, to connect to a shared instance of LocalDB named AppData use a connection string such as (localdb)\.\AppData as part of the connection string. 自身のものではない LocalDB の共有インスタンスに接続するユーザーには、Windows 認証または SQL ServerSQL Server 認証ログインが必要です。A user connecting to a shared instance of LocalDB that they do not own must have a Windows Authentication or SQL ServerSQL Server Authentication login.

トラブルシューティングTroubleshooting

LocalDB のトラブルシューティングについては、「Troubleshooting SQL Server 2012 Express LocalDB (SQL Server 2012 Express LocalDB のトラブルシューティング)」を参照してください。For information about troubleshooting LocalDB, see Troubleshooting SQL Server 2012 Express LocalDB.

アクセス許可Permissions

SQL Server Express LocalDB のインスタンスは、ユーザーが自分で使用するために作成するインスタンスです。An instance of SQL Server Express LocalDB is an instance created by a user for their use. コンピューター上のすべてのユーザーは、LocalDB のインスタンスを使用してデータベースを作成したり、ユーザー プロファイルの下にファイルを格納したり、資格情報の下でプロセスを実行したりできます。Any user on the computer can create a database using an instance of LocalDB, store files under their user profile, and run the process under their credentials. 既定では、LocalDB のインスタンスにアクセスできるのは、その所有者に制限されます。By default, access to the instance of LocalDB is limited to its owner. LocalDB に含まれるデータは、データベース ファイルに対するファイル システム アクセス権によって保護されます。The data contained in the LocalDB is protected by file system access to the database files. ユーザー データベース ファイルが共有の場所に格納されている場合、その場所へのファイル システム アクセス権を持つユーザーであればだれでも、所有する LocalDB のインスタンスを使用してデータベースを開くことができます。If user database files are stored in a shared location, the database can be opened by anyone with file system access to that location by using an instance of LocalDB that they own. データベース ファイルがユーザー データ フォルダーなどの保護された場所に格納されている場合は、そのユーザーおよびそのフォルダーにアクセスできる管理者だけがデータベースを開くことができます。If the database files are in a protected location, such as the users data folder, only that user, and any administrators with access to that folder, can open the database. LocalDB ファイルを開くことができる LocalDB のインスタンスは、一度に 1 つのみです。The LocalDB files can only be opened by one instance of LocalDB at a time.

注意

LocalDB は、常にユーザーのセキュリティ コンテキストに基づいて実行されます。つまり、LocalDB は、ローカル管理者グループの資格情報で実行されることはありません。LocalDB always runs under the users security context; that is, LocalDB never runs with credentials from the local Administrator's group. そのため、LocalDB インスタンスで使用されるすべてのデータベース ファイルは、ローカル管理者グループのメンバーシップを考慮することなく、所有するユーザーの Windows アカウントを使用してアクセスできる必要があります。This means that all database files used by a LocalDB instance must be accessible using the owning user's Windows account, without considering membership in the local Administrators group.

参照See Also

SqlLocalDB ユーティリティSqlLocalDB Utility