APIs de instância do SQL Server Express LocalDB

Aplica-se a: SQL Server

No mundo tradicional do SQL Server baseado em serviços, as instâncias individuais do SQL Server instaladas em um único computador são fisicamente separadas. Cada instância deve ser instalada e removida separadamente, tem um conjunto separado de binários e é executada em um processo de serviço separado. O nome da instância do SQL Server é usado para especificar a qual instância do SQL Server o usuário deseja se conectar.

A API de instância LocalDB do SQL Server Express usa um modelo de instância simplificado e leve. Embora instâncias individuais do LocalDB sejam separadas no disco e no registro, elas usam o mesmo conjunto de binários do LocalDB compartilhado. Além disso, o LocalDB não usa serviços. As instâncias LocalDB são executadas sob demanda por meio de chamadas de API de instância LocalDB. No LocalDB, o nome da instância é usado para especificar com quais instâncias do LocalDB o usuário deseja trabalhar.

Uma instância do LocalDB é sempre de propriedade de um único usuário e é visível e acessível somente a partir do contexto desse usuário, a menos que o compartilhamento de instância esteja habilitado.

Embora tecnicamente as instâncias LocalDB não sejam as mesmas que as instâncias tradicionais do SQL Server, seu uso pretendido é semelhante. São chamadas instâncias para enfatizar esta semelhança e torná-las mais intuitivas para os utilizadores do SQL Server.

O LocalDB suporta dois tipos de instâncias: instâncias automáticas (AI) e instâncias nomeadas (NI). O identificador de uma instância LocalDB é o nome da instância.

Instâncias automáticas do LocalDB

As instâncias automáticas do LocalDB são públicas; São criados e geridos automaticamente pelo utilizador e podem ser usados por qualquer aplicação. Existe uma instância automática do LocalDB para cada versão do LocalDB instalada no computador do usuário. O nome da instância automática do LocalDB é MSSQLLocalDB.

As instâncias automáticas do LocalDB fornecem gerenciamento de instâncias contínuo. O usuário não precisa criar a instância. Isso permite que os usuários instalem facilmente aplicativos e migrem para computadores diferentes. 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 nesse computador.

Gerenciamento automático de instâncias

Um usuário não precisa criar uma instância automática do LocalDB. A instância é criada preguiçosamente na primeira vez que é usada, desde que a versão especificada do LocalDB esteja disponível no computador do usuário. Do ponto de vista do usuário, a instância automática estará sempre presente se os binários LocalDB estiverem presentes.

Outras operações de gerenciamento de instâncias, como Excluir, Compartilhar e Descompartilhar, também funcionam para instâncias automáticas. Em particular, excluir uma instância automática efetivamente redefine a instância, que é recriada na próxima operação Start. A exclusão de uma instância automática pode ser necessária se os bancos de dados do sistema forem corrompidos.

Instâncias nomeadas do LocalDB

As instâncias LocalDB nomeadas são privadas; Uma instância pertence a uma única aplicação responsável por criar e gerir a instância. As instâncias nomeadas do LocalDB fornecem isolamento e melhoram o desempenho.

Criação de instância nomeada

O usuário deve criar instâncias nomeadas explicitamente por meio da API de gerenciamento LocalDB ou implicitamente por meio do app.config arquivo de um aplicativo gerenciado. Um aplicativo gerenciado também pode usar a API.

Cada instância nomeada tem uma versão do LocalDB associada; ou seja, ele aponta para um conjunto especificado de binários LocalDB. A versão da instância nomeada é definida durante o processo de criação da instância.

Regras de nomenclatura de instâncias nomeadas

Um nome de instância LocalDB pode ter até 128 caracteres (o tipo de dado sysname impõe este limite). Este limite é uma diferença significativa em relação aos nomes tradicionais de instância do SQL Server, que se limitam a nomes NetBIOS com 15 caracteres ASCII. A razão para esta diferença é que o LocalDB trata as bases de dados como ficheiros e, por isso, implica semântica baseada em ficheiros, pelo que os utilizadores têm mais liberdade na escolha dos nomes das instâncias.

Um nome de instância LocalDB pode conter quaisquer caracteres Unicode que sejam legais dentro do componente de nome de arquivo. Os caracteres ilegais em um componente de nome de arquivo geralmente incluem os seguintes caracteres: caracteres ASCII/Unicode de 1 a 31 e aspas ("), menor que (<), maior que (>), pipe (|), backspace (\b), tab (\t), dois pontos (:), asterisco (*), ponto de interrogação (?), barra invertida (\) e barra (/). O caractere nulo (\0) é permitido porque é usado para terminação de cadeia de caracteres, tudo após o primeiro caractere nulo é ignorado.

Os espaços em branco à esquerda e à direita nos nomes das ocorrências são ignorados e cortados.

Para evitar conflitos de nomenclatura, uma instância LocalDB nomeada não pode usar o nome MSSQLLocalDBautomático reservado da instância . Uma tentativa de criar uma instância nomeada com esse nome cria efetivamente uma instância por defeito.

Tarefas relacionadas