Utilitário SqlLocalDBSqlLocalDB Utility

Este tópico aplica-se a: Simdo SQL Serversembanco de dados do SQL AzuresemAzure SQL Data Warehouse sem Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse Use o SqlLocalDB utilitário para criar uma instância de MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 Express LocalDB. Use the SqlLocalDB utility to create an instance of MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 ExpressLocalDB. O utilitário SqlLocalDB (SqlLocalDB.exe) é uma ferramenta de linha de comando simples para permitir que usuários e desenvolvedores criem e gerenciem uma instância do SQL Server ExpressSQL Server ExpressLocalDB.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 obter informações sobre como usar o LocalDB, consulte SQL Server 2016 Express LocalDB.For information about how to use LocalDB, see SQL Server 2016 Express LocalDB.

SintaxeSyntax

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 ]
Cria uma nova instância do SQL Server ExpressSQL Server ExpressLocalDB.Creates a new of instance of SQL Server ExpressSQL Server ExpressLocalDB. SqlLocalDB usa a versão de SQL Server ExpressSQL Server Express binários especificados por <versão da instância > argumento.SqlLocalDB uses the version of SQL Server ExpressSQL Server Express binaries specified by <instance-version> argument. O número da versão é especificado em formato numérico com pelo menos um decimal.The version number is specified in numeric format with at least one decimal. Os números de versões secundárias (pacotes de serviço) são opcionais.The minor version numbers (service packs) are optional. Por exemplo, os dois números de versão seguintes são aceitáveis: 11.0 ou 11.0.1186.For example the following two version numbers are both acceptable: 11.0, or 11.0.1186. A versão especificada deve ser estalada no computador.The specified version must be installed on the computer. Se não especificado, o número da versão será padronizado como a versão do utilitário SqlLocalDB .If not specified, the version number defaults to the version of the SqlLocalDB utility. A adição de –s inicia a nova instância do LocalDB.Adding –s starts the new instance of LocalDB.

[ share | h ][ share | h ]
Compartilha a instância privada especificada do LocalDB que usa o nome compartilhado especificado.Shares the specified private instance of LocalDB using the specified shared name. Se a SID ou o nome de conta do usuário for omitido, o valor padrão será o usuário atual.If the user SID or account name is omitted, it defaults to the current user.

[ unshared | u ][ unshared | u ]
Interrompe o compartilhamento da instância especificada compartilhada do LocalDB.Stops the sharing of the specified shared instance of LocalDB.

[ delete | d ] <instance-name>[ delete | d ] <instance-name>
Exclui a instância especificada do SQL Server ExpressSQL Server ExpressLocalDB.Deletes the specified instance of SQL Server ExpressSQL Server ExpressLocalDB.

[ start | s ] "<instance-name>"[ start | s ] "<instance-name>"
Inicia a instância especificada do SQL Server ExpressSQL Server ExpressLocalDB.Starts the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. Quando tem êxito, a instrução retorna o endereço de pipe nomeado do 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 ]
Interrompe a instância especificada do SQL Server ExpressSQL Server ExpressLocalDB.Stops the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. A adição de –i solicita o desligamento da instância com a opção NOWAIT .Adding –i requests the instance shutdown with the NOWAIT option. A adição de –k elimina o processo da instância sem contatá-la.Adding –k kills the instance process without contacting it.

[ info | i ] [ <instance-name> ][ info | i ] [ <instance-name> ]
Lista todas as instâncias do SQL Server ExpressSQL Server ExpressLocalDB de propriedade do usuário atual.Lists all instance of SQL Server ExpressSQL Server ExpressLocalDB owned by the current user.

<nome da instância > retorna o nome, versão, o estado (em execução ou parado), última hora de início para a instância especificada do SQL Server ExpressSQL Server Express LocalDBe o nome do pipe local do 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 rastreamento para as chamadas à API do SqlLocalDB para o usuário atual.trace on enables tracing for the SqlLocalDB API calls for the current user. trace off desabilita o rastreamento.trace off disables tracing.

-?-?
Retorna descrições breves de cada opção de SqlLocalDB .Returns brief descriptions of each SqlLocalDB option.

ComentáriosRemarks

O argumento instance name deve seguir as regras de identificadores do SQL ServerSQL Server ou deve ser colocado entre aspas duplas.The instance name argument must follow the rules for SQL ServerSQL Server identifiers or it must be enclosed in double quotes.

A execução de SqlLocalDB sem argumentos retorna o texto da ajuda.Executing SqlLocalDB without arguments returns the help text.

Operações diferentes de iniciar podem ser executados apenas em uma instância que pertence ao usuário conectado no momento.Operations other than start can only be performed on an instance belonging to currently logged in user. Quando compartilhada, uma instância do SQLLOCALDB só pode ser iniciada e interrompida pelo proprietário da instância.An SQLLOCALDB Instance, when shared, can only be started and stopped by the owner of the instance.

ExemplosExamples

A.A. Criando uma instância do LocalDBCreating an Instance of LocalDB

O exemplo a seguir cria uma instância do SQL Server ExpressSQL Server ExpressLocalDB denominada DEPARTMENT que usa os binários do SQL Server 2017SQL Server 2017 e inicia a instância.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. Trabalhando com uma instância compartilhada do LocalDBWorking with a Shared Instance of LocalDB

Abrir um prompt de comando usando privilégios 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  

Execute o código a seguir para conectar-se à instância compartilhada do LocalDB usando o logon 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  

Consulte tambémSee Also

SQL Server 2016 Express LocalDBSQL Server 2016 Express LocalDB
Ferramenta de gerenciamento da linha de comando: SqlLocalDB.exeCommand-Line Management Tool: SqlLocalDB.exe