Panoramica dell'estendibilità delle regole di analisi del codice del database

Le edizioni di Visual Studio contenenti SQL Server Data Tools includono regole di analisi del codice per segnalare avvisi relativi alla progettazione, alla denominazione e alle prestazioni di Transact-SQL nel codice del database. Per altre informazioni, vedere Analisi del codice di database per migliorare la qualità del codice.

Se le regole di analisi del codice predefinite non coprono un problema di Transact-SQL specifico che si vuole sia incluso, è possibile creare regole di analisi del codice del database personalizzate. Ad esempio, potrebbe essere necessario creare una regola personalizzata che eviti l'uso dell'istruzione WAITFOR DELAY, come illustrato in Procedura dettagliata per la creazione di un assembly di regole personalizzate di analisi del codice statica per SQL Server. Per creare le regole di analisi del codice del database personalizzate, è possibile usare le classi nello spazio dei nomi CodeAnalysis.

Prima di creare le regole di analisi del codice personalizzate, è opportuno comprendere l'architettura di base tra i vari componenti delle regole di analisi del codice del database.

Componenti delle regole di analisi del codice del database

La figura seguente illustra l'interazione tra i componenti delle regole di analisi del codice del database:

Quando si usa la funzionalità delle regole di analisi del codice del database, sia eseguendo direttamente l'analisi del codice statica (per altre informazioni, vedere Procedura: Analizzare il codice Transact-SQL per trovare errori) che eseguendo una compilazione, tutte le regole vengono caricate e usate in base a come sono state configurate nel progetto. Per altre informazioni, vedere Procedura: Abilitare e disabilitare regole specifiche relative all'analisi statica del codice del database. Gestione estensioni caricherà inoltre qualsiasi assembly di regole personalizzate creato e registrato. Per altre informazioni, vedere Procedura: Installare e gestire le estensioni delle funzionalità.

Una classe di regola di analisi del codice personalizzata eredita da SqlCodeAnalysisRule. La classe di regole personalizzate può accedere a diversi oggetti utili tramite il relativo contesto di esecuzione della regola, tra cui:

• Metadati relativi alla regola stessa.

• Oggetto Dac.Model.TSqlModel che rappresenta lo schema del database, inclusi tutti gli elementi del modello, le relazioni tra gli elementi e tutte le proprietà degli elementi.

• Per le regole che esaminano elementi specifici, viene incluso nel contesto l'oggetto Dac.Model.TSqlObject che rappresenta l'elemento dello schema nel modello.

• Molti oggetti dello schema contengono anche una rappresentazione di ScriptDom a cui è possibile accedere tramite questo contesto. Si tratta di una rappresentazione basata sulla classe AST di un elemento che può essere utile per individuare potenziali problemi di sintassi, quali la presenza di SelectStarExpression.

La regola crea un oggetto Dac.CodeAnalysis.SqlRuleProblem per rappresentare tutti i problemi rilevati. Quando viene creato questo oggetto, l'oggetto Dac.Model.TSqlObject appropriato ed eventualmente un elemento della rappresentazione di ScriptDom vengono passati al costruttore e usati per determinare la posizione del problema nei file del codice sorgente. Al termine dell'analisi, tutti questi problemi vengono passati alla gestione errori e visualizzati nell'elenco errori.

Vedi anche

Estensione delle funzionalità del database