Tipo de conexión de Azure SQL (SSRS)

  • Artículo

Microsoft Azure SQL Database es una base de datos relacional hospedada y basada en la nube, que se integra en las tecnologías de SQL Server. Para incluir en el informe los datos de SQL Database , debe tener un conjunto de datos que se base en un origen de datos de informe de tipo SQL Database. Este tipo de origen de datos integrado se basa en la extensión de datos de SQL Database . Utilice este tipo de origen de datos para conectarse y recuperar datos de SQL Database.

Esta extensión de datos admite parámetros de varios valores, agregados del servidor y credenciales administrados con independencia de la cadena de conexión.

SQL Database es similar a una instancia local de SQL Server y la obtención de datos de SQL Database se realiza, con pocas excepciones, de forma idéntica a como se obtienen de SQL Server.

Nota

Cuando abra una conexión con SQL Database, establezca el tiempo de espera de conexión en 30 segundos.

Para obtener más información, consulte Microsoft Azure SQL Database.

Utilice la información de este tema para crear un origen de datos. Para obtener instrucciones paso a paso, consulte Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes y SSRS).

Cadena de conexión

Cuando se conecta a SQL Database, se conecta a un objeto de base de datos de la nube. Al igual que las bases de datos de sitio, la base de datos hospedada podría tener varios esquemas con varias tablas, vistas y procedimientos almacenados. Especifique el objeto de base de datos que se va a usar en el diseñador de consultas. Si no especifica una base de datos en la cadena de conexión, puede conectar con la base de datos predeterminada que le asignó el administrador.

Póngase en contacto con el administrador de bases de datos y solicite la información de conexión y las credenciales que debe usar para conectar con el origen de datos. En la siguiente cadena de conexión de ejemplo se especifica una base de datos de ejemplo hospedada denominada AdventureWorks.

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;

Además, se usa el cuadro de diálogo Propiedades de orígenes de datos para proporcionar credenciales como nombre de usuario y contraseña. Las opciones User Id y Password se agregan automáticamente a la cadena de conexión, no es necesario escribirlas como parte de dicha cadena.

Para más información y ejemplos de cadenas de conexión, vea Creación de cadenas de conexión de datos - Generador de informes y SSRS.

Credenciales

No se admite la autenticación de Windows (seguridad integrada). Si intenta conectarse a SQL Database utilizando la autenticación de Windows, se producirá un error. SQL Database admite solo la autenticación de SQL Server (nombre de usuario y contraseña) y los usuarios deben proporcionar credenciales (inicio de sesión y contraseña) cada vez que se conecten a SQL Database.

Las credenciales deben ser suficientes para tener acceso a la base de datos. En función de la consulta, podría necesitar otros permisos, como los permisos necesarios para ejecutar procedimientos almacenados y tener acceso a tablas. El propietario del origen de datos externo debe configurar credenciales que sean suficientes para proporcionar a los usuarios acceso de solo lectura a los objetos de base de datos que necesiten.

Desde un cliente de creación de informes, están disponibles las siguientes opciones para especificar las credenciales:

  • Utilizar un nombre de usuario y una contraseña almacenados. Para negociar el salto doble que se produce cuando la base de datos que contiene los datos de informe es distinta del servidor de informes, seleccione opciones para utilizar las credenciales como credenciales de Windows. Puede también decidir suplantar al usuario autenticado tras la conexión al origen de datos.

  • No se necesitan credenciales. Para usar esta opción, debe tener la cuenta de ejecución desatendida configurada en el servidor de informes. Para obtener más información, vea Configurar la cuenta de ejecución desatendida (Administrador de configuración del servidor de informes).

Para más información, consulte Creación de cadenas de conexión de datos - Generador de informes y SSRS o Especificar información de credenciales y conexión para los orígenes de datos de informes.

Consultas

Una consulta especifica qué datos se van a recuperar para un conjunto de datos de informe. Las columnas del conjunto de resultados de una consulta rellenan la colección de campos de un conjunto de datos. Si la consulta devuelve varios conjuntos de resultados, el informe procesa solo el primer conjunto de resultados que la consulta recupera. Aunque hay algunas diferencias entre las bases de datos de SQL Server y SQL Database, por ejemplo el tamaño de las bases de datos admitidas, escribir consultas para bases de datos de SQL Database, es similar a escribir consultas para bases de datos de SQL Server . Algunas instrucciones Transact-SQL como BACKUP no se admiten en SQL Database, pero no se utilizan en consultas de informe. Para obtener más información, vea Tipo de conexión de SQL Server (SSRS).

De forma predeterminada, si crea una nueva consulta o abre una consulta existente que puede ser representada en el diseñador gráfico de consultas, este último está disponible. Puede especificar una consulta de varias maneras:

  • Generar una consulta interactivamente. Utilice el diseñador de consultas relacionales que muestra una vista jerárquica de las tablas, las vistas, los procedimientos almacenados y otros elementos de base de datos, organizada por esquema de la base de datos. Seleccione columnas de las tablas o vistas, o especifique los procedimientos almacenados o las funciones con valores de tabla. Limite el número de filas de datos que desea recuperar especificando los criterios de filtro. Personalice el filtro al ejecutarse el informe estableciendo la opción de parámetro.

  • Escriba o pegue una consulta. Use el diseñador de consultas basado en texto para escribir texto Transact-SQL directamente, para pegar texto de consulta de otro origen, para especificar consultas complejas que no se pueden generar con el diseñador de consultas relacionales o para escribir expresiones basadas en consultas.

  • Importe una consulta existente de un archivo o informe. Utilice el botón de consulta Importar desde cualquier diseñador de consultas para buscar un archivo .sql o .rdl e importar una consulta.

El diseñador de consultas basado en texto admite los dos modos siguientes:

  • Texto: Escriba comandos Transact-SQL que seleccionen datos del origen de datos.

  • Procedimiento almacenado: Elija de una lista de procedimientos almacenados.

Para más información, vea Interfaz de usuario del Diseñador de consultas relacionales (Generador de informes) e Interfaz de usuario del Diseñador de consultas basado en texto (Generador de informes).

El diseñador gráfico de consultas usado por SQL Database proporciona compatibilidad integrada con las agrupaciones y agregados para ayudar a los usuarios a escribir consultas que solo recuperen datos de resumen. Las características de lenguaje de Transact-SQL son: la cláusula GROUP BY, la palabra clave DISTINCT y agregados, como SUM y COUNT. El diseñador de consultas basado en texto es totalmente compatible con el lenguaje de Transact-SQL, incluidas las agrupaciones y los agregados. Para obtener más información sobre Transact-SQL, consulte Referencia de Transact-SQL (motor de base de datos).

Usar consultas de tipo Texto

En el diseñador de consultas basado en texto, escriba comandos de Transact-SQL para definir los datos de un conjunto de datos. Por ejemplo, la siguiente consulta Transact-SQL selecciona todos los nombres de todos los empleados que son asistentes de marketing:

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'

Haga clic en el botón Ejecutar ( ! ) de la barra de herramientas para ejecutar la consulta y mostrar un conjunto de resultados.

Para parametrizar esta consulta, agregue un parámetro de consulta. Por ejemplo, modifique la cláusula WHERE con la siguiente información:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Al ejecutar la consulta, se crean automáticamente parámetros de informe correspondientes a los parámetros de la consulta. Para obtener más información, vea Parámetros de consulta , más adelante en este tema.

Usar consultas de tipo StoredProcedure

Puede especificar un procedimiento almacenado para una consulta del conjunto de datos de una de las maneras siguientes:

  • En el cuadro de diálogo Propiedades del conjunto de datos , establezca la opción Procedimiento almacenado . Elija de la lista desplegable de procedimientos almacenados y funciones con valores de tabla.

  • En el diseñador de consultas relacionales, en el panel Vista de base de datos, seleccione un procedimiento almacenado o una función con valores de tabla.

  • En el diseñador de consultas basado en texto, seleccione StoredProcedure en la barra de herramientas.

Después de seleccionar un procedimiento almacenado o una función con valores de tabla, puede ejecutar la consulta. Se le solicitarán los valores de los parámetros de entrada. Al ejecutar la consulta, se crean automáticamente parámetros de informe correspondientes a los parámetros de entrada. Para obtener más información, vea Parámetros de consulta , más adelante en este tema.

Se admite solo el primer conjunto de resultados que se recupera para un procedimiento almacenado. Si un procedimiento almacenado devuelve varios conjuntos de resultados, se utiliza el primero.

Si un procedimiento almacenado incluye un parámetro que tiene un valor predeterminado, puede tener acceso a dicho valor utilizando la palabra clave DEFAULT como valor del parámetro. Si el parámetro de consulta está vinculado a un parámetro de informe, el usuario puede escribir o seleccionar la palabra DEFAULT en el cuadro de entrada del parámetro de informe.

Para obtener más información sobre los procedimientos almacenados, vea Procedimientos almacenados (motor de base de datos).

Parámetros

Cuando el texto de consulta contiene variables de consulta o procedimientos almacenados con parámetros de entrada, se generan automáticamente los correspondientes parámetros de consulta y parámetros de informe para el informe. El texto de consulta no debe incluir la instrucción DECLARE para cada variable de consulta.

Por ejemplo, la siguiente consulta SQL crea un parámetro de informe denominado EmpID:

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)

De forma predeterminada, cada parámetro de informe tiene el tipo de datos Texto y un conjunto de datos creado automáticamente para proporcionar una lista desplegable de valores disponibles. Una vez creados los parámetros de informe, podría suceder que tenga que cambiar los valores predeterminados. Para más información, consulte Parámetros de informe (Generador de informes y Diseñador de informes).

Comentarios

Extensiones de datos alternativas

También puede recuperar los datos de una base de datos de SQL Server utilizando un tipo de origen de datos ODBC. No se admite la conexión a SQL Database mediante OLE DB.

Para más información, vea Tipo de conexión ODBC (SSRS).

Información de plataforma y de versión

Para más información sobre la compatibilidad con plataformas y versiones, vea Orígenes de datos admitidos por Reporting Services (SSRS).

Azure SQL Database y Microsoft Entra ID

Puede utilizar Azure SQL Database con Microsoft Entra ID (anteriormente Azure Active Directory).

Este escenario se admite al configurar correctamente los siguientes elementos:

Temas de procedimientos

Esta sección contiene instrucciones paso a paso para trabajar con conexiones de datos, orígenes de datos y conjuntos de datos.

Agregar y comprobar una conexión de datos o un origen de datos (Generador de informes y SSRS)

Crear un conjunto de datos compartido o un conjunto de datos incrustado (Generador de informes y SSRS)

Agregar un filtro a un conjunto de datos (Generador de informes y SSRS)

Estas secciones de la documentación proporcionan información conceptual detallada sobre los datos de informe, así como información de procedimientos acerca de cómo definir, personalizar y usar elementos de informe relacionados con datos.

Conjuntos de datos de informe (SSRS)
Proporciona información general sobre cómo obtener acceso a los datos del informe.

Creación de cadenas de conexión de datos - Generador de informes y SSRS
Proporciona información sobre las conexiones de datos y los orígenes de datos.

Conjuntos de datos incrustados y compartidos de informe (Generador de informes y SSRS)
Proporciona información sobre conjuntos de datos compartidos e incrustados.

Colección Campos del conjunto de datos (Generador de informes y SSRS)
Proporciona información sobre la colección de campos de conjunto de datos que genera la consulta.

Orígenes de datos admitidos por Reporting Services (SSRS).
Proporciona información detallada sobre la compatibilidad de versiones y plataformas para cada extensión de datos.

Consulte también

Microsoft Azure SQL Database
Parámetros de informe (Generador de informes y Diseñador de informes)
Filtrar, agrupar y ordenar datos (Generador de informes y SSRS)
Expresiones (Generador de informes y SSRS)