APIs de instância do SQL Server Express LocalDB

Applies to: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. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

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 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.

Regras automáticas de nomenclatura de instâncias

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

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

Exemplos de nomes de instâncias automáticas ilegais são:

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

Instâncias nomeadas do LocalDB

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 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

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 em comparação com os nomes de instância tradicionais do SQL Server, que são limitados a 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 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, 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âncias automáticas . Uma tentativa de criar uma instância nomeada com um nome que siga o padrão automático de nomeação de instância cria efetivamente uma instância padrão.

Related tasks