API dell'istanza di SQL Server Express LocalDB

Applies to: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. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Esiste un'istanza automatica di LocalDB per ogni versione di LocalDB installata nel computer dell'utente.

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.

Regole di denominazione automatiche delle istanze

Le istanze automatiche del database locale dispongono di un modello speciale per il nome dell'istanza che appartiene a uno spazio dei nomi riservato. È necessario evitare conflitti di nomi con le istanze denominate del database locale.

Il nome dell'istanza automatica è il numero di versione della versione di base di LocalDB preceduto da un singolo v carattere. Questo aspetto è simile v a due numeri con un punto tra di essi, v11.0 ad esempio o V12.00.

Esempi di nomi di istanze automatiche non consentiti sono:

• 11.0 (manca il v carattere all'inizio)
• v11 (manca un punto e il secondo numero della versione)
• v11. (manca il secondo numero della versione)
• v11.0.1.2 (numero di versione ha più di due parti)

Istanze denominate di LocalDB

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. 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

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Si tratta di una differenza significativa rispetto ai nomi di istanze di SQL Server tradizionali, che sono limitati a nomi NetBIOS di 16 caratteri ASCII. Il motivo di questa differenza è che LocalDB considera i database come file e pertanto implica semantica basata su file, quindi è intuitivo per gli utenti avere maggiore libertà nella scelta dei nomi di istanza.

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, le istanze di LocalDB denominate non possono avere un nome che segue il modello di denominazione per le istanze automatiche, come descritto in precedenza nella sezione Regole di denominazione delle istanze automatiche . Un tentativo di creare un'istanza denominata con un nome che segue il modello di denominazione automatico dell'istanza crea in modo efficace un'istanza predefinita.

Related tasks

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.
LocalDBCreateInstance Function	Viene descritta la funzione per creare una nuova istanza del database locale.
LocalDBDeleteInstance Function	Viene descritta la funzione per rimuovere un'istanza del database locale.
LocalDBFormatMessage Function	Viene descritta la funzione per restituire la descrizione localizzata di un errore del database locale.
LocalDBGetInstanceInfo Function	Descrive la funzione per ottenere informazioni per un'istanza di LocalDB, ad esempio se esiste, informazioni sulla versione, se è in esecuzione e così via.
LocalDBGetInstances Function	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.
LocalDBGetVersions Function	Viene descritta la funzione per restituire tutte le versioni del database locale disponibili in un computer.
LocalDBShareInstance Function	Viene descritta la funzione per condividere un'istanza specificata del database locale.
LocalDBStartInstance Function	Viene descritta la funzione per avviare un'istanza specificata del database locale.
LocalDBStartTracing Function	Viene descritta la funzione per abilitare la traccia API per un utente.
LocalDBStopInstance Function	Viene descritta la funzione per arrestare l'esecuzione di un'istanza specificata del database locale.
LocalDBStopTracing Function	Viene descritta la funzione per disabilitare la traccia API per un utente.
LocalDBUnshareInstance Function	Viene descritta la funzione per arrestare la condivisione di un'istanza specificata del database locale.