Utilità SQLdiag

Sintassi

sqldiag 
     { [/?] }
     |
     { [/I configuration_file]
       [/O output_folder_path]
       [/P support_folder_path]
       [/N output_folder_management_option]
              [/M machine1 [ machine2 machineN]| @machinelistfile]
       [/C file_compression_type]
              [/B [+]start_time]
       [/E [+]stop_time]
       [/A SQLdiag_application_name]
       [/T { tcp [ ,port ] | np | lpc | via } ]
       [/Q] [/G] [/R] [/U] [/L] [/X] }
     |
     { [START | STOP | STOP_ABORT] }
     |
     { [START | STOP | STOP_ABORT] /A SQLdiag_application_name }

Argomenti

• /?
  Visualizza le informazioni sull'utilizzo.

• /Iconfiguration_file
  Imposta il file di configurazione utilizzato da SQLdiag. Per impostazione predefinita, /I è impostato su SQLDiag.Xml.

• /Ooutput_folder_path
  Reindirizza l'output dell'utilità SQLdiag sulla cartella specificata. Se si omette l'opzione /O, l'output dell'utilità SQLdiag viene scritto su una sottocartella denominata SQLDIAG sotto la cartella di avvio di SQLdiag. Se la cartella SQLDIAG non esiste, l'utilità SQLdiag cercherà di crearla.

  Nota

  La posizione della cartella di output è relativa alla posizione della cartella di supporto che è possibile specificare mediante /P. Per impostare una cartella di output completamente diversa, specificare il percorso completo della directory per /O.

• /Psupport_folder_path
  Imposta il percorso della cartella di supporto. Per impostazione predefinita, /P viene impostata sulla cartella nella quale risiede il file eseguibile di SQLdiag. La cartella di supporto contiene i file di supporto di SQLdiag, ad esempio il file di configurazione XML, gli script di Transact-SQL e altri file che l'utilità utilizza durante la raccolta dei dati diagnostici. Se si utilizza questa opzione per specificare un percorso alternativo per i file di supporto, SQLdiag copierà automaticamente i file di supporto necessari nella cartella specificata, se non esistono già.

  Nota

  Per impostare la cartella corrente come percorso di supporto, specificare %cd% nella riga di comando come segue:

  SQLDIAG /P %cd%

• /Noutput_folder_management_option
  Imposta la sovrascrittura o la ridenominazione della cartella di output all'avvio dell'utilità SQLdiag. Opzioni disponibili:

  1 = sovrascrive la cartella di output (impostazione predefinita).

  2 = all'avvio di SQLdiag, rinomina la cartella di output in SQLDIAG_00001, SQLDIAG_00002 e così via. Dopo aver rinominato la cartella di output corrente, SQLdiag scrive l'output nella cartella di output predefinita SQLDIAG.

  Nota

  Con SQLdiag l'output non viene accodato alla cartella di output corrente al momento dell'avvio. È possibile soltanto sovrascrivere la cartella di output predefinita (opzione 1) o rinominare la cartella (opzione 2), quindi l'output viene scritto nella nuova cartella di output predefinita denominata SQLDIAG.

• /Mmachine1 [ machine2machineN] | @machinelistfile
  Esegue l'override del computer specificato nel file di configurazione. Per impostazione predefinita il file di configurazione è SQLDiag.Xml o è impostato con il parametro /I. Quando si specifica più di un computer, separare ogni nome di computer con uno spazio.

  L'utilizzo di @machinelistfile consente di specificare un nome di file di un elenco di computer da archiviare nel file di configurazione.

• /Cfile_compression_type
  Imposta il tipo di compressione utilizzato per i file nella cartella di output SQLdiag. Opzioni disponibili:

  0 = nessuna compressione (impostazione predefinita)

  1 = compressione NTFS

• /B [+]start_time
  Specifica la data e l'ora di inizio della raccolta di dati diagnostici nel formato seguente:

  AAAAMMGG_HH:MM:SS

  L'ora viene specificata nel formato 24 ore. Ad esempio, per specificare le 2 del pomeriggio immettere 14:00:00.

  Utilizzare + senza specificare la data, ovvero solo HH:MM:SS, per specificare un'ora in relazione alla data e all'ora correnti. Ad esempio, se si specifica /B +02:00:00, SQLdiag attenderà due ore prima di iniziare a raccogliere informazioni.

  Non inserire spazi tra + e il valore specificato per start_time.

  Se si specifica un'ora di inizio già trascorsa, SQLdiag modifica forzatamente la data di inizio in modo che faccia riferimento a un periodo futuro. Se, ad esempio, si specifica /B 01:00:00 e l'ora corrente è 08:00:00, SQLdiag modifica forzatamente la data di inizio in modo che venga impostata in corrispondenza del giorno successivo.

  L'utilità SQLdiag utilizza l'ora locale del computer in cui è in esecuzione.

• /E [+]stop_time
  Specifica la data e l'ora di arresto della raccolta di dati diagnostici nel formato seguente:

  AAAAMMGG_HH:MM:SS

  L'ora viene specificata nel formato 24 ore. Ad esempio, per specificare le 2 del pomeriggio immettere 14:00:00.

  Utilizzare + senza specificare la data, ovvero solo HH:MM:SS, per specificare un'ora in relazione alla data e all'ora correnti. Se, ad esempio, si specifica un'ora di inizio e un'ora di fine tramite /B +02:00:00 /E +03:00:00, SQLdiag attenderà 2 ore prima di iniziare a raccogliere informazioni. I dati verranno raccolti per 3 ore prima che l'utilità venga arrestata e chiusa. Se si omette /B, SQLdiag inizia a raccogliere subito i dati diagnostici e termina alla data e all'ora specificate da /E.

  Non inserire spazi tra + e il valore specificato per start_time o end_time.

  L'utilità SQLdiag utilizza l'ora locale del computer in cui è in esecuzione.

• /A SQLdiag_application_name
  Abilita l'esecuzione di più istanze dell'utilità SQLdiag sulla base della stessa istanza di SQL Server.

  Ogni SQLdiag_application_name identifica una diversa istanza di SQLdiag. Non esiste alcuna relazione tra un'istanza di SQLdiag_application_name e il nome di un'istanza di SQL Server.

  È possibile utilizzare SQLdiag_application_name per avviare o arrestare un'istanza specifica del servizio SQLdiag.

  Ad esempio:

  SQLDIAG START /A SQLdiag_application_name

  È inoltre possibile utilizzarlo con l'opzione /R per registrare un'istanza specifica di SQLdiag come servizio. Ad esempio:

  SQLDIAG /R /ASQLdiag_application_name

  Nota

  SQLdiag aggiunge automaticamente il prefisso DIAG$ al nome dell'istanza specificato per SQLdiag_application_name. In questo modo viene messo a disposizione un nome di servizio appropriato se si registra SQLdiag come servizio.

• /T { tcp [ ,port ] | np | lpc | via }
  Consente di connettersi a un'istanza di SQL Server utilizzando il protocollo specificato.

  • tcp [, port]
    Protocollo TCP/IP (Transmission Control Protocol/Internet Protocol). È possibile specificare facoltativamente un numero di porta per la connessione.

  • np
    Named pipe. Per impostazione predefinita, l'istanza predefinita di SQL Server resta in attesa sulla named pipe \\.\pipe\sql\query e \\.\pipe\MSSQL$<instancename>\sql\query per un'istanza denominata. Non è possibile connettersi a un'istanza di SQL Server tramite un nome della pipe alternativo.

  • lpc
    Chiamata di procedura locale. Il protocollo Shared Memory è disponibile se il client si connette a un'istanza di SQL Server nello stesso computer.

  • via
    Protocollo VIA (Virtual Interface Adapter). Questo protocollo deve essere utilizzato per l'hardware VIA. Per informazioni sull'utilizzo di VIA, rivolgersi al fornitore dell'hardware.

    Nota

    Il protocollo VIA è deprecato. Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

  Per ulteriori informazioni sui protocolli, vedere Scelta di un protocollo di rete.

• /Q
  Esegue l'utilità SQLdiag in modalità non interattiva. /Q disattiva tutti prompt, ad esempio i prompt delle password.

• /G
  Esegue l'utilità SQLdiag in modalità generica. Se si specifica /G, all'avvio dell'utilità SQLdiag non vengono eseguiti i controlli della connettività di SQL Server, né viene verificata l'appartenenza dell'utente al ruolo predefinito del server sysadmin. L'utilità SQLdiag utilizza invece Windows per determinare se un utente dispone delle autorizzazioni sufficienti per raccogliere i dati diagnostici richiesti.

  Se si omette /G, SQLdiag verifica se l'utente è membro del gruppo Administrators di Windows e non procede alla raccolta dei dati diagnostici di SQL Server se l'utente non appartiene al gruppo Administrators.

• /R
  Registra l'utilità SQLdiag come servizio. Gli argomenti della riga di comando specificati per registrare l'utilità SQLdiag come servizio vengono conservati per le esecuzioni future del servizio stesso.

  Se l'utilità SQLdiag viene registrata come servizio, il nome del servizio predefinito è SQLDIAG. È possibile modificare il nome del servizio utilizzando l'argomento /A.

  Utilizzare l'argomento della riga di comando START per avviare il servizio:

  SQLDIAG START

  È inoltre possibile utilizzare il comando net start per avviare il servizio:

  net start SQLDIAG

• /U
  Annulla la registrazione dell'utilità SQLdiag come servizio.

  Utilizzare l'argomento /A anche se si annulla la registrazione di un'istanza denominata di SQLdiag.

• /L
  Esegue l'utilità SQLdiag in modalità continua quando si specificano un'ora di inizio e fine rispettivamente mediante gli argomenti /B o /E. L'utilità SQLdiag viene automaticamente riavviata in seguito all'arresto della raccolta di dati diagnostici a causa di una chiusura pianificata impostata tramite, ad esempio, l'argomento /E o /X.

  Nota

  SQLdiag ignora l'argomento /L se non si specifica un'ora di inizio e fine mediante gli argomenti della riga di comando /B e /E.

  L'utilizzo dell'argomento /L non implica la definizione della modalità del servizio. Per utilizzare /L per l'esecuzione dell'utilità SQLDiag come servizio, specificare l'argomento nella riga di comando quando si registra il servizio.

• /X
  Esegue l'utilità SQLdiag in modalità snapshot. L'utilità SQLdiag esegue uno snapshot di tutti i dati diagnostici configurati, quindi viene chiusa automaticamente.

• START | STOP | STOP_ABORT
  Avvia o arresta il servizio SQLdiag. STOP_ABORT impone al servizio di arrestarsi al più presto senza portare a termine la raccolta dei dati diagnostici in corso.

  Questi argomenti di controllo del servizio devono essere i primi nella riga di comando quando vengono utilizzati. Ad esempio:

  SQLDIAG START

  L' argomento /A, che specifica un'istanza denominata di SQLdiag, è l'unico che può essere utilizzato con START, STOP o STOP_ABORT per il controllo di un'istanza specifica del servizio SQLdiag. Ad esempio:

  SQLDIAG START /ASQLdiag_application_name

Requisiti di sicurezza

Se l'utilità SQLdiag non viene eseguita in modalità generica specificando l'argomento della riga di comando /G, l'utente che esegue SQLdiag deve essere membro del gruppo Administrators di Windows e membro del ruolo predefinito del server sysadmin di SQL Server. Per impostazione predefinita, l'utilità SQLdiag esegue la connessione a SQL Server tramite l'autenticazione di Windows, ma supporta anche l'autenticazione di SQL Server.

Considerazioni sulle prestazioni

Le prestazioni relative all'esecuzione dell'utilità SQLdiag dipendono dal tipo di dati diagnostici configurati per la raccolta. Se ad esempio l'utilità SQLdiag è stata configurata per raccogliere informazioni di traccia di SQL Server Profiler Profiler, maggiore è il numero di classi degli eventi selezionate per la raccolta delle tracce, maggiore sarà l'impatto sulle prestazioni del server.

L'impatto sulle prestazioni dell'esecuzione dell'utilità SQLDiag è pari circa alla somma dei costi di raccolta dei dati diagnostici configurati separatamente. La raccolta di una traccia con l'utilità SQLDiag, ad esempio, è caratterizzata dagli stessi costi a livello di prestazioni della raccolta degli stessi dati con SQL Server Profiler. L'impatto dell'utilizzo dell'utilità SQLDiag sulle prestazioni è irrilevante.

Spazio su disco richiesto

Poiché l'utilità SQLdiag è in grado di raccogliere tipi diversi di dati diagnostici, lo spazio libero su disco richiesto per l'esecuzione di SQLdiag può variare. La quantità di dati diagnostici raccolti dipende dalla natura e dal volume del carico di lavoro che il server sta elaborando e può variare da pochi megabyte a una quantità rilevante di gigabyte.

File di configurazione

All'avvio dell'utilità SQLdiag vengono letti il file di configurazione e gli argomenti della riga di comando specificati. Nel file di configurazione vengono specificati i tipi di dati diagnostici raccolti dall'utilità SQLdiag. Per impostazione predefinita, l'utilità SQLdiag utilizza il file di configurazione SQLDiag.Xml, disponibile a ogni esecuzione nella cartella di avvio dell'utilitàSQLdiag. Il file di configurazione utilizza l'XML Schema SQLDiag_schema.xsd estratto dalla directory di avvio dell'utilità dal file eseguibile ad ogni esecuzione di SQLdiag.

Modifica dei file di configurazione

Cartella di output

Se non si specifica una cartella di output con l'argomento /O, l'utilità SQLdiag crea una sottocartella denominata SQLDIAG nella cartella di avvio SQLdiag. Per la raccolta di dati diagnostici che comportano un elevato numero di tracce, ad esempio SQL Server Profiler Profiler, verificare che la cartella di output si trovi in un'unità locale dotata di spazio sufficiente per memorizzare l'output di dati diagnostici richiesto.

Quando SQLdiag viene riavviato, i contenuti della cartella di output vengono sovrascritti. Per evitare la sovrascrittura, specificare /N 2 nella riga di comando.

Processo di raccolta dei dati

Quando viene avviata, l'utilità SQLdiag esegue i controlli di inizializzazione necessari per raccogliere i dati diagnostici specificati nel file SQLDiag.Xml. Questo processo potrebbe richiedere alcuni secondi. Dopo che l'utilità SQLdiag eseguita come applicazione console ha iniziato a raccogliere i dati diagnostici, viene visualizzato un messaggio indicante che la raccolta di SQLdiag è iniziata e che è possibile premere CTRL+C per arrestarla. Se l'utilità SQLdiag viene eseguita come servizio, un messaggio simile viene scritto nel registro eventi di Windows.

In caso di utilizzo dell'utilità SQLdiag per diagnosticare un problema che è possibile riprodurre, attendere la visualizzazione di questo messaggio prima di riprodurre il problema nel server.

L'utilità SQLdiag raccoglie la maggior parte dei dati diagnostici in parallelo. Tutti i dati diagnostici vengono raccolti mediante la connessione a strumenti, ad esempio l'utilità sqlcmd di SQL Server oppure il processore dei comandi di Windows, tranne quando le informazioni vengono raccolte dai registri di prestazioni e dai registri eventi di Windows. L'utilità SQLdiag utilizza un thread di lavoro per computer per monitorare la raccolta di dati diagnostici da questi strumenti, spesso attendendo contemporaneamente il completamento della raccolta da parte di più strumenti. Durante il processo di raccolta l'utilità SQLDiag instrada l'output di ogni dato diagnostico alla cartella di output.

Arresto della raccolta di dati

Dopo l'inizio della raccolta di dati diagnostici, l'utilità SQLdiag continua a raccogliere informazioni finché non viene arrestata manualmente oppure in base all'ora di arresto specificata. Per configurare l'arresto dell'esecuzione dell'utilità SQLdiag a un'ora specifica, utilizzare l'argomento /E, che consente di specificare l'ora di arresto desiderata, oppure l'argomento /X, che imposta l'esecuzione dell'utilità SQLdiag in modalità snapshot.

Quando viene arrestata, l'utilità SQLdiag arresta tutti i processi di diagnostica avviati. Vengono ad esempio arrestati la raccolta delle tracce di SQL Server Profiler , gli script Transact-SQL in esecuzione e qualsiasi processo secondario generato durante la raccolta dei dati. Quando la raccolta di dati diagnostici è completata, l'utilità SQLdiag viene chiusa.

SQLDIAG STOP /A Instance1

Avvio e arresto automatici dell'utilità SQLdiag

Per avviare e arrestare automaticamente la raccolta di dati diagnostici a un'ora specificata, utilizzare gli argomenti /Bstart_time e /Estop_time nel formato 24 ore. Se, ad esempio, si sta cercando di risolvere un problema che si verifica regolarmente alle 02:00:00 circa, è possibile configurare l'utilità SQLdiag in modo che inizi automaticamente a raccogliere dati diagnostici alle 01:00 e si arresti automaticamente alle 03:00:00. Utilizzare gli argomenti /B e /E per specificare l'ora di inizio e di fine. Utilizzare il formato 24 ore per specificare la data e l'ora di inizio e fine corrette nel formato AAAAMMGG_HH:MM:SS. Per specificare una data di inizio o fine relativa, anteporre il segno + all'ora di inizio e fine omettendo la parte relativa alla data (AAAAMMGG_) come illustrato nell'esempio seguente. In questo modo, l'utilità SQLdiag attende un'ora prima di iniziare a raccogliere le informazioni. I dati vengono raccolti per 3 ore prima che l'utilità venga arrestata e chiusa.

sqldiag /B +01:00:00 /E +03:00:00

Se si specifica un valore relativo per l'argomento start_time, l'utilità SQLdiag viene avviata a un'ora relativa rispetto alla data e all'ora correnti. Se si specifica un valore relativo per l'argomento end_time, l'utilità SQLdiag viene interrotta a un'ora relativa rispetto al valore specificato per l'argomento start_time. Se la data o l'ora di inizio e fine specificate sono già trascorse, l'utilità SQLdiag modifica forzatamente la data e l'ora di inizio in modo che facciano riferimento a un periodo futuro.

Ciò ha implicazioni molto importanti sulle date di inizio e fine selezionate. Si consideri l'esempio descritto di seguito.

sqldiag /B +01:00:00 /E 08:30:00

Se l'ora corrente è 08:00, l'ora di fine è già trascorsa prima dell'inizio della raccolta di dati diagnostici. Poiché l'utilità SQLDiag modifica automaticamente le date di inizio e fine riferendole al giorno successivo qualora siano già trascorse, in questo esempio la raccolta di dati diagnostici inizia alle 09:00 della data corrente (è stata specificata un'ora di inizio relativa tramite il prefisso +) e continua fino alle 08:30 del giorno successivo.

Arresto e riavvio di SQLdiag per la raccolta giornaliera di dati diagnostici

sqldiag /B 03:00:00 /E 05:00:00 /L

sqldiag /B 03:00:00 /X /L

Esecuzione dell'utilità SQLdiag come servizio

Se si desidera utilizzare l'utilità SQLdiag per raccogliere dati diagnostici per lunghi periodi di tempo durante i quali potrebbe essere necessario disconnettersi dal computer sul quale l'utilità SQLdiag è in esecuzione, è possibile eseguire l'utilità come servizio.

SQLDIAG START /A Instance1

Esecuzione di più istanze di SQLdiag

È possibile eseguire più istanze di SQLdiag nello stesso computer specificando /ASQLdiag_application_name nella riga di comando. Ciò consente di raccogliere diversi set di dati diagnostici contemporaneamente dalla stessa istanza di SQL Server. È ad esempio possibile configurare un'istanza denominata di SQLdiag per eseguire in modo continuo una raccolta di dati lightweight. Se pertanto si verifica un problema specifico relativo a SQL Server, è possibile eseguire l'istanza di SQLdiag predefinita per raccogliere i dati diagnostici relativi a quel problema o per la raccolta di un set di dati diagnostici su richiesta del Servizio Supporto Tecnico Clienti Microsoft per elaborare una diagnosi relativa al problema.

Raccolta dei dati diagnostici dalle istanze di SQL Server del cluster

L'utilità SQLdiag supporta la raccolta di dati diagnostici dalle istanze cluster di SQL Server. Per raccogliere dati diagnostici dalle istanze cluster di SQL Server, verificare di aver specificato "." per l'attributo name dell'elemento <Machine> nel file di configurazione SQLDiag.Xml e di non aver specificato l'argomento /G nella riga di comando. Per impostazione predefinita, viene specificato "." per l'attributo name nel file di configurazione e l'argomento /G è disattivato. Non è in genere necessario modificare il file di configurazione o gli argomenti della riga di comando durante la raccolta di dati da un'istanza cluster di SQL Server.

Se si specifica "." come nome del computer, l'utilità SQLdiag rileva che è in esecuzione in un cluster e contemporaneamente recupera i dati diagnostici da tutte le istanze virtuali di SQL Server installate nel cluster. Se si desidera raccogliere dati diagnostici da una sola istanza virtuale di SQL Server in un computer, specificare l'istanza virtuale di SQL Server per l'attributo name dell'elemento <Machine> nel file SQLDiag.Xml.

Vedere anche

Concetti