Interfaz de usuario del Diseñador de consultas basado en texto (Generador de informes)

Use el diseñador de consultas basado en texto para especificar una consulta mediante el lenguaje de consulta admitido por el origen de datos, para ejecutar la consulta y para ver los resultados en tiempo de diseño. Puede especificar varias sintaxis de consulta, comandos o instrucciones Transact-SQL para extensiones de procesamiento de datos personalizadas, y consultas que se especifican como expresiones. Dado que el generador de consultas basado en texto no procesa previamente la consulta y puede acomodar todo tipo de sintaxis de consulta, es la herramienta de generación de consultas predeterminada para varios tipos de orígenes de datos.

El diseñador de consultas basado en texto muestra una barra de herramientas y los dos paneles siguientes:

• Consulta Muestra el texto de la consulta, el nombre de tabla o el nombre del procedimiento almacenado, dependiendo del tipo de consulta. No todos los tipos de consulta están disponibles para todos los tipos de origen de datos. Por ejemplo, el nombre de tabla solamente es compatible con el tipo de orígenes de datos OLE DB.

• Resultado Muestra los resultados de la ejecución de la consulta en tiempo de diseño.

Barra de herramientas del diseñador de consultas basado en texto

El diseñador de consultas basado en texto proporciona una sola barra de herramientas para todos los tipos de comando. La tabla siguiente contiene una lista con los botones de la barra de herramientas y sus funciones.

Botón	Descripción
Editar como texto	Alterna entre el diseñador de consultas basado en texto y el diseñador gráfico de consultas. No todos los tipos de orígenes de datos admiten diseñadores gráficos de consultas.
Importar	Importe una consulta existente de un archivo o informe. Solo se admiten los tipos de archivo sql y rdl.
	Ejecuta la consulta y muestra el conjunto de resultados en el panel Resultado.
Tipo de comando	Seleccione Text, StoredProcedureo TableDirect. Si un procedimiento almacenado tiene parámetros, el cuadro de diálogo Definir parámetros de consulta aparece al hacer clic en Ejecutar en la barra de herramientas; puede rellenar los valores según sea necesario. La compatibilidad del tipo de comando varía en función del tipo de origen de datos. Por ejemplo, solamente OLE DB y ODBC son compatibles con TableDirect. Nota: Si un procedimiento almacenado devuelve más de un conjunto de resultados, solo se usa el primero para rellenar el conjunto de datos.

Tipo de comando Text

Al crear un conjunto de datos de SQL Server , el diseñador de consultas relacionales se abre de forma predeterminada. Para cambiar al diseñador de consultas basado en texto, haga clic en el botón de alternancia Editar como texto de la barra de herramientas. El diseñador de consultas basado en texto consta de dos paneles: el panel Consulta y el panel Resultado. En la siguiente ilustración se indica el nombre de cada panel.

En la siguiente tabla se describe la función de cada panel.

Ejemplo

La siguiente consulta devuelve la lista de nombres de la tabla ContactType de la base de datos AdventureWorks2022 para el esquema Person.

SELECT Name FROM Person.ContactType  

Si hace clic en Ejecutar en la barra de herramientas, el comando del panel Consulta se ejecuta y los resultados se muestran en el panel Resultado . El conjunto de resultados muestra una lista de 20 tipos de contactos; por ejemplo, Owner o Sales Agent.

Tipo de comando StoredProcedure

Si selecciona Tipo de comando StoredProcedure, el diseñador de consultas basado en texto presenta dos paneles: el panel Consulta y el panel Resultado. Escriba el nombre del procedimiento almacenado en el panel Consulta y haga clic en Ejecutar en la barra de herramientas. Si el procedimiento almacenado utiliza parámetros, se abre el cuadro de diálogo Definir parámetros de consulta . Escriba los valores de los parámetros para el procedimiento almacenado. Se crea un parámetro de informe para cada parámetro de entrada de procedimiento almacenado.

La figura siguiente muestra los paneles Consulta y Resultado al ejecutar un procedimiento almacenado. En este caso, los parámetros de entrada son constantes.

En la siguiente tabla se describe la función de cada panel.

Ejemplo

La consulta siguiente llama a un procedimiento almacenado de AdventureWorks2022 denominado uspGetWhereUsedProductID. Debe especificar un valor para el parámetro de número de identificación de producto al ejecutar la consulta.

uspGetWhereUsedProductID  

Haga clic en el botón Ejecutar ( ! ). Cuando se le soliciten los parámetros de consulta, use la tabla siguiente para escribir los valores.

Para la fecha especificada, el conjunto de resultados muestra una lista de 13 identificadores del producto que utilizaron el número de componente especificado.

Tipo de comando TableDirect

Si selecciona Tipo de comando TableDirect, el diseñador de consultas basado en texto presenta dos paneles: el panel Consulta y el panel Resultado. Si selecciona una tabla y hace clic en el botón Ejecutar , se devolverán todas las columnas de dicha tabla.

Ejemplo

En el caso de un tipo de origen de datos OLE DB, la siguiente consulta del conjunto de datos devuelve un conjunto de resultados para todos los tipos de contacto de la base de datos AdventureWorks2022.

Person.ContactType

Especificar el nombre de tabla Person.ContactType equivale a crear la instrucción Transact-SQL SELECT * FROM Person.ContactType.

Consulte también

Interfaz de usuario del Diseñador de consultas relacionales (Generador de informes)
Herramientas de diseño de consulta (SSRS)