Utilità SqlLocalDB

Articolo
03/18/2024

Si applica a: SQL Server

Usare l'utilità SqlLocalDB per creare un'istanza di Local DB di SQL Server Express. L'utilità SqlLocalDB (SqlLocalDB.exe) è un semplice strumento della riga di comando che consente a utenti e sviluppatori di creare e gestire un'istanza di Local DB di SQL Server Express. Per informazioni su come usare LocalDB, vedere SQL Server 2016 Express LocalDB.

Sintassi

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

Argomenti

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

Crea una nuova istanza Local DB di SQL Server Express. SqlLocalDB utilizza la versione dei file binari di SQL Server Express specificati dall'argomento <instance-version>. Il numero di versione viene specificato in formato numerico con almeno un numero decimale. I numeri di versione secondari (Service Pack) sono facoltativi. Ad esempio, i due numeri di versione seguenti sono entrambi accettabili: 11.0 o 11.0.1186. La versione specificata deve essere installata nel computer. Se non è specificata, il numero di versione predefinito sarà quello corrispondente alla versione dell'utilità SqlLocalDB . L'aggiunta di -s avvia la nuova istanza di LocalDB.

Condivide l'istanza privata specificata di LocalDB tramite il nome condiviso indicato. Se viene omesso il SID dell'utente o il nome dell'account, il valore predefinito è l'utente corrente.

[ unshare | u ]

Arresta la condivisione dell'istanza condivisa specificata di LocalDB.

[ delete | d ] <nome_istanza>

Elimina l'istanza specificata Local DB di SQL Server Express.

[ start | s ] "<nome_istanza>"

Avvia l'istanza specificata Local DB di SQL Server Express. Quando ha esito positivo, l'istruzione restituisce l'indirizzo della named pipe del database locale.

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

Arresta l'istanza specificata Local DB di SQL Server Express. L'aggiunta di -i richiede l'arresto dell'istanza con l'opzione NOWAIT. L'aggiunta di -k termina il processo dell'istanza senza contattarlo.

[ info | i ] [ <nome_istanza> ]

Elenca tutte le istanze di Local DB di SQL Server Express di proprietà dell'utente corrente.

<nome-istanza> restituisce il nome, la versione, lo stato (In esecuzione o Arrestato), l'ultima ora di inizio per l'istanza specificata diLocal DB di SQL Server Express e il nome della pipe locale di Local DB.

[ trace | t ] on | off

trace on abilita la traccia per le chiamate all'API SqlLocalDB per l'utente corrente. trace off disabilita la traccia.

`-?`

Restituisce brevi descrizioni di ogni opzione SqlLocalDB .

Osservazioni:

L'argomento instance name deve seguire le regole per gli identificatori di SQL Server oppure deve essere incluso tra virgolette.

L'esecuzione di SqlLocalDB senza argomenti restituisce il testo della Guida.

Le operazioni diverse dall'avvio possono essere eseguite solo su un'istanza che appartiene all'utente attualmente connesso. Un'istanza di SQLLOCALDB, quando è condivisa, può essere avviata e arrestata solo dal proprietario dell'istanza.

Esempi

R. Creare un'istanza di LocalDB

L'esempio seguente crea e avvia un'istanza di SQL Server ExpressLocal DB denominata DEPARTMENT usando i file binari di SQL Server.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Utilizzo di un'istanza condivisa di LocalDB

Aprire un prompt dei comandi con privilegi di amministratore.

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

Eseguire il codice riportato di seguito per connettersi all'istanza condivisa di LocalDB utilizzando l'account di accesso NewLogin .

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

Condividi tramite