APIs de instância do SQL Server Express LocalDB

Applies to:SQL Server

No mundo tradicional do SQL Server baseado em serviço, as instâncias individuais do SQL Server instaladas em um único computador são separadas fisicamente. 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 do SQL Server Express LocalDB usa um modelo de instância leve simplificado. Embora as instâncias de LocalDB individuais estejam separadas no disco e no Registro, elas usam o mesmo conjunto de binários de LocalDB compartilhados. Além disso, o LocalDB não usa serviços. As instâncias do LocalDB são iniciadas sob demanda por meio de chamadas à API de instância do LocalDB. No LocalDB, o nome de instância é usado para especificar com qual das instâncias de LocalDB o usuário deseja trabalhar.

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

Embora tecnicamente as instâncias do LocalDB não sejam iguais às instâncias tradicionais do SQL Server, seu uso pretendido é semelhante. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

Instâncias automáticas do LocalDB

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. 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 de LocalDB fornecem gerenciamento de instância contínuo. O usuário não precisa criar a instância. Isso permite que os usuários instalem facilmente os aplicativos e migrem para computadores diferentes. Se o computador de destino tiver a versão especificada de LocalDB instalada, a instância automática de LocalDB para essa versão também estará disponível nesse computador.

Gerenciamento automático de instância

Um usuário não precisa criar uma instância automática do LocalDB. A instância é criada lentamente na primeira vez em que a instância é 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 do LocalDB estiverem presentes.

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

Regras de nomenclatura de instância automática

As instâncias automáticas de LocalDB têm um padrão especial para o nome de instância que pertence a um namespace reservado. Isso é necessário para impedir conflitos de nomes com instâncias de LocalDB nomeadas.

O nome da instância automática é o número de versão da versão da linha de base do LocalDB precedido por um único v caractere. Isso se parece v com mais dois números com um período entre eles; por exemplo, v11.0 ou V12.00.

Exemplos de nomes de instância automática ilegais:

• 11.0 (faltando o v caractere no início)
• v11 (faltando um período e o segundo número da versão)
• v11. (faltando o segundo número da versão)
• v11.0.1.2 (O número de versão tem mais de duas partes)

Instâncias de LocalDB nomeadas

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. As instâncias de LocalDB nomeadas 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 do LocalDB ou implicitamente por meio do app.config arquivo para um aplicativo gerenciado. Um aplicativo gerenciado também pode usar a API.

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

Regras de nomenclatura de instância nomeadas

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Essa é uma diferença significativa se comparada aos nomes de instância tradicionais do SQL Server, que são limitados aos nomes NetBIOS de 16 caracteres ASCII. A razão para essa diferença é que o LocalDB trata bancos de dados como arquivos e, portanto, implica semântica baseada em arquivo, portanto, é intuitivo para os usuários terem mais liberdade na escolha de nomes de instância.

Um nome de instância de LocalDB pode conter qualquer caractere Unicode que seja legal no componente de nome de arquivo. 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), guia (\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.

Espaços em branco à esquerda e à direita em nomes de instância são ignorados e cortados.

Para evitar conflitos de nomenclatura, as instâncias nomeadas do LocalDB não podem ter um nome que siga o padrão de nomenclatura para instâncias automáticas, conforme descrito anteriormente na seção regras de nomenclatura de instância automática . Uma tentativa de criar uma instância nomeada com um nome que segue o padrão de nomenclatura de instância automática cria efetivamente uma instância padrão.

Related tasks