SqlLocalDB ユーティリティ

適用対象:SQL Server

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

[ share | h ]

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

[ unshared | 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 の共有インスタンスを操作する

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

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

関連項目