Utilità osql

Sintassi

osql
[-?] |
[-L] |
[
  {
     {-Ulogin_id [-Ppassword]} | –E }
     [-Sserver_name[\instance_name]] [-Hwksta_name] [-ddb_name]
     [-ltime_out] [-ttime_out] [-hheaders]
     [-scol_separator] [-wcolumn_width] [-apacket_size]
     [-e] [-I] [-D data_source_name]
     [-ccmd_end] [-q "query"] [-Q"query"]
     [-n] [-merror_level] [-r {0 | 1}]
     [-iinput_file] [-ooutput_file] [-p]
     [-b] [-u] [-R] [-O]
]

Argomenti

• -?
  Visualizza il riepilogo della sintassi delle opzioni di osql.

• -L
  Elenca i server configurati localmente e i nomi dei server che trasmettono in rete tramite broadcast.

  [!NOTA]

  A causa della natura delle trasmissioni in rete, è possibile che osql non riceva una risposta tempestiva da tutti i server e pertanto che l'elenco di server restituito sia diverso per ogni chiamata di questa opzione.

• -Ulogin_id
  ID di accesso dell'utente. Per gli ID di accesso viene fatta distinzione tra maiuscole e minuscole.

• -Ppassword
  Password specificata dall'utente. Se si omette l'opzione -P, osql richiede una password. Se l'opzione -P viene specificata alla fine del prompt dei comandi senza indicare una password, osql utilizza la password predefinita (NULL).

  Nota sulla protezione
  Non utilizzare una password vuota. Utilizzare una password complessa. Per ulteriori informazioni, vedere Password complesse.

  Per le password viene fatta distinzione tra maiuscole e minuscole.

  La variabile di ambiente OSQLPASSWORD consente di impostare una password predefinita per la sessione corrente. Non è pertanto necessario specificare una password a livello di codice nei file batch.

  Se si specifica l'opzione -P e si omette la password, osql verifica innanzitutto la variabile OSQLPASSWORD. Se non viene impostato alcun valore, osql utilizza la password predefinita NULL. Nell'esempio seguente viene impostata la variabile OSQLPASSWORD al prompt dei comandi e quindi si accede all'utilità osql.

  C:\>SET OSQLPASSWORD=abracadabra
  C:\>osql 
  

  Nota sulla protezione
  Per nascondere la password, non specificare l'opzione -P in combinazione con l'opzione -U. Dopo avere specificato osql con l'opzione -U e le altre opzioni (non specificare -P), premere invece INVIO. A questo punto osql richiederà una password. Questo metodo garantisce che la password sarà nascosta durante il suo inserimento.

• -E
  Utilizza una connessione trusted anziché richiedere una password.

• -Sserver_name[ **\instance_name]
  Specifica l'istanza di SQL Server alla quale connettersi. Per connettersi all'istanza predefinita di SQL Server in un server specifico, specificare server_name . Per connettersi all'istanza denominata di SQL Server in un determinato server, specificare server_name\**instance_name. Se non si specifica alcun server, osql si connette all'istanza predefinita di SQL Server nel computer locale. Questa opzione è obbligatoria per l'esecuzione di osql da un computer remoto sulla rete.

• -Hwksta_name
  Nome della workstation. Tale nome viene archiviato in sysprocesses.hostname e utilizzando la stored procedure sp_who. Se omesso, viene utilizzato il nome del computer corrente.

• -ddb_name
  Esegue un'istruzione USE db_name all'avvio di osql.

• - ltime_out
  Specifica il numero di secondi prima del timeout di accesso a osql. Il valore predefinito per il timeout di accesso a osql è otto secondi.

• -ttime_out
  Specifica il numero di secondi prima del timeout del comando. Se per time_out non viene specificato alcun valore, ai comandi non viene associato alcun timeout.

• -hheaders
  Specifica il numero di righe da stampare tra le intestazioni delle colonne. L'impostazione predefinita prevede la stampa delle intestazioni per ogni set di risultati delle query. Utilizzare -1 per non stampare alcuna intestazione. Se si utilizza –1, non inserire spazi tra il parametro e l'impostazione (-h-1 e non -h -1).

• -scol_separator
  Specifica il carattere separatore di colonne che, per impostazione predefinita, è uno spazio vuoto. Per utilizzare caratteri con un significato speciale per il sistema operativo (ad esempio, | ; & < >), racchiudere il carattere tra virgolette doppie (").

• -wcolumn_width
  Consente di impostare la larghezza della schermata per l'output. Il valore predefinito è 80 caratteri. Se una riga di output raggiunge la larghezza massima della schermata, viene suddivisa su più righe.

• -apacket_size
  Consente di richiedere un pacchetto di dimensioni diverse. I valori validi per packet_size sono compresi tra 512 e 65535. Il valore predefinito per osql è il valore predefinito del server. Aumentando le dimensioni del pacchetto si possono ottenere miglioramenti delle prestazioni di esecuzione di script di grandi dimensioni, che includono numerose istruzioni SQL tra i comandi GO. Le verifiche condotte da Microsoft indicano che, per le operazioni di copia bulk, l'impostazione che garantisce le prestazioni più veloci è in genere 8.192. È possibile richiedere una dimensione maggiore del pacchetto, ma se questa non è disponibile osql utilizza il valore predefinito del server.

• -e
  Esegue l'eco dell'input.

• -I
  Attiva l'opzione di connessione QUOTED_IDENTIFIER.

• -Ddata_source_name
  Stabilisce una connessione a un'origine dei dati ODBC definita mediante il driver ODBC per SQL Server. La connessione osql utilizza le opzioni specificate nell'origine dei dati.

  [!NOTA]

  Tale opzione non può essere utilizzata con origini dei dati definite per altri driver.

• -ccmd_end
  Specifica il carattere di terminazione del comando. Per impostazione predefinita, i comandi vengono terminati e inviati a SQL Server tramite l'immissione di GO su una riga a sé stante. Se si reimposta il carattere di terminazione del comando, non utilizzare parole riservate di Transact-SQL o caratteri con un significato speciale per il sistema operativo, indipendentemente dal fatto che siano preceduti da una barra rovesciata.

• -q "query"
  Esegue una query all'avvio di osql senza uscire da osql al termine della query. Si noti che l'istruzione della query non dovrebbe includere l'istruzione GO. Se si esegue una query da un file batch, è possibile utilizzare variabili in formato %variabile o variabili di ambiente in formato %variabile%. Ad esempio:

  SET table=sys.objects
  osql -E -q "select name, object_id from %table%"
  

  Racchiudere la query tra virgolette doppie e utilizzare le virgolette singole per altri elementi inclusi nella query.

• -Q"query"
  Esegue una query ed esce immediatamente da osql. Racchiudere la query tra virgolette doppie e utilizzare le virgolette singole per altri elementi inclusi nella query.

• -n
  Rimuove la numerazione e il simbolo del prompt (>) dalle righe di input.

• -merror_level
  Personalizza la visualizzazione dei messaggi di errore. Per gli errori con livello di gravità pari o superiore a quello specificato vengono visualizzati il numero, lo stato e il livello di errore del messaggio. Per gli errori con livelli di gravità inferiori a quello specificato non viene visualizzato nulla. Utilizzare -1 per specificare che con i messaggi, anche quelli informativi, devono essere restituite anche tutte le rispettive intestazioni. Se si utilizza -1, non inserire spazi tra il parametro e l'impostazione (-m-1 e non -m -1).

• -r { 0| 1}
  Reindirizza l'output dei messaggi sullo schermo (stderr). Se il parametro viene omesso o si specifica 0, vengono reindirizzati solo i messaggi di errore con gravità pari o superiore a 11. Se si specifica 1, viene reindirizzato l'output di tutti i messaggi (incluso quello dell'istruzione "print").

• -iinput_file
  Identifica il file che include un batch di istruzioni SQL o stored procedure. Anziché -i, è possibile utilizzare l'operatore di confronto minore di (<).

• -ooutput_file
  Identifica il file che riceve l'output di osql. Anziché -o, è possibile utilizzare l'operatore di confronto maggiore di (>).

  Se input_file non è un file Unicode e l'opzione -u non è specificata, output_file viene archiviato in formato OEM. Se input_file è un file Unicode o l'opzione -u è specificata, output_file viene archiviato in formato Unicode.

• -p
  Stampa le statistiche sulle prestazioni.

• -b
  Specifica che, in caso di errore, osql termini restituendo un valore DOS ERRORLEVEL. Quando la gravità del messaggio di errore di SQL Server è uguale o maggiore di 11, il valore restituito alla variabile DOS ERRORLEVEL è 1. In caso contrario, il valore restituito è 0. Nei file batch di Microsoft MS-DOS è possibile verificare il valore di DOS ERRORLEVEL e gestirlo in modo appropriato.

• -u
  Specifica che output_file viene archiviato in formato Unicode, indipendentemente dal formato di input_file.

• -R
  Specifica che il driver ODBC di SQL Server utilizza le impostazioni del client per convertire i dati relativi a valuta, data e ora in dati di tipo carattere.

• -O
  Disattiva determinate funzionalità di osql in modo che il funzionamento dell'utilità corrisponda a quello delle precedenti versioni di isql. Vengono disattivate le funzionalità seguenti:

  • Elaborazione batch EOF

  • Adattamento automatico della larghezza della console

  • Messaggi estesi

  L'opzione imposta inoltre il valore predefinito di DOS ERRORLEVEL su -1.

Osservazioni

L'utilità osql viene avviata direttamente dal sistema operativo con le opzioni elencate di seguito per le quali la distinzione tra maiuscole e minuscole è rilevante. Dopo l'avvio, osql accetta istruzioni SQL e le invia a SQL Server in modo interattivo. I risultati vengono formattati e visualizzati sullo schermo (stdout). Per uscire da osql utilizzare QUIT o EXIT.

Se all'avvio di osql non si specifica un nome utente, SQL Server verifica le variabili di ambiente e utilizza tali valori, ad esempio osqluser=(user) o osqlserver=(server). Se non sono state impostate variabili di ambiente, viene utilizzato il nome utente della workstation. Se non si specifica un server, viene utilizzato il nome della workstation.

Se non si specifica l'opzione -U né l'opzione -P, SQL Server cerca di stabilire la connessione utilizzando la modalità di autenticazione di Microsoft Windows. L'autenticazione si basa sull'account di Microsoft Windows dell'utente che esegue osql.

In osql vengono utilizzate l'API ODBC e le impostazioni predefinite del driver ODBC di SQL Server per le opzioni di connessione ISO di SQL Server. Per ulteriori informazioni, vedere Effects of ANSI Options (informazioni in lingua inglese).

Comandi OSQL

SELECT x = 1
GO 100

Uso interattivo di osql

Per utilizzare osql interattivamente, al prompt dei comandi digitare il comando osql e le opzioni desiderate.

Per leggere un file contenente una query, ad esempio Stores.qry, da eseguire con osql, digitare un comando analogo al seguente:

osql -E -i stores.qry

Per leggere un file contenente una query, ad esempio Titles.qry, e indirizzare i risultati a un altro file, digitare un comando simile al seguente:

osql -E -i titles.qry -o titles.res

Nota sulla protezione
Se possibile, utilizzare l'opzione -E (connessione trusted).

Quando si utilizza osql interattivamente, è possibile leggere un file del sistema operativo nel buffer dei comandi mediante :rfile_name. In questo modo lo script SQL in file_name viene inviato direttamente al server come batch singolo.

[!NOTA]

Quando si utilizza osql, in SQL Server la presenza del separatore di batch GO in un file script SQL viene considerata un errore di sintassi.

Inserimento di commenti

Utilizzo di EXIT per la restituzione dei risultati in osql

EXIT ( < query > )

EXIT(SELECT @@ROWCOUNT)

osql -E -Q "EXIT(SELECT COUNT(*) FROM '%1')"

RAISERROR(50001, 10, 127)

Visualizzazione dei tipi di dati money e smallmoney

SELECT CAST(CAST(10.3496 AS money) AS decimal(6, 4))
GO

Vedere anche

Riferimento