Utilitaire SqlLocalDB

Article
11/19/2024

S'applique à : SQL Server

Utilisez l’utilitaire SqlLocalDB pour créer une instance de Base de données locale SQL Server Express. L’utilitaire SqlLocalDB (SqlLocalDB.exe) est un outil en ligne de commande qui permet aux utilisateurs et développeurs de créer et gérer une instance de Base de données locale SQL Server Express. Pour plus d’informations sur l’utilisation de LocalDB, consultez SQL Server 2016 Express LocalDB.

Syntaxe

SqlLocalDB.exe
{
      [ create   | c ] <instance-name> <instance-version> [-s ]
    | [ delete   | d ] <instance-name>
    | [ start    | s ] <instance-name>
    | [ stop     | p ] <instance-name>  [ -i ] [ -k ]
    | [ share    | h ] ["<user_SID>" | "<user_account>" ] "<private-name>" "<shared-name>"
    | [ unshare  | u ] "<shared-name>"
    | [ info     | i ] <instance-name>
    | [ versions | v ]
    | [ trace    | t ] [ on | off ]
    | [ help     | -? ]
}

Arguments

[ create | c ] <instance-name> <instance-version> [-s ]

Crée une instance de Base de données locale SQL Server Express. SqlLocalDB utilise la version des binaires SQL Server Express spécifiée par l’argument <instance-version>. Le numéro de version est spécifié au format numérique avec au moins une décimale. Les numéros de version secondaire (Service Packs) sont facultatifs. Par exemple, les deux numéros de version suivants sont acceptables : 11.0 ou 11.0.1186. La version spécifiée doit être installée sur l'ordinateur. S'il n'est pas spécifié, le numéro de version a par défaut la version de l'utilitaire SqlLocalDB . L'ajout de -s permet de démarrer la nouvelle instance de Base de données locale.

Partage l’instance privée spécifiée de LocalDB à l’aide du nom partagé spécifié. Si le SID ou le nom de compte de l'utilisateur est omis, il prend par défaut la valeur de l'utilisateur actuel.

[ arrêter le partage | u ]

Arrête le partage de l’instance partagée spécifiée de LocalDB.

[ delete | d ] <nom_instance-name>

Supprime l’instance spécifiée de Base de données locale SQL Server Express.

[ start | s ] "<nom_instance>"

Démarre l’instance spécifiée de Base de données locale SQL Server Express. En cas de réussite de l'opération, l'instruction retourne l'adresse du canal nommé de LocalDB.

[ stop | p ] <nom_instance> [-i ] [-k ]

Arrête l’instance spécifiée de Base de données locale SQL Server Express. L'ajout de -i demande l'arrêt de l'instance avec l'option NOWAIT. L'ajout de -k met fin au processus de l'instance sans le contacter.

[ info | i ] [ <nom_instance> ]

Liste toutes les instances de Base de données locale SQL Server Express détenues par l’utilisateur actuel.

<nom_instance> retourne le nom, la version, l’état (En cours d’exécution ou Arrêté), la dernière heure de démarrage de l’instance spécifiée de Base de données locale SQL Server Express et le nom du canal local de Base de données locale.

[ trace | t ] on | off

trace on active le suivi des appels d’API de SqlLocalDB pour l’utilisateur actuel. trace off désactive le suivi.

`-?`

Retourne de brèves descriptions de chaque option de SqlLocalDB .

Notes

L’argument instance name doit respecter les règles applicables aux identificateurs SQL Server ou il doit être placé entre guillemets.

L’exécution de SqlLocalDB sans arguments retourne le texte d’aide.

Les opérations autres que le démarrage peuvent être exécutées uniquement sur une instance appartenant à l'utilisateur actuellement connecté. Une instance SQLLOCALDB, lorsqu’elle est partagée, peut uniquement être démarrée et arrêtée par le propriétaire de l’instance.

Exemples

R. Créer une instance de Base de données locale

L’exemple suivant crée une instance de Base de données locale SQL Server Express nommée DEPARTMENT à l’aide des binaires SQL Server, et démarre l’instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Utiliser une instance partagée de Base de données locale

Ouvrez une invite de commandes en utilisant des autorisations d'administrateur.

SqlLocalDB.exe create "DeptLocalDB"
SqlLocalDB.exe share "DeptLocalDB" "DeptSharedLocalDB"
SqlLocalDB.exe start "DeptLocalDB"
SqlLocalDB.exe info "DeptLocalDB"
REM The previous statement outputs the Instance pipe name for the next step
sqlcmd -S np:\\.\pipe\LOCALDB#<use your pipe name>\tsql\query
CREATE LOGIN NewLogin WITH PASSWORD = 'Passw0rd!!@52';
GO
CREATE USER NewLogin;
GO
EXIT

Exécutez le code suivant pour vous connecter à l'instance partagée de LocalDB à l'aide de la connexion NewLogin .

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P Passw0rd!!@52

Partager via