Partage via

Utilitaire SqlLocalDB

S'applique à :SQL Server

Utilisez l’utilitaire SqlLocalDB pour créer une instance de SQL Server Express LocalDB. L’utilitaire SqlLocalDB (SqlLocalDB.exe) est un outil en ligne de commande permettant aux utilisateurs et aux développeurs de créer et de gérer une instance de SQL Server Express LocalDB. Pour plus d’informations sur l’utilisation de LocalDB, consultez SQL Server 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     | -? ]
}

Les arguments

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

Crée une 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 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 -s démarre la nouvelle instance de LocalDB.

[ partager | 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.

[ désactiver le partage | u ]

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

[ delete | d ] <nom_instance>

Supprime l’instance spécifiée de SQL Server Express LocalDB.

[ start | s ] "<nom_instance>"

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

[ 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 ] [ <nom_instance> ]

Répertorie toutes les instances de SQL Server Express LocalDB appartenant à l’utilisateur actuel.

<Le nom> de l’instance retourne le nom, la version, l’état (en cours d’exécution ou arrêté), l’heure de début de la dernière instance de SQL Server Express LocalDB et le nom du canal local de la base de données locale.

[ trace | t ] { on | off }

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

-?

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

Remarques

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

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

L’exemple suivant crée une instance de SQL Server Express LocalDB nommée DEPARTMENT à l’aide des fichiers 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. Remplacez <password> par un mot de passe valide.

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 = '<password>';
GO
CREATE USER NewLogin;
GO
EXIT

Exécutez le code suivant pour vous connecter à l’instance partagée de LocalDB à l’aide de l’identifiant NewLogin. Remplacez <password> par un mot de passe valide.

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P <password>

Contenu connexe

  • Last updated on