Utilitaire SqlLocalDB

Utilisez l'utilitaire SqlLocalDB pour créer une instance de Microsoft SQL Server 2012 Express LocalDB. 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 Express LocalDB. Pour plus d'informations sur l'utilisation de LocalDB, consultez SQL Server 2012 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 nouvelle instance de SQL Server Express LocalDB. 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 et 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 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 Express LocalDB.

  • [ start | s ] "<instance-name>"
    Démarre l'instance spécifiée de SQL Server Express LocalDB. 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 Express LocalDB. 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 Express LocalDB possédées par 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 pour l'instance spécifiée de SQL Server Express LocalDB et le nom du canal local de LocalDB.

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

Exemples

A.Création d'une instance de LocalDB

L'exemple suivant crée une instance de SQL Server Express LocalDB nommée DEPARTMENT utilisant les binaires SQL Server 2012 et démarre l'instance.

SqlLocalDB.exe create "DEPARTMENT" 11.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

Concepts

SQL Server 2012 Express LocalDB