Conectar-se a fontes de dados do SAP HANA usando o DirectQuery no Power BI

Artigo
07/05/2023

Você pode se conectar a fontes de dados do SAP HANA diretamente usando o DirectQuery. Há duas opções ao se conectar ao SAP HANA:

Tratar o SAP HANA como uma origem multidimensional (padrão): nesse caso, o comportamento será semelhante a quando o Power BI se conecta a outras fontes multidimensionais, como SAP Business Warehouse ou Analysis Services. Ao se conectar ao SAP HANA usando essa configuração, uma única exibição de cálculo ou análise será selecionada, e todas as medidas, hierarquias e atributos dessa exibição estarão disponíveis na lista de campos. Como os visuais são criados, os dados de agregação serão sempre recuperados do SAP HANA. Essa técnica é a abordagem recomendada e o padrão para novos relatórios DirectQuery no SAP HANA.
Tratar o SAP HANA como uma fonte de dados relacional: nesse caso, o Power BI trata o SAP HANA como uma fonte de dados relacional. Essa abordagem proporciona maior flexibilidade. É importante ter cuidado com esta abordagem para garantir que as medidas sejam agregadas conforme o esperado e para evitar problemas de desempenho.

A abordagem de conexão é determinada por uma opção de ferramenta global, que é configurada selecionando Arquivo>Opções e configurações, Opções>DirectQuery e selecionando a opção Tratar SAP HANA como uma origem relacional, conforme mostrado na imagem a seguir.

Screenshot of the Options dialog, showing the DirectQuery options.

A opção de tratar o SAP HANA como uma origem de dados relacional controla a abordagem usada para todos os novos relatórios usando DirectQuery no SAP HANA. Isso não tem efeito sobre as conexões existentes do SAP HANA no relatório atual, nem nas conexões em outros relatórios que estejam abertos. Portanto, se a opção estiver atualmente desmarcada, após a adição de uma nova conexão com o SAP HANA usando Obter Dados, essa conexão será feita considerando o SAP HANA como uma origem de dados multidimensional. No entanto, se um relatório diferente que também se conecta ao SAP HANA for aberto, esse relatório continuará se comportando de acordo com a opção definida no momento em que ele foi criado. Esse fato significa que todos os relatórios que se conectam ao SAP HANA que foram criados antes de fevereiro de 2018 continuarão a tratar o SAP HANA como uma origem de dados relacional.

As duas abordagens representam um comportamento diferente, e não é possível mudar um relatório existente de uma abordagem para a outra.

Tratar o SAP HANA como uma origem de dados multidimensional (padrão)

Todas as novas conexões com o SAP HANA usam esse método de conexão por padrão, tratando o SAP HANA como uma origem de dados multidimensional. Para tratar uma conexão com o SAP HANA como uma origem de dados relacional, você deverá selecionar Arquivo>Opções e configurações>Opções e marcar a caixa em DirectQuery>Tratar SAP HANA como uma origem de dados relacional.

Ao se conectar ao SAP HANA como uma origem multidimensional, aplicam-se as seguintes considerações:

No Navegador de Obter Dados, uma única exibição do SAP HANA pode ser selecionada. Não é possível selecionar atributos ou medidas individuais. Não há nenhuma consulta definida no momento da conexão, o que é diferente da importação de dados ou ao usar o DirectQuery e tratar o SAP HANA como uma origem de dados relacional. Essa consideração significa também que não é possível usar uma consulta SQL do SAP HANA diretamente ao selecionar este método de conexão.
Todas as medidas, hierarquias e atributos do modo de exibição selecionado são exibidas na lista de campos.
Como uma medida é usada em um visual, o SAP HANA é consultado para recuperar o valor da medida no nível de agregação necessário para o visual. Ao lidar com medidas não aditivas, como contadores e proporções, todas as agregações serão executadas pelo SAP HANA e nenhuma outra agregação adicional será executada pelo Power BI.
Para garantir que os valores de agregação corretos sempre possam ser obtidos do SAP HANA, determinadas restrições deverão ser impostas. Por exemplo, não é possível adicionar colunas calculadas ou combinar dados de várias exibições do SAP HANA dentro do mesmo relatório.

Tratar o SAP HANA como uma fonte multidimensional não oferece maior flexibilidade fornecida pela abordagem relacional alternativa, mas é mais simples. A abordagem também garantirá valores agregados corretos ao lidar com medidas mais complexas do SAP HANA e geralmente resultará em um desempenho mais alto.

A lista Campo inclui todas as medidas, atributos e hierarquias da exibição do SAP HANA. Observe os comportamentos a seguir que são aplicados ao usar esse método de conexão:

Qualquer atributo que estiver incluído em pelo menos uma hierarquia ficará oculto por padrão. No entanto, eles podem ser vistos se necessário, selecionando Exibir oculto do menu de contexto na lista de campos. No mesmo menu de contexto, eles podem ficar visíveis, se necessário.
No SAP HANA, um atributo pode ser definido para usar outro atributo como seu rótulo. Por exemplo, Produto com valores 1, 2, 3 e assim por diante, pode usar ProductName com valores Bike, Shirt, Gloves e assim por diante, como o respectivo rótulo. Nesse caso, um campo único Produto será mostrado na lista de campos, cujos valores serão os rótulos de Bike, Shirt, Gloves e assim por diante, mas que será classificado por e com a exclusividade determinada pelos valores de chave 1, 2, 3. Uma coluna oculta Product.Key também será criada, permitindo o acesso aos valores de chave subjacentes se for necessário.

Todas as variáveis definidas na exibição do SAP HANA subjacente serão mostradas no momento da conexão e os valores necessários poderão ser inseridos. Esses valores poderão ser alterados posteriormente ao selecionar Transformar dados na faixa de opções e Editar Parâmetros no menu suspenso exibido.

As operações de modelagem permitidas são mais restritivas do que em geral, ao usar o DirectQuery, devido à necessidade de garantir que os dados de agregação corretos sempre possam ser obtidos do SAP HANA. No entanto, é possível fazer várias adições e alterações, incluindo a definição de medidas, renomeação e ocultação de campos e definição de formatos de exibição. Todas essas mudanças serão preservadas na atualização e as alterações não conflitantes feitas ao modo de exibição do SAP HANA serão aplicadas.

Outras restrições de modelagem

As outras principais restrições de modelagem ao se conectar ao SAP HANA usando o DirectQuery (trate como uma fonte de dados multidimensional) são as seguintes:

Não há suporte para colunas calculadas: a capacidade de criar colunas calculadas fica desabilitada. Isso também significa que o Agrupamento e o Clustering, que criam colunas calculadas, não estão disponíveis.
Limitações adicionais para medidas: há outras limitações impostas sobre as expressões DAX que podem ser usadas em medidas para refletir o nível de suporte oferecido pelo SAP HANA.
Não há suporte para definição de relações: apenas uma única exibição pode ser consultada dentro de um relatório e, dessa forma, não há suporte para definição de relações.
Não há Modo de Exibição de Dados: o Modo de Exibição de Dados normalmente exibe dados detalhados nas tabelas. Dada a natureza das fontes de OLAP como o SAP HANA, essa exibição não está disponível com o SAP HANA.
Os detalhes das colunas e das medidas são fixos: a lista de colunas e medidas vistas na lista de campos são fixas segundo a fonte subjacente e não podem ser modificadas. Por exemplo, não é possível excluir uma coluna ou alterar seu tipo de dados. No entanto, ele pode ser renomeado.
Limitações adicionais no DAX: há outras limitações no DAX que podem ser usadas em definições de medida para refletir as limitações na fonte. Por exemplo, não é possível usar uma função de agregação em uma tabela.

Outras restrições de visualização

Há restrições nos elementos visuais ao se conectar ao SAP HANA usando o DirectQuery (trate como fonte de dados multidimensional):

Não há agregação de colunas: não é possível alterar a agregação para uma coluna em um visual, ela sempre é Não Resumir.

Tratar o SAP HANA como uma origem relacional

Ao decidir se conectar ao SAP HANA como uma origem de dados relacional, outras flexibilidades ficarão disponíveis. Por exemplo, você pode criar colunas calculadas, incluir dados de vários modos de exibição do SAP HANA e criar relações entre as tabelas resultantes. No entanto, há diferenças do comportamento ao tratar o SAP HANA como uma fonte multidimensional, especialmente quando a exibição do SAP HANA contém medidas não aditivas, por exemplo, contagens distintas ou médias em vez de somas simples, e relacionadas à eficiência das consultas executadas no SAP HANA.

É útil começar esclarecendo o comportamento de uma fonte relacional, como o SQL Server, quando a consulta definida em Obter Dados ou no Editor do Power Query executar uma agregação. No exemplo a seguir, uma consulta definida no Editor do Power Query retorna o preço médio segundo o ProductID.

Diagram showing a query defined in Power Query Editor that returns the average price by Product ID.

Se os dados estiverem sendo importados para o Power BI em vez de usar o DirectQuery, a seguinte situação aconteceria:

Os dados são importados no nível de agregação definido pela consulta criada no Editor do Power Query. Por exemplo, preço médio por produto. Esse fato resulta em uma tabela com duas colunas, ProductID e AveragePrice, que podem ser usadas em visuais.
Em um visual, qualquer agregação subsequente, como Sum, Average, Min, entre outras, é executada nos dados importados. Por exemplo, incluir AveragePrice em um visual usará a agregação Sum por padrão e retornará a soma de AveragePrice para cada ProductID. Neste exemplo, 13,67. O mesmo se aplica a qualquer função de agregação alternativa, como Min ou Average, usada no visual. Por exemplo, Average de AveragePrice retorna a média de 6,66, 4 e 3, que é igual a 4,56 e não a média de Price nos seis registros da tabela subjacente, que é de 5,17.

Se o DirectQuery nessa mesma fonte relacional estiver sendo usado em vez da Importação, a mesma semântica se aplicará e os resultados serão exatamente os mesmos:

Considerando a mesma consulta, logicamente os mesmos dados serão apresentados para a camada de relatório, embora os dados não tenham sido de fato importados.
Em um visual, qualquer agregação subsequente, como Sum, Average e Min, é executada mais uma vez na tabela lógica da consulta. E mais uma vez, um visual contendo Average de AveragePrice retornará o mesmo valor de 4,56.

Considere o SAP HANA quando a conexão é tratada como uma fonte relacional. O Power BI pode trabalhar com Exibições Analíticas e Exibições de Cálculo no SAP HANA, que podem conter medidas. Ainda hoje a abordagem do SAP HANA segue os mesmos princípios descritos anteriormente nesta seção: a consulta definida em Obter Dados ou no Editor do Power Query determinará os dados disponíveis, e qualquer agregação subsequente em um visual será feita nos dados. O mesmo se aplica à Importação e ao DirectQuery. No entanto, devido à natureza do SAP HANA, a consulta definida na caixa de diálogo inicial Obter Dados ou Editor do Power Query sempre será uma consulta de agregação e geralmente incluirá medidas em que a agregação real que será usada será definida pela exibição do SAP HANA.

O equivalente do exemplo anterior do SQL Server é que há uma exibição do SAP HANA contendo ID, ProductID, DepotID e medidas incluindo AveragePrice, definidas no modo de exibição como Média do Preço.

Se, na experiência Obter Dados, tiverem sido feitas seleções de ProductID e da medida AveragePrice, isso define uma consulta no modo de exibição, solicitando esses dados agregados. No exemplo anterior, o pseudo-SQL será usado para simplificar, o que não corresponde à sintaxe exata do SQL do SAP HANA. Em seguida, agregações adicionais definidas em um visual agregam ainda mais os resultados de tal consulta. Novamente, conforme descrito anteriormente para o SQL Server, esse resultado se aplica à Importação e ao DirectQuery. No caso do DirectQuery, a consulta de Obter Dados ou do Editor do Power Query é usada em uma subseleção, dentro de uma única consulta enviada ao SAP HANA. Portanto, não se trata de um caso em que todos os dados seriam lidos antes de serem ainda mais agregados.

Todas essas considerações e comportamentos exigem as seguintes considerações importantes ao usar o DirectQuery no SAP HANA:

É necessário prestar atenção a qualquer agregação adicional executada nos visuais, sempre que a medida no SAP HANA for não aditiva, por exemplo, não for um simples Sum, Min ou Max.
Em Obter Dados ou no Editor do Power Query, somente as colunas obrigatórias devem ser incluídas para recuperar os dados necessários, refletindo o fato de que o resultado é uma consulta, que deverá ser razoável que possa ser enviada ao SAP HANA. Por exemplo, se dezenas de colunas tiverem sido selecionadas, com a ideia de que elas poderão ser necessárias em visuais posteriores, então até mesmo para o DirectQuery um visual simples significará que a consulta de agregação usada na subseleção incluirá essas dezenas de colunas, o que geralmente levará a um desempenho ruim.

No exemplo a seguir, selecionar cinco colunas (CalendarQuarter, Color, LastName, ProductLine, SalesOrderNumber) na caixa de diálogo Obter Dados, junto com a medida OrderQuantity, significa que, mais tarde, a criação de um visual simples contendo Min OrderQuantity resultará na seguinte consulta SQL ao SAP HANA. O sombreado é a subseleção, contendo a consulta de Obter Dados/Editor do Power Query. Se essa subseleção levar a um resultado com cardinalidade alta, é provável que o desempenho resultante do SAP HANA seja ruim.

Screenshot of a query example, showing the SQL query to SAP HANA.

Por causa deste comportamento, recomendamos que os itens selecionados em Obter Dados ou no Editor do Power Query sejam limitados aos itens que são necessários, ainda assim resultando em uma consulta razoável ao SAP HANA.

Práticas recomendadas

Para ambas as abordagens para se conectar ao SAP HANA, as recomendações para usar o DirectQuery também se aplicam ao SAP HANA, especialmente aquelas relacionadas à garantia do bom desempenho. Para mais informações, confira Usar o DirectQuery no Power BI.

Considerações e limitações

A lista a seguir descreve todos os recursos do SAP HANA que não têm suporte completo ou recursos que têm comportamento diferente ao usar o Power BI.

Hierarquias de pai/filho: hierarquias pai/filho não estão visíveis no Power BI. Isso ocorre porque o Power BI acessa o SAP HANA usando a interface do SQL e as hierarquias de pai/filho não podem ser totalmente acessadas usando o SQL.
Outros metadados de hierarquia: a estrutura básica das hierarquias é exibida no Power BI. No entanto, alguns metadados de hierarquia (como controlar o comportamento de hierarquias desbalanceadas) não terão efeito. Novamente, isso é devido a limitações impostas pela interface do SQL.
Conexão com SSL: você pode se conectar usando o recurso Importar e multidimensional com TLS, mas não é possível se conectar às instâncias do SAP HANA configuradas para usar o TLS para o conector relacional.
Suporte a modos de exibição de Atributo: o Power BI pode se conectar aos modos de exibição Analítico e de Cálculo, mas não pode se conectar diretamente aos modos de exibição de Atributo.
Suporte para objetos de catálogo: o Power BI não pode se conectar aos objetos de catálogo.
Alterar para Variáveis após publicar: você não pode alterar os valores das variáveis do SAP HANA diretamente no serviço do Power BI, após o relatório ser publicado.

Problemas conhecidos

A lista a seguir descreve todos os problemas conhecidos ao se conectar ao SAP HANA (DirectQuery) usando o Power BI.

Problema do SAP HANA ao consultar Contadores e outras medidas: dados incorretos são retornados do SAP HANA se estiver conectando a uma Exibição Analítica e uma medida de Contador, bem como algumas outras medidas de proporção, estiverem incluídas no mesmo visual. Isso é abordado pela observação 2128928 do SAP (resultados inesperados ao consultar uma coluna calculada e um contador). Nesse caso, a medida de proporção estará incorreta.
Várias colunas do Power BI de coluna única do SAP HANA: para algumas exibições de cálculo em que uma coluna do SAP HANA é usada em mais de uma hierarquia, o SAP HANA expõe a coluna como dois atributos separados. Essa abordagem resulta em duas colunas que estão sendo criadas no Power BI. No entanto, essas colunas estão ocultos por padrão e todas as consultas que envolvem hierarquias ou as colunas diretamente comportam-se corretamente.

Para obter mais informações sobre o DirectQuery, confira os seguintes recursos: