Relatórios personalizados no SQL Server Management Studio

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft FabricBanco de dados SQL no Microsoft Fabric

No SQL Server Management Studio, muitos nós do Pesquisador de Objetos exibem um conjunto de relatórios padrão criados pela Microsoft. Esses relatórios resumem as informações do servidor normalmente solicitadas. Os administradores podem executar relatórios personalizados criados no SSDT (SQL Server Data Tools) do Management Studio.

Implementação

Os relatórios personalizados são armazenados como arquivos de definição de relatório (.rdl) e são criados usando RDL (Linguagem de Definição de Relatório). O RDL contém informações de recuperação de dados e layout para um relatório em um formato XML. RDL é um esquema aberto. Os desenvolvedores podem estender o RDL com atributos e elementos extras. Os relatórios podem executar qualquer instrução de Transact-SQL válida no relatório.

Se o Pesquisador de Objetos estiver conectado a um servidor, os relatórios personalizados poderão ser executados no contexto da seleção atual do Pesquisador de Objetos se os relatórios fizerem referência aos parâmetros de relatório desse nó. Isso permite que um relatório use o contexto atual, como o banco de dados atual; ou um contexto consistente, como especificar um banco de dados designado como parte da instrução Transact-SQL contida no relatório personalizado.

Executar um relatório personalizado

Você pode executar um relatório personalizado no Management Studio das seguintes maneiras:

• Clique com o botão direito do mouse em um nó no Pesquisador de Objetos, vá para Relatórios>Relatórios Personalizados. Na caixa de diálogo Abrir Arquivo , localize uma pasta que contenha .rdl arquivos e abra o arquivo de relatório apropriado.

• Clique com o botão direito do mouse em um nó no Pesquisador de Objetos, vá para Relatórios>Personalizados e selecione um relatório personalizado na lista de arquivos usada mais recentemente.

Limitações

Ao trabalhar com relatórios personalizados, considere as seguintes limitações:

• Para impedir a execução não intencional de código mal-intencionado, o Management Studio não pode ser configurado para executar automaticamente um relatório, mesmo que o sistema de arquivos esteja configurado para associar .rdl arquivos ao Management Studio. Os relatórios não podem ser executados programaticamente no Management Studio e não podem ser executados na linha de comando por meio do Management Studio.

• Você pode executar relatórios personalizados em um contexto que não produz os valores esperados. Por exemplo, você pode executar um relatório sobre replicação no contexto de um banco de dados que não está envolvido na replicação ou executar um relatório como um usuário que não tem permissão para acessar informações necessárias para gerar um relatório preciso. O criador do relatório personalizado é responsável pela validade da estrutura de relatório e seu contexto.

• Você não pode adicionar um relatório personalizado à lista de relatórios padrão.

• O código processado pelo relatório pode afetar o desempenho do servidor.

• Relatórios personalizados não dão suporte a sub-relatórios.

• O texto de comando para cada consulta dentro do relatório não deve ser definido por meio de uma expressão.

• Qualquer parâmetro de consulta usado em um comando (consulta) só pode fazer referência a um único parâmetro de relatório e não pode usar nenhum operador de expressão.

• Somente tipos de comando texto e procedimento armazenado têm suporte para comandos de relatório (consultas).

• A estrutura de relatório não fornece nenhum parâmetro de escape para as consultas. Os autores de consulta devem garantir que suas consultas estejam livres de ataques de injeção de SQL.

Gerenciar relatórios personalizados

Recomendamos que os usuários que têm muitos relatórios personalizados os organizem usando pastas do sistema de arquivos que tenham permissões apropriadas do sistema de arquivos NTFS.

Permissões

Relatórios personalizados são executados usando as permissões do usuário atual. Para impedir que um usuário mal-intencionado altere as consultas executadas pelo relatório, as permissões na pasta do sistema de arquivos que contém os arquivos de relatório devem ser definidas para restringir o acesso.

Tanto o usuário quanto a conta usada pelo serviço SQL Server exigem acesso de leitura à pasta do sistema de arquivos que contém os arquivos de relatório.

Qualquer comando válido do .NET Framework pode ser inserido em um relatório, mas o comando não é executado.

Conteúdo relacionado

• Adicionar um relatório personalizado ao SQL Server Management Studio
• Cancelar a execução de avisos de relatório personalizado
• Usar relatórios personalizados com propriedades de nó do Pesquisador de Objetos