Partilhar via


Utilitário SqlLocalDB

Use o SqlLocalDB utilitário para criar uma instância do MicrosoftSQL Server 2014 ExpressLocalDB. O SqlLocalDB utilitário (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 ExpressLocalDB. Para obter informações sobre como usar o LocalDB, consulte SQL Server 2014 Express LocalDB.

Sintaxe

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 ]< nome-da-instância>< versão-da-instância> [-s ]
Cria uma nova instância do SQL Server ExpressLocalDB. SqlLocalDBusa a versão dos binários do SQL Server Express especificada pelo argumento instance-version>.< O número da versão é especificado em formato numérico com pelo menos um decimal. Os números de versões secundárias (pacotes de serviço) são opcionais. Por exemplo, os dois números de versão seguintes são aceitáveis: 11.0 ou 11.0.1186. A versão especificada deve ser estalada no computador. Se não for especificado, o número da versão será padronizado para a versão do SqlLocalDB utilitário. A adição de -s inicia a nova instância do LocalDB.

[ share | h ]
Compartilha a instância privada especificada do LocalDB que usa o nome compartilhado especificado. Se a SID ou o nome de conta do usuário for omitido, o valor padrão será o usuário atual.

[ unshared | u ]
Interrompe o compartilhamento da instância especificada compartilhada do LocalDB.

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

[ start | s ] "<instance-name>"
Inicia a instância especificada do SQL Server ExpressLocalDB. Quando tem êxito, a instrução retorna o endereço de pipe nomeado do LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ]
Interrompe a instância especificada do SQL Server ExpressLocalDB. Adicionar -i solicita o desligamento da instância com a NOWAIT opção. A adição de -k elimina o processo da instância sem contatá-la.

[ info | i ] [ <instance-name> ]
Lista todas as instâncias do SQL Server ExpressLocalDB pertencentes ao usuário atual.

<instance-name> retorna o nome, a versão, o estado (Em execução ou Parado), a hora da última inicialização da instância especificada do SQL Server Express LocalDB e o nome do pipe local do LocalDB.

[ trace | t ] on | off
trace on permite o rastreamento para as chamadas de SqlLocalDB API para o usuário atual. trace off desabilita o rastreamento.

-?
Retorna breves descrições de cada SqlLocalDB opção.

Comentários

O argumento instance name deve seguir as regras de identificadores do SQL Server ou deve ser colocado entre aspas duplas.

A execução do SqlLocalDB sem nenhum argumento retorna o texto da ajuda.

Operações diferentes de iniciar podem ser executados apenas em uma instância que pertence ao usuário conectado no momento.

Exemplos

R. Criando uma instância do LocalDB

O exemplo a seguir cria uma instância do SQL Server ExpressLocalDB nomeada DEPARTMENT usando os binários do SQL Server 2014 e inicia a instância.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

B. Trabalhando com uma instância compartilhada do LocalDB

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

Execute o código a seguir para conectar-se à instância compartilhada do LocalDB usando o logon NewLogin .

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

Confira também

SQL Server 2014 Express LocalDB