Utilidad SqlLocalDB

Artículo
05/30/2023

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. 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.

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. 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 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. Una instancia de SQLLOCALDB, cuando se comparte, solo se puede iniciar y detener por el propietario de la instancia.

Ejemplos

A. Creación de una instancia de LocalDB

En el ejemplo a continuación se utilizan los binarios de SQL Server y se inicia la instancia para crear una instancia de SQL Server Express LocalDB denominada DEPARTMENT.

SqlLocalDB.exe create "DEPARTMENT" 12.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

Compartir vía