Compartilhar via

Utilitário SqlLocalDB

Aplica-se:SQL Server

Use o utilitário SqlLocalDB para criar uma instância do SQL Server Express LocalDB. O utilitário sqlLocalDB (SqlLocalDB.exe) é uma ferramenta de linha de comando para permitir que usuários e desenvolvedores criem e gerenciem uma instância do SQL Server Express LocalDB. Para obter informações sobre como usar o LocalDB, consulte SQL Server 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 ] <instance-name><instance-version> [ -s ]

Cria uma nova instância do SQL Server Express LocalDB. O SqlLocalDB usa a versão de 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ão menores (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 instalada no computador. Se não especificado, o número da versão será padronizado como a versão do utilitário SqlLocalDB . A adição -s inicia a nova instância do LocalDB.

[ compartilhar | h ]

Compartilha a instância privada especificada do LocalDB usando 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.

[ cancelar compartilhamento | c ]

Interrompe o compartilhamento da instância compartilhada especificada do LocalDB.

[ delete | d ] <nome-da-instância>

Exclui a instância especificada do SQL Server Express LocalDB.

[ start | s ] "<nome da instância>"

Inicia a instância especificada do SQL Server Express LocalDB. Quando bem-sucedida, a instrução retorna o endereço do canal nomeado do LocalDB.

[ parar | p ] <nome-da-instância> [ -i ] [ -k ]

Interrompe a instância especificada do SQL Server Express LocalDB. A adição de -i solicita o desligamento da instância com a opção NOWAIT. A adição de -k encerra o processo da instância sem contatá-la.

[ informações | i ] [ <nome-da-instância> ]

Lista todas as instâncias do SQL Server Express LocalDB de propriedade do usuário atual.

<o nome> da instância retorna o nome, a versão, o estado (Em execução ou parado), a hora de início da instância especificada do SQL Server Express LocalDB e o nome do pipe local do LocalDB.

[ trace | t ] { ligado | desligado }

trace on habilita o rastreamento das chamadas à API SqlLocalDB para o usuário atual. trace off desabilita o rastreamento.

-?

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

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 da inicialização podem ser executadas apenas em uma instância que pertence ao usuário conectado no momento. Quando compartilhada, uma instância do SQLLOCALDB só pode ser iniciada e interrompida pelo proprietário.

Exemplos

A. Criar uma instância do LocalDB

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

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Trabalhar com uma instância compartilhada do LocalDB

Abrir um prompt de comando usando privilégios de administrador. Substitua <password> por uma senha 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

Execute o código a seguir para se conectar à instância compartilhada do LocalDB usando o NewLogin logon. Substitua <password> por uma senha válida.

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

Conteúdo relacionado

  • Last updated on