Utilitaire SqlLocalDB

Article
03/06/2017

Utilisez l’utilitaire SqlLocalDB pour créer une instance de MicrosoftSQL Server 2014 ExpressLocalDB. L’utilitaire SqlLocalDB (SqlLocalDB.exe) est un outil en ligne de commande simple qui permet aux utilisateurs et aux développeurs de créer et de gérer une instance de SQL Server ExpressLocalDB. Pour plus d’informations sur l’utilisation de LocalDB, consultez SQL Server 2014 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 SQL Server ExpressLocalDB. SqlLocalDB utilise la version des fichiers binaires SQL Server Express spécifiés par <l’argument de version> d’instance. 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 est défini par défaut sur la version de l’utilitaire SqlLocalDB . L’ajout de -s permet de démarrer la nouvelle instance de LocalDB.

[ share | h ]
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.

[ unshared | u ]
Arrête le partage de l’instance partagée spécifiée de LocalDB.

[ delete | d ] <instance-name>
Supprime l’instance spécifiée de SQL Server ExpressLocalDB.

[ start | s ] "<instance-name>"
Démarre l’instance spécifiée de SQL Server ExpressLocalDB. En cas de réussite de l'opération, l'instruction retourne l'adresse du canal nommé de LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ]
Arrête l’instance spécifiée de SQL Server ExpressLocalDB. 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 ] [ <instance-name> ]
Répertorie toutes les instances de SQL Server ExpressLocalDB appartenant à l’utilisateur actuel.

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

[ trace | t ] on | off
trace on active le suivi pour les SqlLocalDB appels d’API pour l’utilisateur actuel. trace off désactive le suivi.

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

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 sur une instance appartenant à l'utilisateur actuellement connecté.

Exemples

R. Création d'une instance de LocalDB

L’exemple suivant crée une instance de SQL Server ExpressLocalDB nommée DEPARTMENT à l’aide des fichiers binaires SQL Server 2014 et démarre l’instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Utilisation d'une instance partagée de LocalDB

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

Voir aussi

SQL Server 2014 Express LocalDB

Partager via