API dell'istanza di SQL Server Express LocalDB

si applica a:SQL Server

Nel mondo di SQL Server tradizionale basato sul servizio, le singole istanze di SQL Server installate in un singolo computer sono separate fisicamente. Ogni istanza deve essere installata e rimossa separatamente, ha un set separato di file binari ed è in esecuzione in un processo di servizio separato. Il nome dell'istanza di SQL Server viene utilizzato per specificare l'istanza di SQL Server a cui l'utente desidera effettuare la connessione.

L'API dell'istanza di SQL Server Express LocalDB usa un modello di istanza light semplificato. Anche se le istanze del database locale singole sono separate sul disco e nel Registro di sistema, in esse viene utilizzato lo stesso set di file binari condivisi del database locale. LocalDB non usa inoltre i servizi. Le istanze di LocalDB vengono avviate su richiesta tramite chiamate API dell'istanza di LocalDB. Nel database locale il nome dell'istanza viene utilizzato per specificare quali delle istanze del database locale l'utente desideri utilizzare.

Un'istanza di LocalDB è sempre di proprietà di un singolo utente ed è visibile e accessibile solo dal contesto dell'utente, a meno che la condivisione dell'istanza non sia abilitata.

Anche se tecnicamente le istanze di LocalDB non sono uguali a quelle tradizionali di SQL Server, l'uso previsto è simile. Vengono chiamate istanze per sottolineare questa somiglianza e renderle più intuitive per gli utenti di SQL Server.

Il database locale supporta due tipi di istanze, ovvero automatiche e denominate. L'identificatore per un'istanza del database locale è il nome dell'istanza.

Istanze automatiche di LocalDB

Le istanze automatiche di LocalDB sono pubbliche; Sono creati e gestiti automaticamente per l'utente e possono essere utilizzati da qualsiasi applicazione. Esiste un'istanza automatica di LocalDB per ogni versione di LocalDB installata nel computer dell'utente. Il nome dell'istanza automatica di LocalDB è MSSQLLocalDB.

Le istanze automatiche del database locale forniscono una gestione continua dell'istanza. L'utente non deve creare l'istanza. in questo modo egli può facilmente installare applicazioni ed eseguire la migrazione a computer diversi. Se nel computer di destinazione è installata la versione specificata del database locale, l'istanza automatica di tale database per quella versione è disponibile anche su quel computer.

Gestione automatica delle istanze

Non è necessario che un utente crei un'istanza automatica di LocalDB. L'istanza viene creata in modo differire la prima volta che viene usata l'istanza, purché la versione specificata di LocalDB sia disponibile nel computer dell'utente. Dal punto di vista dell'utente, l'istanza automatica è sempre presente se sono presenti i file binari localDB.

Per le istanze automatiche sono valide anche altre operazioni di gestione dell'istanza, quali eliminazione, condivisione e non condivisione. In particolare, l'eliminazione di un'istanza automatica reimposta in modo efficace l'istanza, ricreata nella successiva operazione di avvio. L'eliminazione di un'istanza automatica potrebbe essere necessaria se i database di sistema diventano danneggiati.

Istanze denominate di LocalDB

Le istanze LocalDB nominate sono private; un'istanza è di proprietà di un'unica applicazione responsabile della creazione e gestione dell'istanza. Le istanze denominate del database locale forniscono isolamento e migliorano le prestazioni.

Creazione di istanze denominate

L'utente deve creare istanze denominate in modo esplicito tramite l'API di gestione di LocalDB o in modo implicito tramite il app.config file per un'applicazione gestita. Un'applicazione gestita può anche usare l'API.

Ogni istanza denominata dispone di una versione associata del database locale, ovvero che punta a un set specificato di file binari del database locale. La versione per l'istanza denominata viene impostata durante il processo di creazione dell'istanza.

Regole di denominazione delle istanze denominate

Un nome di istanza LocalDB può avere fino a 128 caratteri (il tipo di dato sysname impone questo limite). Questo limite rappresenta una differenza significativa rispetto ai nomi tradizionali delle istanze di SQL Server, che sono limitati a nomi NetBIOS di 15 caratteri ASCII. La ragione di questa differenza è che LocalDB tratta i database come file e quindi implica una semantica basata su file, quindi gli utenti hanno maggiore libertà nella scelta dei nomi delle istanze.

Nel nome di un'istanza del database locale può essere incluso qualsiasi carattere Unicode che sia valido all'interno del componente del nome del file. I caratteri non validi in un componente nome file includono in genere i caratteri ASCII/Unicode da 1 a 31 e virgolette (), minore di ("), maggiore di (<>), pipe (|), backspace (\b), tab (), punti (\t:), asterisco (*), punto interrogativo (?), barra rovesciata (\) e barra (/). Il carattere Null (\0) è consentito perché viene usato per la terminazione della stringa; tutto dopo il primo carattere Null viene ignorato.

Note

L'elenco di caratteri non validi potrebbe dipendere dal sistema operativo e potrebbe cambiare nelle versioni future.

Gli spazi vuoti iniziali e finali nei nomi delle istanze vengono ignorati e eliminati.

Per evitare conflitti di denominazione, un'istanza LocalDB nominata non può utilizzare il nome MSSQLLocalDBautomatico riservato dell'istanza . Un tentativo di creare un'istanza nominata con quel nome crea di fatto un'istanza predefinita.

Article Description
Informazioni sull'intestazione e sulla versione di SQL Server Express LocalDB Vengono fornite informazioni sul file di intestazione e le chiavi del Registro di sistema per l'individuazione dell'API dell'istanza del database locale.
Strumento di gestione della riga di comando: SqlLocalDB.exe Viene descritto SqlLocalDB.exe, uno strumento per la gestione delle istanze del database locale dalla riga di comando.
Funzione LocalDBCreateInstance Viene descritta la funzione per creare una nuova istanza del database locale.
Funzione LocalDBDeleteInstance Viene descritta la funzione per rimuovere un'istanza del database locale.
Funzione LocalDBFormatMessage Viene descritta la funzione per restituire la descrizione localizzata di un errore del database locale.
Funzione LocalDBGetInstanceInfo Descrive la funzione per ottenere informazioni per un'istanza di LocalDB, ad esempio se esiste, informazioni sulla versione, se è in esecuzione e così via.
Funzione LocalDBGetInstances Viene descritta la funzione per restituire tutte le istanze del database locale con una versione specificata.
LocalDBGetVersionInfo Function Viene descritta la funzione per restituire le informazioni per una versione specificata del database locale.
Funzione LocalDBGetVersions Viene descritta la funzione per restituire tutte le versioni del database locale disponibili in un computer.
Funzione LocalDBShareInstance Viene descritta la funzione per condividere un'istanza specificata del database locale.
Funzione LocalDBStartInstance Viene descritta la funzione per avviare un'istanza specificata del database locale.
Funzione di tracciamento LocalDBStartTracing Viene descritta la funzione per abilitare la traccia API per un utente.
Funzione LocalDBStopInstance Viene descritta la funzione per arrestare l'esecuzione di un'istanza specificata del database locale.
Funzione di tracciamento LocalDBStopTracing Viene descritta la funzione per disabilitare la traccia API per un utente.
Funzione LocalDBUnshareInstance Viene descritta la funzione per arrestare la condivisione di un'istanza specificata del database locale.