SQL Server 2012 Express LocalDB

Microsoft SQL Server 2012 Express LocalDB é um modo de execução do SQL Server Express destinado a desenvolvedores de programas. A instalação do LocalDB copia um conjunto mínimo de arquivos necessários para iniciar o Mecanismo de Banco de Dados do SQL Server. Quando o LocalDB é instalado, os desenvolvedores iniciam uma conexão usando uma cadeia de conexão especial. Na conexão, a infraestrutura necessária do SQL Server é criada e iniciada automaticamente, permitindo que o aplicativo use o banco de dados sem tarefas de configuração complexas ou demoradas. O Developer Tools pode fornecer aos desenvolvedores um Mecanismo de Banco de Dados do SQL Server que permite que eles gravem e testem o código Transact-SQL sem precisar gerenciar uma instância de servidor inteira do SQL Server. Uma instância do SQL Server Express LocalDB é gerenciada com o utilitário SqlLocalDB.exe. SQL Server Express LocalDB deve ser usado no lugar do recurso de instância do usuário SQL Server Express que foi preterido.

Instalando o LocalDB

O principal método de instalação do LocalDB é usar o programa SqlLocalDB.msi. O LocalDB é uma opção na instalação de qualquer SKU do SQL Server 2012 Express. Selecione LocalDB na página Seleção de Recursos durante a instalação do SQL Server Express. Pode haver somente uma instalação dos arquivos binários do LocalDB para cada versão principal do Mecanismo de Banco de Dados do SQL Server. Vários processos do Mecanismo de Banco de Dados podem ser iniciados e todos usarão os mesmos binários. Uma instância do Mecanismo de Banco de Dados do SQL Server iniciada como LocalDB tem as mesmas limitações do SQL Server Express

Descrição

O programa de instalação do LocalDB usa o programa SqlLocalDB.msi para instalar os arquivos necessários no computador. Uma vez instalado, o LocalDB torna-se uma instância do SQL Server Express que pode criar e abrir bancos de dados do SQL Server. Os arquivos de banco de dados do sistema para o banco de dados são armazenados no caminho de AppData local dos usuários, que normalmente é oculto. Por exemplo C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\. Os arquivos de banco de dados do usuário são armazenados onde o usuário determina, normalmente em algum lugar da pasta C:\Users\<user>\Documents\.

Para obter mais informações sobre como incluir LocalDB em um aplicativo, consulte a Visual Studio documentação Local Data Overview (Visão geral de dados locais), passo a passo: Creating a SQL Server LocalDB Database (Criando um banco de dados LocalDB do SQL Server), e o passo a passo: Connecting to Data in a SQL Server LocalDB Database (Windows Forms) (Conectando a dados em um banco de dados LocalDB do SQL Server (Windows Forms)).

Para obter mais informações sobre a API do LocalDB, consulte Referência de API da instância LocalDB do SQL Server Express e Função LocalDBStartInstance.

O utilitário SqlLocalDb pode criar novas instâncias do LocalDB, iniciar e interromper uma instância do LocalDB, e contém opções para ajudar a gerenciar o LocalDB. Para obter mais informações sobre o utilitário SqlLocalDb, consulte Utilitário SqlLocalDB.

O agrupamento de instância para LocalDB é definido como SQL_Latin1_General_CP1_CI_AS e não pode ser alterado. Normalmente há suporte para agrupamentos nos níveis de banco de dados, de coluna e de expressão. Os bancos de dados independentes seguem os metadados e as regras de agrupamentos tempdb definidas por Agrupamentos de banco de dados contidos.

Restrições

O LocalDB não pode ser um assinante de replicação de mesclagem.

O LocalDB não dá suporte a FILESTREAM.

O LocalDB só permite filas locais para Service Broker.

Uma instância de LocalDB pertencente as contas internas, como NT AUTHORITY\SYSTEM pode ter problemas de capacidade de gerenciamento em razão do redirecionamento de sistema de arquivos do Windows; em vez disso, use uma conta normal do Windows como o proprietário.

Instâncias automáticas e nomeadas

LocalDB dá suporte a dois tipos de instâncias: Instâncias automáticas e instâncias nomeadas.

• As instâncias automáticas do LocalDB são públicas. Elas são criadas e gerenciadas automaticamente para o usuário e podem ser usadas por qualquer aplicativo. Existe uma instância automática do LocalDB para cada versão do LocalDB instalada no computador do usuário. As instâncias automáticas do LocalDB fornecem gerenciamento de instância contínuo. Não há necessidade de criar a instância; assim é o suficiente. Isso facilita a instalação e migração do aplicativo para um computador diferente. Se o computador de destino tiver a versão especificada do LocalDB instalada, a instância automática do LocalDB para essa versão também estará disponível no computador de destino. As instâncias automáticas do LocalDB têm um padrão especial para o nome de instância que pertence a um namespace reservado. Isso evita conflitos de nomes com instâncias nomeadas do LocalDB. O nome da instância automática é um único caractere v seguido do número da versão do LocalDB no formato xx.x. Por exemplo, v11.0 representa o SQL Server 2012.

• As instâncias nomeadas do LocalDB são privadas. Elas pertencem a um único aplicativo, que é responsável por criar e gerenciar a instância. As instâncias nomeadas fornecem isolamento de outras instâncias e melhoram o desempenho reduzindo a contenção de recursos com outros usuários de banco de dados. As instâncias nomeadas devem ser criadas explicitamente pelo usuário por meio da API de gerenciamento do LocalDB ou implicitamente por meio do arquivo app.config para um aplicativo gerenciado (embora o aplicativo gerenciado também possa usar a API, se desejado). Cada instância nomeada do LocalDB tem uma versão associada do LocalDB que aponta para o conjunto respectivo de binários do LocalDB. O nome da instância do LocalDB é o tipo de dados sysname e pode ter até 128 caracteres. (Isso difere das instâncias nomeadas normais do SQL Server, que limitam os nomes a nomes NetBIOS normais de 16 caracteres ASCII.) O nome de uma instância do LocalDB pode conter qualquer caractere Unicode legal em um nome de arquivo. Uma instância nomeada que usa um nome de instância automático torna-se uma instância automática.

Usuários diferentes de um computador podem ter instâncias com o mesmo nome. Cada instância é um processo diferente executado como um usuário diferente.

Instâncias compartilhadas do LocalDB

Para oferecer suporte a cenários onde vários usuários do computador precisam se conectar a uma única instância do LocalDB, o LocalDB oferece suporte ao compartilhamento de instâncias. O proprietário de uma instância pode optar por permitir que os outros usuários do computador se conectem à sua instância. As instâncias automáticas e nomeadas do LocalDB podem ser compartilhadas. Para compartilhar uma instância do LocalDB, o usuário seleciona um nome compartilhado (alias) para isso. Como o nome compartilhado fica visível para todos os usuários do computador, ele deve ser exclusivo no computador. O nome compartilhado de uma instância do LocalDB tem o mesmo formato da instância nomeada do LocalDB.

Somente um administrador no computador pode criar uma instância compartilhada do LocalDB. Uma instância compartilhada do LocalDB pode ser descompartilhada por um administrador ou pelo proprietário da instância compartilhada do LocalDB. Para compartilhar e descompartilhar uma instância do LocalDB, use os métodos LocalDBShareInstance e LocalDBUnShareInstance da API do LocalDB ou as opções de compartilhamento e descompartilhamento do utilitário SqlLocalDb.

Iniciando o LocalDB e conectando-se ao LocalDB

Conectando-se à instância automática

A maneira mais fácil de usar o LocalDB é conectar-se à instância automática pertencente ao usuário atual usando a cadeia de conexão "Server=(localdb)\v11.0;Integrated Security=true". Para se conectar a um banco de dados específico usando o nome do arquivo, conecte-se usando uma cadeia de conexão semelhante a "Server=(LocalDB)\v11.0; Integrated Security=true ;AttachDbFileName=D:\Data\MyDB1.mdf".

Observação
A primeira vez que o usuário de um computador tenta conectar-se ao LocalDB, a instância automática deve ser criada e iniciada. A tempo adicional para a criação da instância pode causar a falha da tentativa de conexão com uma mensagem de tempo esgotado. Quando isso acontecer, espere alguns segundos para deixar o processo de criação terminar e conecte novamente.

Criando e conectando-se a instâncias nomeadas

Além da instância automática, o LocalDB também oferece suporte a instâncias nomeadas. Use o programa SqlLocalDB.exe para criar, iniciar e interromper uma instância nomeada do LocalDB. Para obter mais informações sobre o SqlLocalDB.exe, consulte Utilitário SqlLocalDB.

REM Create an instance of LocalDB
"C:\Program Files\Microsoft SQL Server\110\Tools\Binn\SqlLocalDB.exe" create LocalDBApp1
REM Start the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\110\Tools\Binn\SqlLocalDB.exe" start LocalDBApp1
REM Gather information about the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\110\Tools\Binn\SqlLocalDB.exe" info LocalDBApp1

A última linha acima, retorna informações semelhantes a estas:

Nome	"LocalDBApp1"
Versão	<Versão atual>
Nome compartilhado	""
Proprietário	"<Seu usuário do Windows>"
Criar automaticamente	Não
Estado	executando
Hora da última inicialização	<Data e hora>
Nome do pipe da instância	np:\\. \pipe\LOCALDB#F365A78E\tsql\query

Observação

Se o aplicativo usa uma versão do .NET anterior à 4.0.2, conecte-se diretamente ao pipe nomeado do LocalDB. O valor de Nome do pipe da instância é o pipe nomeado que a instância do LocalDB está ouvindo. A parte do nome do pipe da instância após LOCALDB# mudará sempre que a instância do LocalDB for iniciada. Para conectar-se à instância do LocalDB usando o SQL Server Management Studio, digite o nome do pipe da instância na caixa Nome do servidor da caixa de diálogo Conectar-se aMecanismo de Banco de Dados. De seu programa personalizado você pode estabelecer conexão com a instância do LocalDB usando uma cadeia de conexão semelhante a SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");

Conectando-se a uma instância compartilhada do LocalDB

Para conectar-se a uma instância compartilhada do LocalDB adicione .\ (ponto + barra invertida) à cadeia de conexão para fazer referência ao namespace reservado para instâncias compartilhadas. Por exemplo, para se conectar a uma instância compartilhada do LocalDB denominada AppData use uma cadeia de conexão como (localdb)\.\AppData como parte da cadeia de conexão. Um usuário que se conecta a uma instância compartilhada do LocalDB que não pertence a ele deve ter uma Autenticação do Windows ou um logon de Autenticação do SQL Server.

Solução de problemas

Para obter informações sobre como solucionar problemas do LocalDB, consulte Solucionando problemas do SQL Server 2012 Express LocalDB.

Permissões

Uma instância do SQL Server 2012 Express LocalDB é uma instância criada por um usuário para seu próprio uso. Qualquer usuário no computador pode criar um banco de dados usando uma instância do LocalDB, armazenando arquivos sob o seu perfil do usuário e executando o processo sob suas credenciais. Por padrão, o acesso para a instância de LocalDB é limitado a seu proprietário. Os dados contidos no LocalDB são protegidos pelo acesso de sistema de arquivos aos arquivos de banco de dados. Se os arquivos de banco de dados do usuário estiverem armazenados em um local compartilhado, o banco de dados poderá ser aberto por qualquer pessoa com acesso de sistema de arquivos ao local, usando uma instância de LocalDB de sua propriedade. Se os arquivos de banco de dados estiverem em um local protegido, como a pasta de dados de usuários, somente esse usuário e os administradores com acesso a essa pasta poderão abrir o banco de dados. Os arquivos do LocalDB somente podem ser abertos por uma instância do LocalDB de cada vez.

Observação
O LocalDB sempre é executado sob o contexto de segurança de usuários; ou seja, o LocalDB nunca é executado com credenciais do grupo de Administradores local. Isto significa que todos os arquivos de banco de dados usados por uma instância do LocalDB devem estar acessíveis usando a conta de Windows do usuário proprietário, sem considerar a associação no grupo de Administradores local.

Consulte também

Referência

Utilitário SqlLocalDB