Utilidad SqlLocalDB

2025-04-21

Se aplica a:SQL Server

Utilice la utilidad SqlLocalDB para crear una instancia de SQL Server Express LocalDB. La utilidad SqlLocalDB (SqlLocalDB.exe) es una herramienta de línea de comandos simple que permite a los usuarios y los desarrolladores crear y administrar una instancia de SQL Server ExpressLocalDB. Para obtener más información sobre cómo usar LocalDB, vea SQL Server 2016 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 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. Las versiones menores (paquetes de servicio) son opcionales. Por ejemplo, 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.

Comparte la instancia privada especificada de LocalDB por medio del nombre compartido especificado. Si se omite el SID del usuario o el nombre de la cuenta, usa de forma predeterminada el usuario actual.

[ unshare | u ]

Detiene el uso compartido de la instancia compartida especificada de LocalDB.

[ delete | d ] <instance-name>

Elimina la instancia especificada de SQL Server Express LocalDB.

[ start | s ] "<instance-name>"

Inicia la instancia especificada de SQL Server Express LocalDB. Al realizarse 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. Agregar -i solicita el apagado 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 ExpressLocalDB 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 .

Observaciones

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 sesión. Solo el propietario de la instancia de SQLLOCALDB puede iniciarla y detenerla cuando se comparte.

Ejemplos

A. Creación de una instancia de LocalDB

El siguiente ejemplo crea una instancia de SQL Server Express LocalDB denominada DEPARTMENT utilizando los binarios de SQL Server y arranca la instancia.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Trabajar con una instancia compartida de LocalDB

Abra una ventana de comandos utilizando privilegios de administrador. Reemplace <password> por una contraseña válida.

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

Ejecute el código siguiente para conectarse a la instancia compartida de LocalDB mediante el inicio de sesión de NewLogin . Reemplace <password> por una contraseña válida.

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P <password>