API d’instance SQL Server Express LocalDB

S'applique à :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. On les appelle instances pour souligner cette similarité et les rendre plus intuitives pour les utilisateurs de SQL Server.

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

Les instances automatiques de LocalDB sont publiques ; Ils sont créés et gérés automatiquement pour l’utilisateur et peuvent être utilisés par n’importe quelle application. Une instance LocalDB automatique existe pour chaque version de LocalDB installée sur l’ordinateur de l’utilisateur. Le nom de l’instance automatique de la LocalDB est MSSQLLocalDB.

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.

Instances de localDB nommées

Les instances LocalDB nommées sont privées ; Une instance appartient à une seule application responsable de la création et de la gestion de l’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

Un nom d’instance LocalDB peut contenir jusqu’à 128 caractères (le type de données sysname impose cette limite). Cette limite est une différence significative par rapport aux noms d’instance traditionnels de SQL Server, qui sont limités à des noms NetBIOS de 15 caractères ASCII. La raison de cette différence est que LocalDB considère les bases de données comme des fichiers, ce qui implique donc une sémantique basée sur les fichiers, ce qui permet aux utilisateurs de choisir davantage les 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é.

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 nommage, une instance LocalDB nommée ne peut pas utiliser le nom MSSQLLocalDBd’instance automatique réservé. Une tentative de créer une instance nommée avec ce nom crée effectivement une instance par défaut.

Tâches associées