SqlLocalDB (utilidad)

Utilice la herramienta SqlLocalDB para crear una instancia de Microsoft SQL Server 2012 Express LocalDB. La utilidad SqlLocalDB (SqlLocalDB.exe) es una herramienta de línea de comandos simple que permite a los usuarios y desarrolladores crear y administrar una instancia de SQL Server Express LocalDB. Para obtener más información sobre cómo usar LocalDB, vea SQL Server 2012 Express LocalDB.

Sintaxis

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     | -? ]
}

Argumentos

  • [ create | c ] <instance-name>  <instance-version> [-s ]
    Crea una nueva instancia de SQL Server Express LocalDB. SqlLocalDB utiliza la versión de los archivos binarios de SQL Server Express especificados por el argumento <instance-version>. El número de versión se especifica en formato numérico con al menos un decimal. Los números de versión secundaria (Service Pack) son opcionales. Como los siguientes dos números de versión son aceptables: 11.0 u 11.0.1186. La versión especificada se debe instalar en el equipo. Si no se especifica, el número de versión tiene como valor predeterminado el de la versión de la utilidad SqlLocalDB. La acción de agregar –s inicia la nueva instancia de LocalDB.

  • [ share | h ]
    Comparte la instancia privada especificada de LocalDB mediante el nombre compartido especificado. Si se omite el SID del usuario o el nombre de la cuenta, usa de forma predeterminada el usuario actual.

  • [ unshared | u ]
    Detiene el uso compartido de la instancia compartida especificada de LocalDB.

  • [ delete | d ] <instance-name>
    Elimina la instancia especificada SQL Server Express LocalDB.

  • [ start | s ] "<instance-name>"
    Inicia la instancia especificada de SQL Server Express LocalDB. Cuando se realiza correctamente, la instrucción devuelve la dirección de la canalización con nombre de LocalDB.

  • [ stop | p ] <instance-name> [-i ] [-k ]
    Detiene la instancia especificada de SQL Server Express LocalDB. La acción de agregar –i solicita el cierre de la instancia con la opción NOWAIT. La acción de agregar –k elimina el proceso de la instancia sin ponerse en contacto con ella.

  • [ info | i ] [ <instance-name> ]
    Muestra toda la instancia de SQL Server Express LocalDB que pertenece al usuario actual.

    <instance-name> devuelve el nombre, la versión, el estado (En ejecución o Detenido), la última hora de inicio de la instancia especificada de SQL Server Express LocalDB y el nombre de la canalización local de LocalDB.

  • [ trace | t ] on | off
    trace on habilita el seguimiento de las llamadas a la API de SqlLocalDB para el usuario actual. trace off deshabilita el seguimiento.

  • -?
    Devuelve una descripción breve de cada opción de SqlLocalDB.

Comentarios

El argumento instance name debe cumplir las reglas de los identificadores de SQL Server o debe incluirse entre comillas.

La ejecución de SqlLocalDB sin argumentos devuelve el texto de ayuda.

Las operaciones distintas de la operación de inicio solo se pueden realizar en una instancia perteneciente al usuario que ha iniciado la sesión.

Ejemplos

A.Crear una instancia de LocalDB

En el ejemplo siguiente se crea una instancia de SQL Server Express LocalDB denominada DEPARTMENT utilizando los binarios de SQL Server 2012 y se inicia la instancia.

SqlLocalDB.exe create "DEPARTMENT" 11.0 -s

B.Trabajar con una instancia compartida de LocalDB

Abra un símbolo del sistema utilizando los permisos de administrador.

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

Ejecute el código siguiente para conectarse a la instancia compartida de LocalDB mediante el inicio de sesión de NewLogin .

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

Vea también

Conceptos

SQL Server 2012 Express LocalDB