Creación de cadenas de conexión de datos en Report Builder
Se aplica a: SQL Server 2016 (13.x) Reporting Services y versiones posteriores Power BI Report Server SharePoint
Para incluir datos en informes paginados del Generador de informes y Reporting Services, es preciso que antes cree una cadena de conexión para su origen de datos. En este artículo, se explica cómo crear cadenas de conexión de datos y se ofrece información importante relacionada con las credenciales de los orígenes de datos. Un origen de datos incluye el tipo de origen de datos, la información de conexión y el tipo de credenciales necesarios. Para obtener más información, consulte Introducción a los datos de informe en SQL Server Reporting Services (SSRS).
Extensiones de datos integradas
Las extensiones de datos predeterminadas en Reporting Services incluyen Microsoft SQL Server, Microsoft Azure SQL Database y Microsoft SQL Server Analysis Services. Para obtener una lista completa de los orígenes de datos y las versiones que admite Reporting Services, vea Orígenes de datos admitidos por Reporting Services (SSRS).
Ejemplos de cadenas de conexión comunes
Las cadenas de conexión son la representación en texto de las propiedades de conexión para un proveedor de datos. En la tabla siguiente se muestran ejemplos de cadenas de conexión para diversos tipos de conexión.
Nota:
Connectionstrings.com es otro recurso para obtener ejemplos de las cadenas de conexión.
Origen de datos | Ejemplo | Descripción |
---|---|---|
Base de datos de SQL Server en el servidor local | Data Source="(local)"; Initial Catalog=AdventureWorks |
Establezca el tipo de origen de datos en Microsoft SQL Server. Para obtener más información, vea Tipo de conexión de SQL Server (SSRS). |
Instancia con nombre de SQL Server | Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks |
Establezca el tipo de origen de datos en Microsoft SQL Server. Para obtener más información, vea Tipo de conexión de SQL Server (SSRS). |
Azure SQL Database | Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True |
Establezca el tipo de origen de datos en Microsoft Azure SQL Database. Para obtener más información, vea Tipo de conexión SQL Azure (SSRS). |
Almacenamiento de datos paralelo de SQL Server | HOST=<IP address>; database=AdventureWorks; port=<port> |
Establezca el tipo de origen de datos en Microsoft SQL Server Parallel Data Warehouse. Para obtener más información, vea Tipo de conexión Almacenamiento de datos paralelo de SQL Server (SSRS). |
Base de datos de Analysis Services en el servidor local | Data Source=localhost; Initial Catalog=Adventure Works DW |
Establezca el tipo de origen de datos en Microsoft SQL Server Analysis Services. Para más información, vea Tipo de conexión de Analysis Services para MDX (SSRS) o Tipo de conexión de Analysis Services para DMX (SSRS). |
Base de datos de modelo tabular de Analysis Services con una perspectiva Sales | Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' |
Establezca el tipo de origen de datos en Microsoft SQL Server Analysis Services. Especifique el nombre de la perspectiva en la configuración cube= . Para obtener más información, consulte Perspectivas en modelos tabulares. |
Azure Analysis Services | Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks |
Establezca el tipo de origen de datos en Microsoft SQL Server Analysis Services. Para obtener más información, consulte Extensión de procesamiento de datos de Microsoft SQL Server Analysis Services. |
Servidor Oracle | Data Source=<host> |
Configure el tipo de origen de datos en Oracle. También es necesario instalar las herramientas de cliente de Oracle tanto en el equipo del Diseñador de informes como en el servidor de informes. Para obtener más información, consulte Tipo de conexión de Oracle (SSRS y Power BI Report Server). |
Origen de datos SAP Netweaver BI | Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla |
Configure el tipo de origen de datos en SAP NetWeaver BI. Para obtener más información, consulte Tipo de conexión de SAP NetWeaver BI (SSRS). |
Origen de datos de Hyperion Essbase | Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample |
Configure el tipo de origen de datos en Hyperion Essbase. Para obtener más información, consulte Tipo de conexión de Hyperion Essbase (SSRS). |
Origen de datos de Teradata | Data Source=<NNN>.<NNN>.<NNN>.<NNN>; |
Configure el tipo de origen de datos en Teradata. La cadena de conexión es una dirección IP (protocolo de Internet) formada por cuatro campos, donde cada campo puede tener de uno a tres dígitos. Para obtener más información, consulte Tipo de conexión de Teradata (SSRS). |
Origen de datos de Teradata | Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True |
Establezca el tipo de origen de datos en Teradata, de modo similar a como se hizo en el ejemplo anterior. Use solamente la base de datos predeterminada que se especifica en la etiqueta Database , sin detectar automáticamente las relaciones de los datos. |
Origen de datos XML, servicio web | data source=https://adventure-works.com/results.aspx |
Configure el tipo de origen de datos en XML. La cadena de conexión es una dirección URL de un servicio web que admite el Lenguaje de definición de servicios web (WSDL). Para obtener más información, consulte Tipo de conexión XML (SSRS). |
Origen de datos XML, documento XML | https://localhost/XML/Customers.xml |
Configure el tipo de origen de datos en XML. La cadena de conexión es una dirección URL que lleva al documento XML. |
Origen de datos XML, documento XML incrustado | Vacía | Configure el tipo de origen de datos en XML. Los datos XML se incrustan en la definición de informe. |
Lista de SharePoint | Data Source=https://MySharePointWeb/MySharePointSite/ |
Establezca el tipo de origen de datos en SharePoint List. |
Conjunto de datos de Power BI Premium (a partir de Reporting Services 2019 y Power BI Report Server de enero de 2020) | Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> |
Establezca el tipo de origen de datos en Microsoft SQL Server Analysis Services. |
Si no puede conectarse con un servidor de informes mediante localhost, asegúrese de haber habilitado el protocolo de red TCP/IP. Para más información, consulte Configurar protocolos de cliente.
Para obtener más información sobre las configuraciones necesarias para conectar con estos tipos de orígenes de datos, vea el artículo sobre conexiones de datos específicas en Agregar datos de orígenes de datos externos (SSRS) y Orígenes de datos admitidos por Reporting Services (SSRS).
Caracteres especiales en una contraseña
Si configura el origen de datos ODBC o SQL con una contraseña, es posible que se encuentre errores con caracteres especiales. Si un usuario introduce la contraseña con caracteres especiales, como signos de puntuación, algunos controladores subyacentes del origen de datos no pueden validar los caracteres especiales. Cuando procese el informe, es posible que aparezca un mensaje para indicarle que la contraseña no es válida. Si cambiar la contraseña resulta poco práctico, hable con el administrador de la base de datos para almacenar las credenciales adecuadas en el servidor como parte de un nombre del origen de datos OBDC (DSN) del sistema. Para obtener más información, vea OdbcConnection.ConnectionString en la documentación de .NET Framework.
Cadenas de conexión basadas en expresiones
Las cadenas de conexión basadas en expresiones se evalúan en tiempo de ejecución. Por ejemplo, puede especificar el origen de datos como un parámetro, incluir la referencia de parámetro en la cadena de conexión y permitir al usuario elegir un origen de datos para el informe. Por ejemplo, imagine que una empresa multinacional tiene servidores de datos en varios países o regiones. Con una cadena de conexión basada en una expresión, un usuario que ejecute un informe de ventas puede seleccionar un origen de datos para un país o región determinado antes de ejecutar el informe.
El ejemplo siguiente ilustra el uso de una expresión de origen de datos en una cadena de conexión de SQL Server. En el ejemplo se da por hecho que se ha creado un parámetro de informe denominado ServerName
:
="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"
Las expresiones de origen de datos se procesan en tiempo de ejecución o cuando se genera una vista previa del informe. La expresión debe estar escrita en Visual Basic. Use las directrices siguientes cuando defina una expresión de origen de datos:
Diseñe el informe usando una cadena de conexión estática. Una cadena de conexión estática es un cadena de conexión que no se establece a través de una expresión. Por ejemplo, al seguir los pasos para crear un origen de datos compartido o específico del informe, va a definir una cadena de conexión estática. Usar una cadena de conexión estática permite conectarse al origen de datos en el Diseñador de informes, de forma que puede obtener los resultados de la consulta que necesita para crear el informe.
Cuando defina una conexión de origen de datos, no use un origen de datos compartido. No es posible usar una expresión de origen de datos en un origen de datos compartido. Deberá definir un origen de datos incrustado para el informe.
Especifique las credenciales independientemente de la cadena de conexión. Puede utilizar credenciales almacenadas, credenciales solicitadas o seguridad integrada.
Agregue un parámetro de informe para especificar un origen de datos. Para los valores de parámetro, puede proporcionar una lista estática de valores disponibles o definir una consulta que recupere una lista de orígenes de datos en tiempo de ejecución. En este caso, la lista estática de valores disponibles deben ser orígenes de datos que puede usar con el informe.
Asegúrese de que la lista de orígenes de datos comparta el mismo esquema de la base de datos. El diseño de un informe empieza con la información de esquema. Si el esquema utilizado para definir el informe y el esquema real utilizado por el informe en tiempo de ejecución no coinciden, es posible que el informe no se ejecute.
Antes de publicar el informe, reemplace la cadena de conexión estática con una expresión. Espere hasta que haya finalizado de diseñar el informe para reemplazar la cadena de conexión estática con una expresión. Una vez que use una expresión, no podrá ejecutar la consulta en el Diseñador de informes. Además, la lista de campos del panel Datos de informe y la lista Parámetros no se actualizan de forma automática.
Contenido relacionado
- Introducción a los datos de informe en SQL Server Reporting Services (SSRS)
- Creación y modificación de orígenes de datos compartidos
- Creación y modificación de orígenes de datos incrustados
¿Tiene alguna pregunta más? Puede plantear sus dudas en el foro de Reporting Services.