Profiling delle prestazioni del driver ODBC

Il driver ODBC di SQL Server Native Client può eseguire il profiling di due tipi di dati sulle prestazioni:

• Query con esecuzione prolungata.

  Il driver può scrivere in un file di log tutte le query che non ottengono una risposta dal server entro un periodo di tempo specificato. I programmatori di applicazioni o gli amministratori di database possono quindi eseguire la ricerca di ogni istruzione SQL registrata per determinare il modo in cui poterne migliorare le prestazioni.

• Dati sulle prestazioni del driver.

  Il driver può registrare le statistiche sulle prestazioni e scriverle in un file o renderle disponibili in un'applicazione tramite una struttura dei dati specifica del driver denominata SQLPERF. Il file che contiene le statistiche sulle prestazioni è un file delimitato da tabulazioni che può essere analizzato facilmente con qualsiasi foglio di calcolo che supporti i file delimitati da tabulazioni, ad esempio Microsoft Excel.

È possibile attivare entrambi i tipi di profiling nel seguente modo:

• Connettendosi a un'origine dati che specifica la registrazione.

• Chiamando SQLSetConnectAttr per impostare gli attributi specifici del driver che controllano il profiling.

Ogni processo dell'applicazione ottiene la propria copia del driver ODBC di SQL Server Native Client mentre il profiling è globale per la combinazione di copia del driver e processo dell'applicazione. Quando il profiling viene attivato in un'applicazione, vengono registrate le informazioni per tutte le connessioni attive nel driver a partire da tale applicazione. Vengono anche incluse le connessioni che non hanno specificamente richiesto il profiling.

Il log di profiling (log di dati sulle prestazioni o log di query con esecuzione prolungata) aperto dal driver viene chiuso solo dopo che il driver viene scaricato da Gestione driver ODBC, quando un'applicazione libera tutti gli handle di ambiente aperti nel driver. Se l'applicazione apre un nuovo handle di ambiente, viene caricata una nuova copia del driver. Se l'applicazione si connette quindi a un'origine dati che specifica lo stesso file di log o imposta gli attributi specifici del driver per eseguire la registrazione nello stesso file, il driver sovrascrive il log precedente.

Se un'applicazione avvia il profiling in un file di log e una seconda applicazione tenta di avviare il profiling nello stesso file di log, la seconda applicazione non potrà eseguire la registrazione dei dati del profiling. Se la seconda applicazione avvia il profiling dopo che la prima applicazione ha scaricato il driver, la seconda applicazione sovrascriverà il file di log della prima applicazione.

Se un'applicazione si connette a un'origine dati con il profiling abilitato, il driver restituisce SQL_ERROR se l'applicazione chiama SQLSetConnectOption per avviare la registrazione. Una chiamata a SQLGetDiagRec restituisce quindi il risultato seguente:

SQLState: 01000, pfNative = 0
ErrorMsg: [Microsoft][SQL Server Native Client]
   An error has occurred during the attempt to access
   the log file, logging disabled.

Il driver arresta la raccolta dei dati sulle prestazioni quando viene chiuso un handle di ambiente. Se un'applicazione SQL Server Native Client dispone di più connessioni, ciascuna con il proprio handle di ambiente, il driver arresterà la raccolta dei dati sulle prestazioni quando vengono chiusi tutti gli handle di ambiente associati.

I dati sulle prestazioni del driver possono essere archiviati nella struttura dei dati SQLPERF o registrati in un file delimitato da tabulazioni. I dati includono le seguenti categorie di statistiche:

• Profilo dell'applicazione

• Connessione

• Rete

• Tempo

Nella tabella seguente le descrizioni dei campi per la struttura dei dati SQLPERF vengono applicate anche alle statistiche registrate nel file di log delle prestazioni.