Utilitaire SqlLocalDBSqlLocalDB Utility

Cette rubrique s’applique à : OuiSQL Serveraucunbase de données SQL AzureaucunAzure SQL Data Warehouse aucun Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse Utilisez le SqlLocalDB l’utilitaire pour créer une instance de MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 Express LocalDB. Use the SqlLocalDB utility to create an instance of MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 ExpressLocalDB. L’utilitaire SqlLocalDB (SqlLocalDB.exe) est un outil en ligne de commande simple pour permettre aux utilisateurs et développeurs de créer et gérer une instance de SQL Server ExpressSQL Server ExpressLocalDB.The SqlLocalDB utility (SqlLocalDB.exe) is a simple command line tool to enable users and developers to create and manage an instance of SQL Server ExpressSQL Server ExpressLocalDB. Pour plus d’informations sur l’utilisation de LocalDB, consultez SQL Server 2016 Express LocalDB.For information about how to use LocalDB, see SQL Server 2016 Express LocalDB.

SyntaxeSyntax

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     | -? ]  
}  

ArgumentsArguments

[ create | c ] <instance-name> <instance-version> [-s ][ create | c ] <instance-name> <instance-version> [-s ]
Crée une instance de SQL Server ExpressSQL Server ExpressLocalDB.Creates a new of instance of SQL Server ExpressSQL Server ExpressLocalDB. SqlLocalDB utilise la version de SQL Server ExpressSQL Server Express binaires spécifiés par <version_instance > argument.SqlLocalDB uses the version of SQL Server ExpressSQL Server Express binaries specified by <instance-version> argument. Le numéro de version est spécifié au format numérique avec au moins une décimale.The version number is specified in numeric format with at least one decimal. Les numéros de version secondaire (Service Packs) sont facultatifs.The minor version numbers (service packs) are optional. Par exemple, les deux numéros de version suivants sont acceptables : 11.0 et 11.0.1186.For example the following two version numbers are both acceptable: 11.0, or 11.0.1186. La version spécifiée doit être installée sur l'ordinateur.The specified version must be installed on the computer. S'il n'est pas spécifié, le numéro de version a par défaut la version de l'utilitaire SqlLocalDB .If not specified, the version number defaults to the version of the SqlLocalDB utility. L’ajout de –s permet de démarrer la nouvelle instance de LocalDB.Adding –s starts the new instance of LocalDB.

[ share | h ][ share | h ]
Partage l’instance privée spécifiée de LocalDB à l’aide du nom partagé spécifié.Shares the specified private instance of LocalDB using the specified shared name. Si le SID ou le nom de compte de l'utilisateur est omis, il prend par défaut la valeur de l'utilisateur actuel.If the user SID or account name is omitted, it defaults to the current user.

[ unshared | u ][ unshared | u ]
Arrête le partage de l’instance partagée spécifiée de LocalDB.Stops the sharing of the specified shared instance of LocalDB.

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

[ start | s ] "<instance-name>"[ start | s ] "<instance-name>"
Démarre l’instance spécifiée de SQL Server ExpressSQL Server ExpressLocalDB.Starts the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. En cas de réussite de l'opération, l'instruction retourne l'adresse du canal nommé de LocalDB.When successful the statement returns the named pipe address of the LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ][ stop | p ] <instance-name> [-i ] [-k ]
Arrête l’instance spécifiée de SQL Server ExpressSQL Server ExpressLocalDB.Stops the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. L’ajout de –i demande l’arrêt de l’instance avec l’option NOWAIT .Adding –i requests the instance shutdown with the NOWAIT option. L’ajout de –k met fin au processus de l’instance sans le contacter.Adding –k kills the instance process without contacting it.

[ info | i ] [ <instance-name> ][ info | i ] [ <instance-name> ]
Répertorie toutes les instances de SQL Server ExpressSQL Server ExpressLocalDB détenues par l’utilisateur actuel.Lists all instance of SQL Server ExpressSQL Server ExpressLocalDB owned by the current user.

<nom de l’instance > retourne le nom, version, l’état (en cours d’exécution ou arrêté), dernière heure de début de l’instance spécifiée de SQL Server ExpressSQL Server Express LocalDBet le nom du canal de communication local de la LocalDB.<instance-name> returns the name, version, state (Running or Stopped), last start time for the specified instance of SQL Server ExpressSQL Server ExpressLocalDB, and the local pipe name of the LocalDB.

[ trace | t ] on | off[ trace | t ] on | off
trace on active le suivi des appels d’API de SqlLocalDB pour l’utilisateur actuel.trace on enables tracing for the SqlLocalDB API calls for the current user. trace off désactive le suivi.trace off disables tracing.

-?-?
Retourne de brèves descriptions de chaque option de SqlLocalDB .Returns brief descriptions of each SqlLocalDB option.

NotesRemarks

L’argument instance name doit respecter les règles applicables aux identificateurs SQL ServerSQL Server ou il doit être placé entre guillemets.The instance name argument must follow the rules for SQL ServerSQL Server identifiers or it must be enclosed in double quotes.

L’exécution de SqlLocalDB sans arguments retourne le texte d’aide.Executing SqlLocalDB without arguments returns the help text.

Les opérations autres que le démarrage peuvent être exécutées sur une instance appartenant à l'utilisateur actuellement connecté.Operations other than start can only be performed on an instance belonging to currently logged in user. 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.An SQLLOCALDB Instance, when shared, can only be started and stopped by the owner of the instance.

ExemplesExamples

A.A. Création d'une instance de LocalDBCreating an Instance of LocalDB

L’exemple suivant crée une instance de SQL Server ExpressSQL Server ExpressLocalDB nommée DEPARTMENT utilisant les binaires SQL Server 2017SQL Server 2017 et démarre l’instance.The following example creates an instance of SQL Server ExpressSQL Server ExpressLocalDB named DEPARTMENT using the SQL Server 2017SQL Server 2017 binaries and starts the instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

B.B. Utilisation d'une instance partagée de LocalDBWorking with a Shared Instance of LocalDB

Ouvrez une invite de commandes en utilisant des autorisations d'administrateur.Open a command prompt using Administrator privileges.

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 .Execute the following code to connect to the shared instance of LocalDB using the NewLogin login.

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

Voir aussiSee Also

SQL Server 2016 Express LocalDBSQL Server 2016 Express LocalDB
Outil de gestion en ligne de commande : SqlLocalDB.exeCommand-Line Management Tool: SqlLocalDB.exe