API d’instance SQL Server Express LocalDB

Applies to:SQL Server

Dans le monde SQL Server traditionnel basé sur le service, les instances SQL Server individuelles installées sur un seul ordinateur sont physiquement séparées. Chaque instance doit être installée et supprimée séparément, possède un ensemble distinct de fichiers binaires et s’exécute sous un processus de service distinct. Le nom de l'instance SQL Server est utilisé pour spécifier l'instance SQL Server à laquelle l'utilisateur souhaite se connecter.

L’API d’instance SQL Server Express LocalDB utilise un modèle d’instance légère simplifié. Bien que les instances LocalDB individuelles soient séparées sur le disque et dans le Registre, elles utilisent le même jeu de binaires LocalDB partagés. De plus, LocalDB n’utilise pas de services. Les instances LocalDB sont lancées à la demande via des appels d’API d’instance LocalDB. Dans LocalDB, le nom de l'instance est utilisé pour spécifier les instances de LocalDB avec lesquelles l'utilisateur souhaite travailler.

Une instance LocalDB appartient toujours à un seul utilisateur et est visible et accessible uniquement à partir du contexte de cet utilisateur, sauf si le partage d’instance est activé.

Bien que les instances LocalDB techniques ne soient pas les mêmes que les instances SQL Server traditionnelles, leur utilisation prévue est similaire. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

LocalDB prend en charge deux types d'instances : les instances automatiques (AI) et les instances nommées (NI). L'identificateur d'une instance de LocalDB est le nom de l'instance.

Instances LocalDB automatiques

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Une instance LocalDB automatique existe pour chaque version de LocalDB installée sur l’ordinateur de l’utilisateur.

Les instances automatiques de LocalDB fournissent la gestion transparente d'instances. L’utilisateur n’a pas besoin de créer l’instance. Cela permet aux utilisateurs d'installer facilement des applications et de migrer vers d'autres ordinateurs. Si la version spécifiée de LocalDB est installée sur l'ordinateur, l'instance automatique de LocalDB pour cette version est également disponible sur cet ordinateur.

Gestion automatique des instances

Un utilisateur n’a pas besoin de créer une instance LocalDB automatique. L’instance est créée de manière différée la première fois que l’instance est utilisée, tant que la version spécifiée de LocalDB est disponible sur l’ordinateur de l’utilisateur. Du point de vue de l’utilisateur, l’instance automatique est toujours présente si les fichiers binaires LocalDB sont présents.

D'autres opérations de gestion d'instances, telles que la suppression, le partage et l'annulation du partage, s'exécutent également pour les instances automatiques. En particulier, la suppression d’une instance automatique réinitialise efficacement l’instance, qui est recréée lors de la prochaine opération de démarrage. La suppression d’une instance automatique peut être nécessaire si les bases de données système sont endommagées.

Règles de nommage d’instance automatique

Les instances automatiques de LocalDB ont un modèle particulier pour le nom de l'instance qui appartient à un espace de noms réservé. Cela est nécessaire pour éviter des conflits de noms avec les instances nommées de LocalDB.

Le nom de l’instance automatique est le numéro de version de la base de référence LocalDB précédé d’un caractère unique v . Cela ressemble à v plus deux nombres avec une période entre eux ; par exemple, v11.0 ou V12.00.

Voici des exemples de noms d'instance automatique non conformes :

• 11.0 (manquant le v caractère au début)
• v11 (il manque une période et le deuxième nombre de la version)
• v11. (manquant le deuxième nombre de la version)
• v11.0.1.2 (Le numéro de version comporte plus de deux parties)

Instances de localDB nommées

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. Les instances nommées de LocalDB fournissent l'isolement et améliorent les performances.

Création d’une instance nommée

L’utilisateur doit créer des instances nommées explicitement via l’API de gestion LocalDB, ou implicitement via le app.config fichier d’une application managée. Une application managée peut également utiliser l’API.

Chaque instance nommée possède une version associée de LocalDB ; autrement dit, elle indique un jeu de binaires de LocalDB. La version de l'instance nommée est définie pendant le processus de création de l'instance.

Règles de nommage d’instance nommée

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Il s'agit d'une différence importante comparée aux noms d'instances SQL Server traditionnelles, qui sont limités aux noms NetBIOS de 16 caractères ASCII. La raison de cette différence est que LocalDB traite les bases de données en tant que fichiers, et implique donc une sémantique basée sur des fichiers, de sorte qu’il est intuitif pour les utilisateurs d’avoir plus de liberté dans le choix des noms d’instance.

Un nom d'instance de LocalDB peut contenir tous les caractères Unicode qui sont valides dans le composant nom de fichier. Les caractères non autorisés dans un composant de nom de fichier incluent généralement les caractères SUIVANTS : caractères ASCII/Unicode 1 à 31 et guillemets ("), inférieurs à (<), supérieur à (>), canal (|), retour arrière (), tabulation\b (\t), signe deux-points (:), astérisque (), point d’interrogation (*?), barre oblique inverse (\) et barre oblique (/). Le caractère Null (\0) est autorisé, car il est utilisé pour l’arrêt de chaîne ; tout ce qui suit le premier caractère null est ignoré.

Note

La liste des caractères non valides peut dépendre du système d’exploitation et peut changer dans les versions ultérieures.

Les espaces blancs de début et de fin dans les noms d’instances sont ignorés et supprimés.

Pour éviter les conflits de noms, les instances LocalDB nommées ne peuvent pas avoir de nom qui suit le modèle d’affectation de noms pour les instances automatiques, comme décrit précédemment dans la section Règles d’affectation de noms d’instance automatique . Une tentative de création d’une instance nommée avec un nom qui suit le modèle de nommage automatique d’instance crée efficacement une instance par défaut.

Related tasks

Article	Description
Informations de version et d’en-tête SQL Server Express LocalDB	Fournit des informations sur le fichier d'en-tête et les clés de Registre pour rechercher l'API d'instance de LocalDB.
Outil de gestion en ligne de commande : SqlLocalDB.exe	Décrit SqlLocalDB.exe, un outil de gestion des instances de LocalDB à partir de la ligne de commande.
LocalDBCreateInstance Function	Décrit la fonction pour créer une nouvelle instance de LocalDB.
LocalDBDeleteInstance Function	Décrit la fonction pour supprimer une instance de LocalDB.
LocalDBFormatMessage Function	Décrit la fonction pour retourner la description localisée d'une erreur de LocalDB.
LocalDBGetInstanceInfo Function	Décrit la fonction pour obtenir des informations pour une instance LocalDB, par exemple s’il existe, les informations de version, si elle est en cours d’exécution, etc.
LocalDBGetInstances Function	Décrit la fonction pour retourner toutes les instances de LocalDB avec une version spécifiée.
LocalDBGetVersionInfo Function	Décrit la fonction pour retourner des informations sur une version spécifiée de LocalDB.
LocalDBGetVersions Function	Décrit la fonction pour retourner toutes les versions de LocalDB disponibles sur un ordinateur.
LocalDBShareInstance Function	Décrit la fonction pour partager une instance spécifiée de LocalDB.
LocalDBStartInstance Function	Décrit la fonction pour démarrer une instance spécifiée de LocalDB.
LocalDBStartTracing Function	Décrit la fonction pour activer le suivi d'API pour un utilisateur.
LocalDBStopInstance Function	Décrit la fonction pour cesser l'exécution d'une instance spécifiée de LocalDB.
LocalDBStopTracing Function	Décrit la fonction pour désactiver le suivi d'API pour un utilisateur.
LocalDBUnshareInstance Function	Décrit la fonction pour cesser le partage d'une instance spécifiée de LocalDB.