Partekatu bidez

Utilidad SqlLocalDB

Se aplica a:SQL Server

Use 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 para permitir a los usuarios y desarrolladores crear y administrar una instancia de SQL Server Express LocalDB. Para obtener información sobre cómo usar LocalDB, vea SQL Server 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. 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 . Agregar -s inicia la nueva instancia de LocalDB.

[ compartir | h ]

Comparte la instancia privada especificada de LocalDB con el 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 ] <nombre de instancia>

Elimina la instancia especificada de SQL Server Express LocalDB.

[ start | s ] "<nombre> de instancia"

Inicia la instancia especificada de SQL Server Express LocalDB. Cuando la instrucción se ejecuta correctamente, devuelve la dirección de 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> ]

Enumera todas las instancias de SQL Server Express LocalDB que pertenecen 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 canalización local de LocalDB.

[ trace | t ] { on | off }

trace on habilita el seguimiento de las llamadas 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

En el ejemplo siguiente se crea una instancia de SQL Server Express LocalDB denominada DEPARTMENT mediante los archivos binarios de SQL Server e inicia 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 NewLogin inicio de sesión. Reemplace <password> por una contraseña válida.

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

Contenido relacionado

  • Last updated on