SqlServer.Rules

Mais um conjunto de regras para o SQL Server Datatools

Visão geral

Exatamente o que diz na caixa: uma biblioteca de práticas recomendadas SQL como regras de análise de código de banco de dados estendidas verificadas na construção. As regras podem ser instaladas localmente, bem como no servidor de construção.

Para uma lista completa das regras atuais que implementamos, consulte aqui. Por exemplo, código veja aqui

Organização

• SQLSERVER.DAC - Este visitantes de retenção e outro código de utilidade
• SQLSERVER.RULES - Isso mantém as regras derivadas do SqlCodeAnalysisRule
• Sqlserver.rules.report - biblioteca para avaliar uma regra e serializar o resultado.
• SQLSERVER.RULES.Generator - Um aplicativo de console rápido para relatar todas as regras em um projeto SQL.
• Sqlserver.rules.solutionGenerator - Um rápido em criar e avaliar as regras em uma solução SQL. Também produzirá as regras violadas em um relatório HTML.
• TestDatabase - uma pequena solução SQL para testar com

Debug / teste

1. Garanta que SqlServer.Rules.SolutionGenerator está "definido como projeto de inicialização"
2. Definir argumentos da linha de comando:
   1. Abra as propriedades para o projeto SqlServer.Rules.SolutionGenerator
   2. Selecione a guia Debug
   3. Digite um dos seguintes cenários:
   4. Para depurar o chicote de teste db: --build --reportDirectory ".Files" --solution "......TestDatabaseTestDatabase.sln"
   5. Para depurar um projeto SQL: --build --reportDirectory ".Files" --solution "{path}.sln"
3. Adicione um ponto de interrupção no projeto SqlServer.Rules em qualquer uma das regras que você deseja depurar

Nota: Se você precisar depurar o carregamento da biblioteca, veja aqui

Instalar

É fornecido um install.bat que copiará as regras para todos os destinos de pasta apropriados. Ou você pode opcionalmente seguir estas instruções:

Siga as instruções no MS DOCs Instale a regra de análise de código estático.

A construção deve ser instalada no caminho do modelo %VSBIN%Common7IDEExtensionsMicrosoftSQLDBDAC{SqlEngine}Extensions assim para o Visual Studio 2017 com a versão DAC 150 O caminho pode ser

C:Program Files (x86)Microsoft Visual Studio 2017 EnterpriseCommon7IDEExtensionsMicrosoftSQLDBDAC 150 ExtensionsSqlServer.Rules

Notas:

• Você precisará copiar os binários para todas as permuções da versão do Visual Studio e da versão DAC para a qual deseja usar as regras.
• Quando você tem a análise de código ativado e compilou o Project Visual Studio, coloca um bloqueio duro nos binários da regra. Para atualizá -los ou removê -los, você precisará fechar o Visual Studio.

Configuração do projeto

• Depois que as regras são compiladas e instaladas no diretório apropriado, você poderá abrir seu projeto SSDT e ativar a análise de código seguindo estas instruções: https://docs.microsoft.com/en-us/sql/ssdt/database-project-settings?view=sql-erver-ver15#bkkmkkkkkmyskmys-ejecttings?view=sql/sysysysysysysysysysysysysysysysysississississississississississississississississississississississississississhississississ-°
• Após a análise do código, execute uma reconstrução. Qualquer uma das regras que estão quebradas aparecerão como avisos de construção.
  • Você pode clicar duas vezes em qualquer um dos avisos para ser levado ao local do código em que a regra foi quebrada.
• Você também pode opcionalmente:
  • Ativar / desativar regras.
  • Defina certas regras como erros para que eles lançem erros de construção.
  • Ignore as regras nos arquivos SQL. Ver