SqlLocalDB (utilidad)SqlLocalDB Utility

En este tema se aplica a: SíSQL Servernobase de datos de SQL Azurenoalmacenamiento de datos de SQL Azure ningún Almacenamiento de datos paralelosTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Utilice la herramienta SqlLocalDB para crear una instancia de MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 ExpressLocalDB.Use the SqlLocalDB utility to create an instance of MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 ExpressLocalDB. 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 ExpressSQL Server Express LocalDB.The SqlLocalDB utility (SqlLocalDB.exe) is a simple command line tool to enable users and developers to create and manage an instance of SQL Server ExpressSQL Server ExpressLocalDB. Para obtener más información sobre cómo usar LocalDB, vea SQL Server 2016 Express LocalDB.For information about how to use LocalDB, see SQL Server 2016 Express LocalDB.

SintaxisSyntax

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

ArgumentosArguments

[ create | c ] <instance-name> <instance-version> [-s ][ create | c ] <instance-name> <instance-version> [-s ]
Crea una instancia de SQL Server ExpressSQL Server ExpressLocalDB.Creates a new of instance of SQL Server ExpressSQL Server ExpressLocalDB. SqlLocalDB usa la versión de los archivos binarios de SQL Server ExpressSQL Server Express especificados por el argumento <instance-version>.SqlLocalDB uses the version of SQL Server ExpressSQL Server Express binaries specified by <instance-version> argument. El número de versión se especifica en formato numérico con al menos un decimal.The version number is specified in numeric format with at least one decimal. Los números de versión secundaria (Service Pack) son opcionales.The minor version numbers (service packs) are optional. Como los siguientes dos números de versión son aceptables: 11.0 u 11.0.1186.For example the following two version numbers are both acceptable: 11.0, or 11.0.1186. La versión especificada se debe instalar en el equipo.The specified version must be installed on the computer. Si no se especifica, el número de versión tiene como valor predeterminado el de la versión de la utilidad SqlLocalDB .If not specified, the version number defaults to the version of the SqlLocalDB utility. Al agregar –s se inicia la nueva instancia de LocalDB.Adding –s starts the new instance of LocalDB.

[ share | h ][ share | h ]
Comparte la instancia privada especificada de LocalDB por medio del nombre compartido especificado.Shares the specified private instance of LocalDB using the specified shared name. Si se omite el SID del usuario o el nombre de la cuenta, usa de forma predeterminada el usuario actual.If the user SID or account name is omitted, it defaults to the current user.

[ unshared | u ][ unshared | u ]
Detiene el uso compartido de la instancia compartida especificada de LocalDB.Stops the sharing of the specified shared instance of LocalDB.

[ delete | d ] <instance-name>[ delete | d ] <instance-name>
Elimina la instancia especificada de SQL Server ExpressSQL Server ExpressLocalDB.Deletes the specified instance of SQL Server ExpressSQL Server ExpressLocalDB.

[ start | s ] "<instance-name>"[ start | s ] "<instance-name>"
Inicia la instancia especificada de SQL Server ExpressSQL Server ExpressLocalDB.Starts the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. Cuando se realiza correctamente, la instrucción devuelve la dirección de la canalización con nombre de LocalDB.When successful the statement returns the named pipe address of the LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ][ stop | p ] <instance-name> [-i ] [-k ]
Detiene la instancia especificada de SQL Server ExpressSQL Server ExpressLocalDB.Stops the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. Al agregar –i se solicita el cierre de la instancia con la opción NOWAIT .Adding –i requests the instance shutdown with the NOWAIT option. Al agregar –k se elimina el proceso de la instancia sin ponerse en contacto con ella.Adding –k kills the instance process without contacting it.

[ info | i ] [ <instance-name> ][ info | i ] [ <instance-name> ]
Muestra toda la instancia de SQL Server ExpressSQL Server Express LocalDB que pertenece al usuario actual.Lists all instance of SQL Server ExpressSQL Server ExpressLocalDB owned by the current user.

<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 ExpressSQL Server ExpressLocalDB y el nombre de la canalización local de LocalDB.<instance-name> returns the name, version, state (Running or Stopped), last start time for the specified instance of SQL Server ExpressSQL Server ExpressLocalDB, and the local pipe name of the LocalDB.

[ trace | t ] on | off[ trace | t ] on | off
trace on habilita el seguimiento de las llamadas a la API de SqlLocalDB para el usuario actual.trace on enables tracing for the SqlLocalDB API calls for the current user. trace off deshabilita el seguimiento.trace off disables tracing.

-?-?
Devuelve una descripción breve de cada opción de SqlLocalDB .Returns brief descriptions of each SqlLocalDB option.

NotasRemarks

El argumento instance name debe cumplir las reglas de los identificadores de SQL ServerSQL Server o debe incluirse entre comillas.The instance name argument must follow the rules for SQL ServerSQL Server identifiers or it must be enclosed in double quotes.

La ejecución de SqlLocalDB sin argumentos devuelve el texto de ayuda.Executing SqlLocalDB without arguments returns the help text.

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.Operations other than start can only be performed on an instance belonging to currently logged in user. Una instancia de SQLLOCALDB, cuando se comparte, solo se puede iniciar y detener por el propietario de la instancia.An SQLLOCALDB Instance, when shared, can only be started and stopped by the owner of the instance.

EjemplosExamples

A.A. Crear una instancia de LocalDBCreating an Instance of LocalDB

En el ejemplo siguiente se crea una instancia de SQL Server ExpressSQL Server ExpressLocalDB denominada DEPARTMENT utilizando los binarios de SQL Server 2017SQL Server 2017 y se inicia la instancia.The following example creates an instance of SQL Server ExpressSQL Server ExpressLocalDB named DEPARTMENT using the SQL Server 2017SQL Server 2017 binaries and starts the instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

B.B. Trabajar con una instancia compartida de LocalDBWorking with a Shared Instance of LocalDB

Abra un símbolo del sistema utilizando los permisos de administrador.Open a command prompt using Administrator privileges.

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 .Execute the following code to connect to the shared instance of LocalDB using the NewLogin login.

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

Ver tambiénSee Also

SQL Server 2016 Express LocalDBSQL Server 2016 Express LocalDB
Herramienta de administración de la línea de comandos: SqlLocalDB.exeCommand-Line Management Tool: SqlLocalDB.exe