> ## 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 é um software interativo de visualização de dados desenvolvido pela Microsoft, com foco principal em inteligência de negócios.
# Power BI
export const ClickHouseSupportedBadge = () => {
return
Suportado pelo ClickHouse
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
O Microsoft Power BI pode consultar ou carregar dados na memória do [ClickHouse Cloud](https://clickhouse.com/cloud) ou de uma implantação autogerenciada.
Há várias opções do Power BI que você pode usar para visualizar seus dados:
* Power BI Desktop: um aplicativo de desktop para Windows para criar dashboards e visualizações
* Power BI Service: disponível no Azure como SaaS para hospedar os dashboards criados no Power BI Desktop
O Power BI exige que você crie seus dashboards na versão Desktop e os publique no Power BI Service.
Este tutorial orientará você no processo de:
* [Instalar o ClickHouse ODBC Driver](#install-the-odbc-driver)
* [Instalar o ClickHouse Power BI Connector no Power BI Desktop](#power-bi-installation)
* [Consultar dados do ClickHouse para visualização no Power BI Desktop](#query-and-visualise-data)
* [Configurar um gateway de dados local para o Power BI Service](#power-bi-service)
## Pré-requisitos
### Instalação do Power BI
Este tutorial pressupõe que você tenha o Microsoft Power BI Desktop instalado no seu computador com Windows. Você pode baixar e instalar o Power BI Desktop [aqui](https://www.microsoft.com/en-us/download/details.aspx?id=58494)
Recomendamos atualizar para a versão mais recente do Power BI. O ClickHouse Connector está disponível por padrão a partir da versão `2.137.751.0`.
### Reúna os detalhes de conexão do ClickHouse
Você precisará dos seguintes detalhes para se conectar à sua instância do ClickHouse:
* Hostname - ClickHouse
* Nome de usuário - Nome de usuário das credenciais do usuário
* Senha - Senha do usuário
* Banco de dados - Nome do banco de dados na instância à qual você deseja se conectar
## Power BI Desktop
Para começar a consultar dados no Power BI Desktop, você precisará seguir as etapas abaixo:
1. Instale o ODBC Driver do ClickHouse
2. Localize o ClickHouse Connector
3. Conecte-se ao ClickHouse
4. Consulte e visualize seus dados
### Instale o driver ODBC
Baixe a [versão mais recente do ClickHouse ODBC](https://github.com/ClickHouse/clickhouse-odbc/releases).
Execute o instalador `.msi` fornecido e siga o assistente.
`Debug symbols` são opcionais e não são necessários
#### Verifique o driver ODBC
Quando a instalação do driver for concluída, você poderá confirmar se ela foi bem-sucedida:
Pesquise por ODBC no menu Iniciar e selecione "ODBC Data Sources **(64-bit)**".
Verifique se o ClickHouse Driver aparece na lista.
### Encontre o ClickHouse Connector
Disponível na versão `2.137.751.0` do Power BI Desktop
Na tela inicial do Power BI Desktop, clique em "Obter Dados".
Pesquise por "ClickHouse"
### Conectar ao ClickHouse
Selecione o conector e insira as credenciais da instância do ClickHouse:
* Host (obrigatório) - O domínio/endereço da sua instância. Certifique-se de adicioná-lo sem prefixos nem sufixos.
* Porta (obrigatório) - A porta da sua instância.
* Banco de dados - O nome do seu banco de dados.
* Opções - Qualquer opção de ODBC, conforme listado
na [página do GitHub do ODBC do ClickHouse](https://github.com/ClickHouse/clickhouse-odbc#configuration)
* Modo de conectividade de dados - DirectQuery
Recomendamos selecionar DirectQuery para consultar o ClickHouse diretamente.
Se o seu caso de uso envolver um pequeno volume de dados, você pode escolher o modo de importação, e todos os dados serão carregados no Power BI.
* Especifique o nome de usuário e a senha
### Consultar e visualizar dados
Por fim, você deverá ver os bancos de dados e as tabelas na Navigator view. Selecione a tabela desejada e clique em "Carregar" para
importar os dados do ClickHouse.
Quando a importação for concluída, os dados do ClickHouse deverão estar acessíveis no Power BI normalmente.
## Power BI Service
Para usar o Microsoft Power BI Service, você precisa criar um [gateway de dados local](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-onprem).
Para obter mais detalhes sobre como configurar conectores personalizados, consulte a documentação da Microsoft sobre como [usar conectores de dados personalizados com um gateway de dados local](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-custom-connectors).
## Driver ODBC (somente importação)
Recomendamos usar o ClickHouse Connector com DirectQuery.
Instale o [driver ODBC](#install-the-odbc-driver) na instância do gateway de dados local e [verifique](#verify-odbc-driver) conforme descrito acima.
### Criar um novo DSN de usuário
Quando a instalação do driver for concluída, será possível criar uma fonte de dados ODBC. Procure por ODBC no menu Iniciar e selecione "ODBC Data Sources (64-bit)".
Aqui, adicione um novo DSN de usuário. Clique no botão "Add", à esquerda.
Escolha a versão Unicode do driver ODBC.
Preencha os detalhes da conexão.
Se você estiver usando uma implantação com SSL habilitado (por exemplo, ClickHouse Cloud ou uma instância autogerenciada), no campo `SSLMode`, informe `require`.
* `Host` deve sempre ser informado sem o protocolo (ou seja, omita `http://` ou `https://`).
* `Timeout` é um número inteiro que representa segundos. Valor padrão: `30 seconds`.
### Obtenha dados no Power BI
Caso você ainda não tenha o Power BI instalado
, [baixe e instale o Power BI Desktop](https://www.microsoft.com/en-us/download/details.aspx?id=58494).
Na tela inicial do Power BI Desktop, clique em "Obter Dados".
Selecione "Outro" -> "ODBC".
Selecione na lista a fonte de dados criada anteriormente.
Se você não especificou credenciais durante a criação da fonte de dados, será solicitado que informe o nome de usuário e a senha.
Por fim, você deverá ver os bancos de dados e as tabelas na Navigator view. Selecione a tabela desejada e clique em "Carregar" para importar os dados do ClickHouse.
Quando a importação for concluída, os dados do ClickHouse estarão acessíveis no Power BI, como de costume.
## Otimizando o trabalho com grandes conjuntos de dados
O Power BI foi projetado para bancos de dados tradicionais baseados em linhas, com volumes moderados de dados. Ao trabalhar com o ClickHouse em escala (bilhões de linhas), são necessários padrões arquiteturais específicos para garantir o melhor desempenho.
O Power BI gera automaticamente consultas SQL com subconsultas aninhadas, junções complexas e transformações em tempo real. Esses padrões funcionam bem em bancos de dados SQL tradicionais, mas podem ser ineficientes ao consultar bancos de dados colunares em grande escala, como o ClickHouse.
**Abordagem recomendada para grandes conjuntos de dados:** em vez de consultar tabelas brutas diretamente, crie `visões materializadas` dedicadas no ClickHouse para cada visualização do dashboard. Isso oferece:
* Desempenho rápido e consistente, independentemente do volume de dados
* Menor carga no seu cluster ClickHouse
* Custos mais previsíveis
Se seus dashboards estiverem lentos, verifique o [`query_log`](/docs/pt-BR/reference/system-tables/query_log) do ClickHouse para ver quais consultas SQL o Power BI está realmente executando. Problemas comuns incluem subconsultas aninhadas, varredura de tabelas inteiras ou junções ineficientes. Depois de identificar o problema, crie [visões materializadas](/docs/pt-BR/concepts/features/materialized-views/index) para resolver esses problemas específicos.
### Melhores práticas de implementação
#### Estratégia de pré-agregação
Crie visões materializadas em vários níveis de agregação:
* Agregações horárias para dashboards recentes e detalhados
* Agregações diárias para tendências históricas
* Rollups mensais para relatórios de longo prazo
* Mantenha os dados brutos com TTL adequado para análises ad hoc
#### Otimização da modelagem de dados
* Defina chaves `ORDER BY` que correspondam aos seus padrões de consulta
* Use particionamento para dados de séries temporais
* Converta tabelas de dimensão pequenas em dicionários para buscas mais eficientes
* Use projeções para otimizar ainda mais as consultas
## Limitações conhecidas
### UInt64
Tipos de inteiro sem sinal, como UInt64 ou superiores, não serão carregados automaticamente no conjunto de dados, pois Int64 é o maior tipo de número inteiro com suporte no Power BI.
Para importar os dados corretamente, antes de clicar no botão "Load" no Navigator, clique primeiro em "Transform Data".
Neste exemplo, a tabela `pageviews` tem uma coluna UInt64, que é reconhecida como "Binary" por padrão.
"Transform Data" abre o Power Query Editor, onde podemos redefinir o tipo da coluna, configurando-o, por exemplo, como
Text.
Ao terminar, clique em "Close & Apply" no canto superior esquerdo e prossiga com o carregamento dos dados.