> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Microsoft Power BI es un software interactivo de visualización de datos desarrollado por Microsoft, centrado principalmente en la inteligencia empresarial.
# Power BI
export const ClickHouseSupportedBadge = () => {
return
Compatible con ClickHouse
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Microsoft Power BI puede consultar o cargar en memoria datos de [ClickHouse Cloud](https://clickhouse.com/cloud) o de una implementación autogestionada.
Existen varias versiones de Power BI que puede usar para visualizar sus datos:
* Power BI Desktop: una aplicación de escritorio para Windows para crear paneles y visualizaciones
* Power BI Service: disponible en Azure como servicio SaaS para alojar los paneles creados en Power BI Desktop
Power BI requiere que cree los paneles en la versión Desktop y luego los publique en Power BI Service.
Este tutorial le guiará por el proceso de:
* [Instalar el ClickHouse ODBC Driver](#install-the-odbc-driver)
* [Instalar el conector de ClickHouse para Power BI en Power BI Desktop](#power-bi-installation)
* [Consultar datos de ClickHouse para visualizarlos en Power BI Desktop](#query-and-visualise-data)
* [Configurar una puerta de enlace de datos local para Power BI Service](#power-bi-service)
## Requisitos previos
### Instalación de Power BI
Este tutorial supone que tienes Microsoft Power BI Desktop instalado en tu equipo con Windows. Puedes descargar e instalar Power BI Desktop [aquí](https://www.microsoft.com/en-us/download/details.aspx?id=58494)
Recomendamos actualizar a la versión más reciente de Power BI. ClickHouse Connector está disponible de forma predeterminada a partir de la versión `2.137.751.0`.
### Recopila los datos de conexión de ClickHouse
Necesitarás los siguientes datos para conectarte a tu instancia de ClickHouse:
* Hostname - ClickHouse
* Nombre de usuario - Credenciales de usuario
* Contraseña - Contraseña del usuario
* Base de datos - Nombre de la base de datos de la instancia a la que quieres conectarte
## Power BI Desktop
Para empezar a consultar datos en Power BI Desktop, deberás seguir estos pasos:
1. Instala el ODBC Driver de ClickHouse
2. Busca el ClickHouse Connector
3. Conéctate a ClickHouse
4. Consulta y visualiza tus datos
### Instalar el ODBC Driver
Descargue la [versión más reciente de ClickHouse ODBC](https://github.com/ClickHouse/clickhouse-odbc/releases).
Ejecute el instalador `.msi` suministrado y siga el asistente.
`Debug symbols` son opcionales y no son necesarios
#### Verificar el ODBC Driver
Cuando se complete la instalación del ODBC Driver, puede comprobar que se haya realizado correctamente de la siguiente manera:
Busque ODBC en el menú Inicio y seleccione "ODBC Data Sources **(64-bit)**".
Compruebe que el controlador de ClickHouse aparezca en la lista.
### Buscar el ClickHouse Connector
Disponible en la versión `2.137.751.0` de Power BI Desktop
En la pantalla de inicio de Power BI Desktop, haga clic en «Get Data».
Busque «ClickHouse».
### Conectarse a ClickHouse
Seleccione el conector e introduzca las credenciales de la instancia de ClickHouse:
* Host (obligatorio) - El dominio o la dirección de su instancia. Asegúrese de introducirlo sin prefijos ni sufijos.
* Port (obligatorio) - El puerto de su instancia.
* Database - El nombre de su base de datos.
* Options - Cualquier opción de ODBC, como se indica
en la [página de GitHub de ClickHouse ODBC](https://github.com/ClickHouse/clickhouse-odbc#configuration)
* Data Connectivity mode - DirectQuery
Recomendamos seleccionar DirectQuery para consultar ClickHouse directamente.
Si su caso de uso implica una cantidad pequeña de datos, puede elegir el modo de importación y se cargarán todos los datos en Power BI.
* Especifique el nombre de usuario y la contraseña
### Consultar y visualizar datos
Por último, deberías ver las bases de datos y las tablas en la vista Navigator. Selecciona la tabla que quieras y haz clic en "Load" para
importar los datos desde ClickHouse.
Una vez finalizada la importación, los datos de ClickHouse deberían estar disponibles en Power BI como de costumbre.
## Power BI Service
Para usar Microsoft Power BI Service, debe crear una [puerta de enlace de datos local](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-onprem).
Para obtener más información sobre cómo configurar conectores personalizados, consulte la documentación de Microsoft sobre cómo [usar conectores de datos personalizados con una puerta de enlace de datos local](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-custom-connectors).
## ODBC Driver (solo importación)
Recomendamos usar ClickHouse Connector con DirectQuery.
Instale el [ODBC Driver](#install-the-odbc-driver) en la instancia de la puerta de enlace de datos local y [verifique](#verify-odbc-driver) tal como se indicó anteriormente.
### Crear un nuevo DSN de usuario
Cuando se complete la instalación del controlador, se puede crear un origen de datos ODBC. Busca ODBC en el menú Inicio y selecciona «ODBC Data Sources (64-bit)».
Aquí debes agregar un nuevo DSN de usuario. Haz clic en el botón «Add» de la izquierda.
Elige la versión Unicode del controlador ODBC.
Completa los datos de conexión.
Si usas un despliegue con SSL habilitado (por ejemplo, ClickHouse Cloud o una instancia autogestionada), en el campo `SSLMode` debes indicar `require`.
* `Host` siempre debe omitirse con el protocolo (es decir, `http://` o `https://`).
* `Timeout` es un número entero que representa segundos. Valor predeterminado: `30 seconds`.
### Importar datos en Power BI
Si aún no tiene Power BI instalado,
[descargue e instale Power BI Desktop](https://www.microsoft.com/en-us/download/details.aspx?id=58494).
En la pantalla de inicio de Power BI Desktop, haga clic en "Get Data".
Seleccione "Other" -> "ODBC".
Seleccione en la lista la fuente de datos que creó anteriormente.
Si no especificó credenciales al crear la fuente de datos, se le pedirá que indique el nombre de usuario y la contraseña.
Por último, debería ver las bases de datos y las tablas en la vista Navigator. Seleccione la tabla deseada y haga clic en "Load" para importar los datos desde ClickHouse.
Una vez completada la importación, podrá acceder a sus datos de ClickHouse en Power BI como de costumbre.
## Optimización del trabajo con grandes conjuntos de datos
PowerBI está diseñado para bases de datos tradicionales orientadas a filas con volúmenes de datos moderados. Al trabajar con ClickHouse a escala (miles de millones de filas), se requieren patrones arquitectónicos específicos para obtener un rendimiento óptimo.
PowerBI genera automáticamente consultas SQL con subconsultas anidadas, joins complejos y transformaciones en tiempo real. Estos patrones funcionan bien con bases de datos SQL tradicionales, pero pueden ser ineficientes al consultar bases de datos columnares a gran escala como ClickHouse.
**Enfoque recomendado para grandes conjuntos de datos:** En lugar de consultar directamente las tablas sin procesar, cree `vistas materializadas` dedicadas en ClickHouse para cada visualización del panel. Esto le proporciona:
* Un rendimiento rápido y consistente, independientemente del volumen de datos
* Menor carga en su clúster de ClickHouse
* Costes más predecibles
Si sus paneles son lentos, consulte el [`query_log`](/docs/es/reference/system-tables/query_log) de ClickHouse para ver qué consultas SQL está ejecutando realmente Power BI. Entre los problemas habituales se incluyen las subconsultas anidadas, el escaneo de tablas completas o los joins ineficientes. Una vez que identifique el problema, cree [vistas materializadas](/docs/es/concepts/features/materialized-views/index) que resuelvan esos problemas específicos.
### Buenas prácticas de implementación
#### Estrategia de preagregación
Cree vistas materializadas en varios niveles de agregación:
* Agregaciones horarias para dashboards recientes y detallados
* Agregaciones diarias para tendencias históricas
* Rollups mensuales para informes a largo plazo
* Mantenga los datos sin procesar con un TTL adecuado para análisis ad hoc
#### Optimización del modelado de datos
* Defina claves de `ORDER BY` acordes con sus patrones de consulta
* Use el particionamiento para datos de series temporales
* Convierta las tablas de dimensiones pequeñas en diccionarios para realizar búsquedas eficientes
* Aproveche las proyecciones para optimizar aún más las consultas
## Limitaciones conocidas
### UInt64
Los tipos de enteros sin signo como UInt64 o superiores no se cargarán automáticamente en el conjunto de datos, ya que Int64 es el tipo de entero más grande que admite Power BI.
Para importar los datos correctamente, antes de pulsar el botón "Load" en el Navigator, haga clic primero en "Transform Data".
En este ejemplo, la tabla `pageviews` tiene una columna UInt64, que se reconoce como "Binary" de forma predeterminada.
"Transform Data" abre Power Query Editor, donde podemos reasignar el tipo de la columna y establecerlo, por ejemplo, como
Text.
Una vez hecho esto, haga clic en "Close & Apply" en la esquina superior izquierda y continúe con la carga de los datos.