適用対象:
SQL Server
SQL Server Express LocalDB のインスタンスを作成するには、SqlLocalDB ユーティリティを使用します。 SqlLocalDB ユーティリティ (SqlLocalDB.exe) は、ユーザーおよび開発者が SQL Server Express LocalDB のインスタンスを作成および管理できるようにするコマンド ライン ツールです。 LocalDBの使用方法の詳細については、「SQL Server 2016 Express LocalDB」を参照してください。
構文
SqlLocalDB.exe
{
[ create | c ] <instance-name> <instance-version> [-s ]
| [ delete | d ] <instance-name>
| [ start | s ] <instance-name>
| [ stop | p ] <instance-name> [ -i ] [ -k ]
| [ share | h ] ["<user_SID>" | "<user_account>" ] "<private-name>" "<shared-name>"
| [ unshare | u ] "<shared-name>"
| [ info | i ] <instance-name>
| [ versions | v ]
| [ trace | t ] [ on | off ]
| [ help | -? ]
}
引数
[ create | c ] <instance-name><instance-version> [-s ]
SQL Server Express LocalDB の新しいインスタンスを作成します。 SqlLocalDB では、引数 <instance-version> で指定された SQL Server Express バイナリのバージョンを使用します。 バージョン番号は、1 桁以上の 10 進数の数値書式で指定します。 マイナー バージョン番号 (サービス パック) は省略可能です。 たとえば、11.0 と 11.0.1186 という 2 つのバージョン番号のどちらも使用できます。 指定したバージョンがコンピューターにインストールされている必要があります。 指定しなかった場合、バージョン番号は既定で SqlLocalDB ユーティリティのバージョンに設定されます。 -s を追加した場合、LocalDB の新しいインスタンスを開始します。
[ share | h ]
指定された共有名を使用して、LocalDB の指定されたプライベート インスタンスを共有します。 ユーザー SID またはアカウント名を省略した場合、既定で現在のユーザーになります。
[ unshare | u ]
LocalDBの指定した共有インスタンスの共有を停止します。
[ delete | d ] <instance-name>
指定された SQL Server Express LocalDB のインスタンスを削除します。
[ start | s ] "<instance-name>"
指定された SQL Server Express LocalDB のインスタンスを開始します。 成功した場合、ステートメントから LocalDBの名前付きパイプ アドレスが返されます。
[ stop | p ] <instance-name> [-i ] [-k ]
指定された SQL Server Express LocalDB のインスタンスを停止します。 -i を追加した場合は、NOWAIT オプション付きでインスタンスのシャットダウンを要求します。 -k を追加した場合、インスタンス プロセスは通知されることなく停止されます。
[ info | i ] [ <instance-name> ]
現在のユーザーが所有する SQL Server Express LocalDB のすべてのインスタンスを一覧表示します。
<instance-name> を指定すると、SQL Server Express LocalDB の指定されたインスタンスの名前、バージョン、状態 (Running または Stopped)、最後の起動時刻に加え、LocalDB のローカル パイプ名が返されます。
[ trace | t ] on | off
trace on を指定すると、現在のユーザーに対して SqlLocalDB の API 呼び出しのトレースが有効になります。 trace off はトレースを無効にします。
-?
各 SqlLocalDB オプションの簡単な説明が返されます。
解説
引数 instance name は、SQL Server 識別子のルールに従っているか、二重引用符で囲む必要があります。
引数を指定せずに SqlLocalDB を実行すると、ヘルプ テキストが返されます。
開始以外の操作は、現在サインインしているユーザーに属するインスタンスでのみ実行できます。 SQLLOCALDB インスタンスを共有している場合、開始と停止はそのインスタンスの所有者のみが実行できます。
例
A. LocalDB のインスタンスを作成する
次の例では、SQL Server バイナリを使用して DEPARTMENT という名前の SQL Server Express LocalDB のインスタンスを作成し、そのインスタンスを開始します。
SqlLocalDB.exe create "DEPARTMENT" 12.0 -s
B. LocalDB の共有インスタンスを操作する
管理者権限を使用してコマンド プロンプトを開きます。 <password> を有効なパスワードに置き換えます。
SqlLocalDB.exe create "DeptLocalDB"
SqlLocalDB.exe share "DeptLocalDB" "DeptSharedLocalDB"
SqlLocalDB.exe start "DeptLocalDB"
SqlLocalDB.exe info "DeptLocalDB"
REM The previous statement outputs the Instance pipe name for the next step
sqlcmd -S np:\\.\pipe\LOCALDB#<use your pipe name>\tsql\query
CREATE LOGIN NewLogin WITH PASSWORD = '<password>';
GO
CREATE USER NewLogin;
GO
EXIT
次のコードを実行して、 ログインを使用して、 LocalDB NewLogin の共有インスタンスに接続します。 <password> を有効なパスワードに置き換えます。
sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P <password>