基于文本的查询设计器用户界面 (Power BI Report Builder)

适用于： Power BI Report Builder Power BI Desktop

使用基于文本的查询设计器可以用数据源支持的查询语言来指定查询，还可以运行查询并在运行时查看结果。 可以指定多个 Transact-SQL 语句，为自定义数据处理扩展插件指定查询或命令语法，还可以指定指定为表达式的查询。 因为基于文本的查询设计器不会对查询进行预处理，并且能适应任何类型的查询语法，所以成为了众多数据源类型的默认查询设计器工具。

基于文本的查询设计器将显示工具栏和以下两个窗格：

• 查询 ：根据查询类型的不同，显示查询文本、表名或存储过程名称。 并非所有查询类型都适用于所有数据源类型。 例如，只有数据源类型 OLE DB 支持表名。

• 结果 ：在设计时，显示查询的运行结果。

基于文本的查询设计器工具栏

基于文本的查询设计器为所有命令类型都提供一个单一工具栏。 下表列出了该工具栏中的每个按钮及其功能。

Button	描述
编辑为文本	在基于文本的查询设计器和图形查询设计器之间切换。 并非所有的数据源类型都支持图形查询设计器。
导入	从文件或报表中导入现有的查询。 仅支持文件类型 sql 和 rdl
	运行查询并在“结果”窗格中显示结果集。
命令类型	选择 Text、 StoredProcedure或 TableDirect。 如果存储过程带有参数，则选择工具栏上的“运行”时，将出现“定义查询参数”对话框，你可以根据需要填入值。 所支持的命令类型因数据源类型而异。 例如，仅 OLE DB 和 ODBC 支持 TableDirect。 注意：如果存储过程返回多个结果集，则仅使用第一个结果集填充数据集。

命令类型文本

创建 SQL Server 数据集时，默认情况下，关系查询设计器将会打开。 若要切换为基于文本的查询设计器，请选择工具栏上的“编辑为文本”切换按钮。 基于文本的查询设计器将显示两个窗格：“查询”窗格和“结果”窗格。 下图标出了每个窗格。

下表介绍了每个窗格的功能。

示例

以下查询将从用于 Person 架构的 AdventureWorks2014 数据库的 ContactType 表返回名称列表。

SELECT Name FROM Person.ContactType  

选择工具栏上的“运行”时，将运行“查询”窗格中的命令，并在“结果”窗格中显示结果。 结果集显示 20 种联系人类型（例如“所有者”或“销售代理”）的列表。

命令类型 StoredProcedure

选择“Command typeStoredProcedure”时，基于文本的查询设计器将显示两个窗格：“查询”窗格和“结果”窗格。 在“查询”窗格中输入存储过程的名称，然后选择工具栏中的“运行”按钮。 如果存储过程使用参数，将打开“定义查询参数”对话框。 输入存储过程的参数值。 对于每个存储过程输入参数，都会创建一个报表参数。

下图显示运行存储过程时的“查询”和“结果”窗格。 在此示例中，输入参数为常量。

下表介绍了每个窗格的功能。

示例

以下查询将调用 AdventureWorks2014 存储过程 uspGetWhereUsedProductID。 在运行查询时，您必须为产品标识号参数输入一个值。

uspGetWhereUsedProductID  

选择“运行”(!) 按钮。 提示输入查询参数的值时，请使用下表来输入值。

对于指定日期，结果集显示使用指定组件号的 13 个产品标识符列表。

命令类型 TableDirect

选择“Command typeTableDirect”时，基于文本的查询设计器将显示两个窗格：“查询”窗格和“结果”窗格。 如果输入一个表并选择“运行”按钮，则将返回该表的所有列。

示例

对于数据源类型 OLE DB，以下数据集查询将为 AdventureWorks2014 数据库中的所有联系人类型返回结果集。

Person.ContactType

如果输入表名 Person.ContactType，则等同于创建 Transact-SQL 语句 SELECT * FROM Person.ContactType。

相关内容

• Power BI Report Builder