SqlLocalDB ユーティリティ

適用対象: SQL Server (サポートされているすべてのバージョン)

MicrosoftSQL Server 2016 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 ExpressLocalDB の新しいインスタンスを作成します。 SqlLocalDB では、引数 <instance-version> で指定された SQL Server Express バイナリのバージョンを使用します。 バージョン番号は、1 桁以上の 10 進数の数値書式で指定します。 マイナー バージョン番号 (サービス パック) は省略可能です。 たとえば、次の 2 つのバージョン番号のどちらも使用できます。11.0 または 11.0.1186。 指定したバージョンがコンピューターにインストールされている必要があります。 指定しなかった場合、バージョン番号は既定で SqlLocalDB ユーティリティのバージョンに設定されます。 -s を追加した場合、LocalDB の新しいインスタンスが起動します。

[ share | h ]
指定された共有名を使用して、 LocalDB の指定されたプライベート インスタンスを共有します。 ユーザー SID またはアカウント名を省略した場合、既定で現在のユーザーになります。

[ unshared | u ]
LocalDBの指定した共有インスタンスの共有を停止します。

[ delete | d ] <instance-name>
指定した SQL Server ExpressLocalDB のインスタンスを削除します。

[ start | s ] "<instance-name>"
指定した SQL Server ExpressLocalDB のインスタンスを起動します。 成功した場合、ステートメントから LocalDBの名前付きパイプ アドレスが返されます。

[ stop | p ] <instance-name> [-i ] [-k ]
指定した SQL Server ExpressLocalDB のインスタンスを停止します。 -i を追加した場合、NOWAIT オプション付きでインスタンスのシャットダウンを要求します。 -k を追加した場合は、インスタンス プロセスに通知することなく、そのプロセスを停止します。

[ info | i ] [ <instance-name> ]
現在のユーザーが所有する SQL Server ExpressLocalDB のすべてのインスタンスを一覧表示します。

<instance-name> を指定すると、SQL Server ExpressLocalDB の指定したインスタンスの名前、バージョン、状態 (Running または Stopped)、最後の起動時刻に加え、LocalDB のローカル パイプ名が返されます。

[ trace | t ] on | off
trace on を指定すると、現在のユーザーに対して SqlLocalDB の API 呼び出しのトレースが有効になります。 trace off はトレースを無効にします。

-?
SqlLocalDB オプションの簡単な説明が返されます。

解説

引数 instance name は、 SQL Server 識別子のルールに従っているか、二重引用符で囲む必要があります。

引数を指定せずに SqlLocalDB を実行すると、ヘルプ テキストが返されます。

start 以外の操作は、現在ログインしているユーザーに属するインスタンスでのみ実行できます。 SQLLOCALDB インスタンスを共有している場合、そのインスタンスの開始と停止は所有者のみが実行できます。

A. LocalDB のインスタンスを作成する

SQL Server バイナリを使用して DEPARTMENT という名前の SQL Server ExpressLocalDB のインスタンスを作成し、そのインスタンスを起動する例を次に示します。

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

B. LocalDB の共有インスタンスを操作する

管理者権限を使用してコマンド プロンプトを開きます。

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 = 'Passw0rd!!@52';   
GO  
CREATE USER NewLogin;  
GO  
EXIT  

次のコードを実行して、 ログインを使用して、 LocalDB NewLogin の共有インスタンスに接続します。

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P Passw0rd!!@52  

参照

SQL Server 2016 Express LocalDB
コマンドライン管理ツール:SqlLocalDB.exe