Référence API de l’instance SQL Server Express LocalDB

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 ; autrement dit, 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 simplifié et « léger ». Bien que les instances LocalDB individuelles soient séparées sur le disque et dans le Registre, elles utilisent le même ensemble de fichiers 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 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é.

Même si les instances LocalDB techniques ne sont pas identiques aux instances SQL Server traditionnelles, leur utilisation prévue est similaire. Ils sont appelés instances pour mettre en évidence cette similarité et les rendre plus intuitifs pour les utilisateurs DE SQL Server.

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

Instances localDB automatiques

Les instances LocalDB automatiques 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.

Les instances LocalDB automatiques fournissent une gestion transparente des 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 différents ordinateurs. Si la version spécifiée de LocalDB est installée sur l’ordinateur cible, l’instance localDB automatique de 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, à condition que la version spécifiée de LocalDB soit 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 Delete, Share et Unshare, fonctionnent également pour les instances automatiques. En particulier, la suppression d’une instance automatique réinitialise efficacement l’instance, qui sera recréé 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 LocalDB automatiques ont un modèle spécial pour le nom de l’instance qui appartient à un espace de noms réservé. Cela est nécessaire pour empêcher les conflits de noms avec les instances LocalDB nommées.

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 seul caractère « v ». Cela ressemble à « v » plus deux nombres avec une période entre eux ; par exemple, v11.0 ou V12.00.

Voici quelques exemples de noms d’instances automatiques non valides :

• 11.0 (manquant le caractère « v » au début)

• v11 (période manquante et deuxième numéro 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

Les instances de 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 de localDB nommées fournissent une isolation 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 fichier app.config pour une application managée. Une application managée peut également utiliser l’API.

Chaque instance nommée a une version LocaleDB associée ; autrement dit, il pointe vers un ensemble spécifié de fichiers binaires 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 avoir jusqu’à un total de 128 caractères (la limite est imposée par le sysname type de données). Il s’agit d’une différence significative par rapport aux noms d’instances SQL Server traditionnels, 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 LocalDB peut contenir tous les caractères Unicode qui sont légaux dans le composant de nom de fichier. Les caractères non valides d’un composant de nom de fichier incluent généralement les caractères ASCII/Unicode 1 à 31, ainsi que les guillemets ("), inférieurs à (<), supérieur à (>), pipe (|), retour arrière (\b), tabulation (\t), deux-points (:), astérisque (*), point d’interrogation ( ?), barre oblique inverse (\) et barre oblique (/). Notez que 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 seront 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 « 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.

Rubriques de référence sql Server Express LocalDB

Informations sur l’en-tête et la version SQL Server Express LocalDB
Fournit des informations de fichier d’en-tête et des clés de Registre pour rechercher l’API d’instance LocalDB.

Outil de gestion en ligne de commande : SqlLocalDB.exe
Décrit SqlLocalDB.exe, outil de gestion des instances LocalDB à partir de la ligne de commande.

LocalDBCreateInstance, fonction
Décrit la fonction pour créer une instance LocalDB.

LocalDBDeleteInstance, fonction
Décrit la fonction pour supprimer une instance LocalDB.

LocalDBFormatMessage, fonction
Décrit la fonction pour retourner la description localisée d’une erreur LocalDB.

LocalDBGetInstanceInfo, fonction
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, fonction
Décrit la fonction pour retourner toutes les instances LocalDB avec une version spécifiée.

LocalDBGetVersionInfo, fonction
Décrit la fonction pour retourner des informations pour une version localDB spécifiée.

LocalDBGetVersions, fonction
Décrit la fonction pour retourner toutes les versions de LocalDB disponibles sur un ordinateur.

LocalDBShareInstance, fonction
Décrit la fonction pour partager une instance LocalDB spécifiée.

LocalDBStartInstance, fonction
Décrit la fonction pour démarrer une instance LocalDB spécifiée.

LocalDBStartTracing, fonction
Décrit la fonction pour activer le suivi d’API pour un utilisateur.

LocalDBStopInstance, fonction
Décrit la fonction pour arrêter l’exécution d’une instance LocalDB spécifiée.

LocalDBStopTracing, fonction
Décrit la fonction pour désactiver le suivi d’API pour un utilisateur.

LocalDBUnshareInstance, fonction
Décrit la fonction pour arrêter le partage d’une instance LocalDB spécifiée.