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.

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
	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. 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.

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.

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

Conceitos

Interface de usuário do Designer de Consulta relacional (Construtor de Relatórios 3.0)

Outros recursos

Designers de Consulta (Construtor de Relatórios 3.0)