Interface de usuário do Designer de Consulta com base em texto (Construtor de Relatórios 3.0)
Use o designer de consulta com base em texto para especificar uma consulta usando o idioma de consulta suportado pela fonte de dados, execute a consulta e exiba os resultados no tempo de design. Você pode especificar várias instruções do Transact-SQL, consulta ou sintaxe de comando para as extensões de processamento de dados e consultas que são especificadas como expressões. Como o designer de consulta com base em texto não processa previamente a consulta e pode acomodar qualquer tipo de sintaxe de consulta, esta é a ferramenta de designer de consulta padrão para muitos tipos de fontes de dados.
.gif "Observação sobre segurança") Observação sobre segurança |
|---|
Os usuários acessam fontes de dados quando criam e executam consultas. Você deve conceder permissões mínimas nas fontes de dados, como permissões somente leitura. |
O designer de consulta com base em texto exibe uma barra de ferramentas e os dois painéis a seguir são exibidos:
Consulta Mostra o texto da consulta, o nome da tabela ou o nome do procedimento armazenado, dependendo do tipo de consulta. Nem todos os tipos de consulta estão disponíveis para todos os tipos de fontes de dados. Por exemplo, o nome da tabela é suportado somente para o tipo de fonte de dados OLE DB.
Resultado Mostra os resultados da execução da consulta no tempo de design.
Barra de ferramentas do Designer de Consulta com base em texto
O designer de consulta com base em texto fornece uma barra de ferramentas simples para todos os tipos de comando. A tabela a seguir lista cada botão e suas respectivas funções na barra de ferramentas.
Botão |
Descrição |
|---|---|
Editar como Texto |
Alterna entre o designer de consulta com base em texto e o designer de consultas gráficas. Nem todos os tipos de fonte de dados são suportados pelos designers de consulta gráfico. |
Importar |
Importa uma consulta existente de um arquivo ou relatório. Apenas os tipos de arquivo .sql e .rdl têm suporte |
.gif "Executar a consulta") |
Executa a consulta e exibe o conjunto de resultados no painel Resultado. |
Tipo de Comando |
Selecione Text, StoredProcedure ou TableDirect. Se um procedimento armazenado tiver parâmetros, a caixa de diálogo Definir Parâmetros de Consulta será aberta quando você clicar em Executar na barra de ferramentas e os valores poderão ser preenchidos, conforme necessário. .gif "Observação") Observação
Se um procedimento armazenado retornar mais de um conjunto de resultados, somente o primeiro será usado para preencher o conjunto de dados.
|
Tipo de comando Text
Quando você cria um conjunto de dados SQL Server, o designer de consulta relacional é aberto por padrão. Para alternar para o designer de consulta com base em texto, clique no botão de alternância Editar como Texto na barra de ferramentas. O designer de consulta com base em texto apresenta dois painéis: Consulta e Resultado. A imagem a seguir define cada painel.
.gif "Designer de consulta genérico, para consulta de dados relacional")
A tabela a seguir descreve a função de cada painel.
Painel |
Função |
|---|---|
Consulta |
Exibe o texto da consulta do Transact-SQL. Use para gravar ou editar uma consulta do Transact-SQL. |
Resultado |
Exibe os resultados da consulta. Para executar a consulta, clique com o botão direito do mouse em qualquer painel e clique em Executar ou clique no botão Executar na barra de ferramentas. |
Exemplo
A consulta a seguir retorna a lista de sobrenomes da tabela ContactType do banco de dados AdventureWorks2008R22008 para o esquema Person.
SELECT Name FROM Person.ContactType
Ao clicar em Executar, na barra de ferramentas, o comando no painel Consulta será executado e os resultados serão exibidos no painel Resultado. O conjunto de resultados exibe uma lista de 20 tipos de contatos, por exemplo, Proprietário ou Agente de Vendas.
Tipo de comando StoredProcedure
Quando você seleciona o Tipo de comandoStoredProcedure, o designer de consulta com base em texto apresenta dois painéis: Consulta e Resultado. Insira o nome do procedimento armazenado no painel Consulta e clique em Executar na barra de ferramentas. Se o procedimento armazenado usar parâmetros, a caixa de diálogo Definir Parâmetros de Consulta será exibida. Insira os valores de parâmetro para o procedimento armazenado. Um parâmetro de relatório é criado para cada parâmetro de entrada de procedimento armazenado.
A figura a seguir mostra os painéis Consulta e Resultados quando você executa um procedimento armazenado. Neste caso, os parâmetros de entrada são constantes.
.gif "Procedimento armazenado no designer de consulta baseado em texto")
A tabela a seguir descreve a função de cada painel.
Painel |
Função |
|---|---|
Consulta |
Exibe o nome do procedimento armazenado e os parâmetros de entrada. |
Resultado |
Exibe os resultados da consulta. Para executar a consulta, clique com o botão direito do mouse em qualquer painel e clique em Executar ou clique no botão Executar na barra de ferramentas. |
Exemplo
A consulta a seguir chama o procedimento armazenado uspGetWhereUsedProductID do AdventureWorks2008R22008. Você deve inserir um valor para o parâmetro do número de identificação do produto quando executar a consulta.
uspGetWhereUsedProductID
Clique no botão Executar (!). Quando os parâmetros de consulta forem solicitados, use a seguinte tabela para digitar valores.
@StartProductID |
820 |
@CheckDate |
20010115 |
Para a data especificada, o conjunto de resultados exibe uma lista de 13 identificadores de produtos que usaram o número de componente especificado.
Tipo de comando TableDirect
Ao selecionar o Tipo de comandoTableDirect, o designer de consulta com base em texto apresenta dois painéis: Consulta e Resultado. Se você inserir uma tabela e clicar no botão Executar, todas as colunas dessa tabela serão retornadas.
Exemplo
Para um tipo de fonte de dados OLE DB, a seguinte consulta de banco de dados retorna um conjunto de resultados para todos os tipos de contatos no banco de dados AdventureWorks2008R22008.
Person.ContactType
Quando você insere o nome da tabela Person.ContactType, esse procedimento equivale à criação da instrução SELECT * FROM Person.ContactType do Transact-SQL.
Consulte também