Пользовательский интерфейс текстового конструктора запросов (построитель отчетов)

Текстовый конструктор запросов предназначен для ввода запроса на языке запросов, поддерживаемом источником данных, его выполнения и просмотра результатов во время разработки. Можно указать несколько инструкций, запросов или команд языка Transact-SQL для создания собственных модулей обработки данных, а также указать запросы, заданные как выражения. Поскольку текстовый конструктор запросов не выполняет предварительную обработку запроса и позволяет использовать любой синтаксис запросов, он представляет собой стандартное средство конструктора запросов для источников данных многих типов.

Внимание

При создании и выполнении запросов пользователи получают доступ к источникам данных. Следует предоставить минимальные разрешения на источники данных, например разрешение только на чтение.

В окне текстового конструктора запросов отображаются панель инструментов и следующие две области.

• Запрос Показывает текст запроса, имя таблицы или имя хранимой процедуры, в зависимости от типа запроса. Не все типы запросов поддерживаются всеми типами источников данных. Например, имя таблицы поддерживается только для типа источника данных OLE DB.

• Результат Показывает результаты выполнения запроса во время разработки.

Панель инструментов текстового конструктора запросов

Текстовый конструктор запросов предоставляет одну панель инструментов для всех типов команд. В следующей таблице перечислены все кнопки панели инструментов и их функции.

Button	Description
Редактировать как текст	Переключиться из текстового конструктора запросов в графический и обратно. Не все источники данных поддерживают графические конструкторы запросов.
Импорт	Импорт существующего запроса из файла или отчета. Поддерживаются только SQL-файлы и RDL-файлы.
	Выполнить запрос и показать результирующий набор в панели результатов.
Тип команды	Выберите Text, StoredProcedureили TableDirect. Если хранимая процедура имеет параметры, при нажатии на панели инструментов кнопки Выполнить появится диалоговое окно Определение параметров запроса , в котором можно ввести значения параметров. Поддержка типов команд зависит от типа источника данных. Например, TableDirectподдерживают только OLE DB и ODBC. Примечание. Если хранимая процедура возвращает несколько результирующих наборов, для заполнения набора данных значениями используется только первый из них.

Тип команды Text

При создании набора данных SQL Server конструктор реляционных запросов по умолчанию открывается. Чтобы переключиться в текстовый конструктор запросов, нажмите кнопку переключателя Редактировать как текст на панели инструментов. В окне текстового конструктора запросов отображаются две панели: панель запросов и область результатов. На следующем рисунке показана каждая панель.

В следующей таблице описываются функции каждой панели.

Панель	Функция
Query	Отображает текст запроса Transact-SQL. Используйте эту панель, чтобы написать или изменить запрос Transact-SQL.
Результат	Отображает результаты запроса. Чтобы выполнить запрос, щелкните правой кнопкой мыши любую область и выберите команду Выполнитьлибо нажмите кнопку Выполнить на панели инструментов.

пример

Следующий запрос возвращает список имен из AdventureWorks2022 таблицы ContactType базы данных для схемы Person.

SELECT Name FROM Person.ContactType  

При нажатии кнопки Выполнить на панели инструментов выполняется команда на панели Запрос , а результаты выводятся на панели Результат . Результирующий набор отображает список из 20 типов контактов, например владельца или агента по продажам.

Тип команды StoredProcedure

Если выбран Тип команды StoredProcedure, то текстовый конструктор запросов содержит две панели: панель запросов и область результатов. Введите имя хранимой процедуры в области «Запрос» и нажмите кнопку Выполнить на панели инструментов. Если хранимые процедуры используют параметры, откроется диалоговое окно Определение параметров запроса . Введите значения параметров для хранимой процедуры. Параметр отчета создается для каждого входного параметра хранимой процедуры.

На следующем рисунке показаны области «Запрос» и «Результаты» при выполнении хранимой процедуры. В данном случае входные параметры являются константами.

В следующей таблице описываются функции каждой панели.

Панель	Функция
Query	Отображает имя хранимой процедуры и все входные параметры.
Результат	Отображает результаты запроса. Чтобы выполнить запрос, щелкните правой кнопкой мыши любую область и выберите команду Выполнитьлибо нажмите кнопку Выполнить на панели инструментов.

пример

Следующий запрос вызывает хранимую AdventureWorks2022 процедуру uspGetWhereUsedProductID. При запуске этого запроса необходимо задать значение параметра с идентификационным номером продукта.

uspGetWhereUsedProductID  

Нажмите кнопку Выполнить (!). При получении запроса на ввод параметров введите значения из следующей таблицы.

Параметр	значение
@StartProductID	820
@CheckDate	20010115

Для указанной даты результирующий набор отображает список из 13 идентификаторов продуктов, которые используют указанный номер компонента.

Тип команды TableDirect

Если выбран Тип команды TableDirect, то текстовый конструктор запросов содержит две панели: панель запросов и область результатов. Если ввести имя таблицы и нажать кнопку Выполнить , возвращаются все столбцы этой таблицы.

пример

Для типа источника данных OLE DB следующий запрос набора данных возвращает результирующий набор для всех типов контактов в AdventureWorks2022 базе данных.

Person.ContactType

Ввод имени таблицы Person.ContactType эквивалентен созданию на языке Transact-SQL инструкции SELECT * FROM Person.ContactType.

См. также

Пользовательский интерфейс конструктора реляционных запросов (построитель отчетов)
Средства разработки запросов (SSRS)