Usar o Conector SAP BW no Power BI DesktopUse the SAP BW Connector in Power BI Desktop

Com o Power BI Desktop, você pode acessar os dados do SAP BW (Business Warehouse).With Power BI Desktop, you can access SAP Business Warehouse (BW) data.

Para saber mais sobre como os clientes da SAP podem se beneficiar conectando o Power BI aos sistemas SAP BW (Business Warehouse) existentes deles, veja o white paper Power BI e SAP BW.For information about how SAP customers can benefit from connecting Power BI to their existing SAP Business Warehouse (BW) systems, see the Power BI and SAP BW whitepaper. Para obter detalhes de como usar o DirectQuery com o SAP BW, confira o artigo DirectQuery e SAP BW (Business Warehouse).For details about using DirectQuery with SAP BW, see the article DirectQuery and SAP Business Warehouse (BW).

Começando com a versão de junho de 2018 do Power BI Desktop, você pode usar o conector do SAP BW com uma implementação com melhorias significativas para o desempenho e as funcionalidades.Starting with the June 2018 release of Power BI Desktop, you can use the SAP BW connector with an implementation that has significant improvements in performance and capabilities. Essa versão atualizada do conector do SAP BW foi desenvolvida pela Microsoft e chama-se Implementação 2.0.This updated version of the SAP BW connector was developed by Microsoft and is called Implementation 2.0. Você pode selecionar a versão 1 (v1) do Conector do SAP BW ou o Conector do SAP da Implementação 2.0.You can select either version 1 (v1) of the SAP BW Connector, or the Implementation 2.0 SAP Connector. As seções a seguir descrevem a instalação de cada versão, uma de cada vez.The following sections describe the installation of each version, in turn. Você pode escolher um dos dois conectores para conectar-se ao SAP BW do Power BI Desktop.You can choose one or the other connector when connecting to SAP BW from Power BI Desktop.

Sugerimos que você use o Conector do SAP da Implementação 2.0 sempre que possível.We suggest you use the Implementation 2.0 SAP Connector whenever possible.

Instalação da versão 1 do Conector do SAP BWInstallation of version 1 of the SAP BW Connector

É recomendável usar o Conector do SAP da Implementação 2.0 sempre que possível (veja as instruções na seção a seguir).We recommend using the Implementation 2.0 SAP Connector whenever possible (see instructions in the following section). Esta seção descreve a instalação da versão 1 do Conector do SAP BW, que pode ser instalado executando as seguintes etapas de instalação:This section describes installation of version 1 of the SAP BW Connector, which you can install by taking the following installation steps:

  1. Instale a biblioteca do SAP NetWeaver em seu computador local.Install the SAP NetWeaver library on your local machine. É possível obter a biblioteca do SAP Netweaver do administrador do SAP ou diretamente do Centro de Download de Software SAP.You can get the SAP Netweaver library from your SAP administrator, or directly from the SAP Software Download Center. Como o Centro de Download de Software SAP altera sua estrutura com frequência, não estão disponíveis diretrizes mais específicas para navegar nesse site.Since the SAP Software Download Center changes its structure frequently, more specific guidance for navigating that site is not available. A biblioteca do SAP NetWeaver geralmente é incluída também na instalação do SAP Client Tools.The SAP NetWeaver library is usually included also in the SAP Client Tools installation.

    Talvez seja possível pesquisar SAP Note #1025361 para obter o local de download da versão mais recente.You may be able to search for SAP Note #1025361 to get the download location for the most recent version. Verifique se a arquitetura da biblioteca SAP NetWeaver (32 bits ou 64 bits) corresponde a sua instalação do Power BI Desktop e instale todos os arquivos incluídos no SDK do SAP NetWeaver RFC de acordo com a Observação SAP.Make sure the architecture for the SAP NetWeaver library (32-bit or 64-bit) matches your Power BI Desktop installation, then install all files included in the SAP NetWeaver RFC SDK according to the SAP Note.

  2. A caixa de diálogo Obter Dados inclui uma entrada para o Servidor de Aplicativos SAP Business Warehouse e o Servidor de Mensagens SAP Business Warehouse na categoria Banco de dados.The Get Data dialog includes an entry for SAP Business Warehouse Application Server and SAP Business Warehouse Message Server in the Database category.

    Opções de Obter Dados para o SAP

Instalação do Conector do SAP da Implementação 2.0Installation of Implementation 2.0 SAP Connector

A Implementação 2.0 do Conector do SAP exige o SAP .NET Connector 3.0.Implementation 2.0 of the SAP Connector requires the SAP .NET Connector 3.0. Você pode baixar o SAP .NET Connector 3.0 no site da SAP usando o seguinte link:You can download the SAP .NET Connector 3.0 from SAP’s website using the following link:

O acesso ao download requer um usuário S válido.Access to the download requires a valid S-user. É recomendado que os clientes contatem a equipe de base do SAP para obter o SAP .NET Connector 3.0.Customers are encouraged to contact their SAP Basis team to get the SAP .NET Connector 3.0.

O conector é fornecido nas versões de 32 bits e 64 bits e os usuários precisam escolher a versão que corresponde às suas instalações do Power BI Desktop.The connector comes in 32-bit and 64-bit versions, and users must choose the version that matches their Power BI Desktop installation. No momento da escrita deste artigo, o site lista duas versões (para .NET 4.0 Framework):At the time of this writing, the website lists two versions (for .NET 4.0 framework):

  • SAP Connector for Microsoft .NET 3.0.20.0 para Windows de 32 bits (x86) como um arquivo zip (6,896 KB), 16 de janeiro de 2018SAP Connector for Microsoft .NET 3.0.20.0 for Windows 32-bit (x86) as zip file (6.896 KB), January 16, 2018
  • SAP Connector for Microsoft .NET 3.0.20.0 para Windows de 64 bits (x64) como um arquivo zip (7,180 KB), 16 de janeiro de 2018SAP Connector for Microsoft .NET 3.0.20.0 for Windows 64-bit (x64) as zip file (7.180 KB), January 16, 2018

Durante a instalação, na janela Etapas de configuração opcionais, selecione a opção Instalar assemblies no cache de assembly global, conforme é mostrado na imagem a seguir.When installing, in the Optional setup steps window, make sure you select the Install assemblies to GAC option as shown in the following image.

Etapas de configuração opcionais do SAP

Observação

A primeira versão da implementação do SAP BW exige DLLs do Netweaver. Se você estiver usando a Implementação 2.0 do Conector do SAP e não a primeira versão, as DLLs do Netweaver não serão necessárias.The first version of SAP BW implementation required Netweaver DLLs; if you're using Implementation 2.0 of the SAP Connector, and not using the first version, the Netweaver DLLs are not required.

Recursos da versão 1 do Conector do SAP BWVersion 1 SAP BW Connector features

A versão 1 do Conector do SAP BW no Power BI Desktop permite que você importe dados dos cubos do Servidor SAP Business Warehouse ou use o DirectQuery.The version 1 SAP BW Connector in Power BI Desktop let you import data from your SAP Business Warehouse Server cubes, or use DirectQuery.

Para saber mais sobre o conector do SAP BW e como usá-lo com DirectQuery, veja o artigo DirectQuery e SAP BW (Business Warehouse).To learn more about the SAP BW connector and how to use it with DirectQuery, take a look at the DirectQuery and SAP Business Warehouse (BW) article.

Para estabelecer a conexão, você deve especificar um Servidor, um Número do Sistema e uma ID do Cliente.When connecting, you must specify a Server, System Number, and Client ID to establish the connection.

Configurações de conexão do servidor SAP

Você também pode especificar duas Opções avançadas adicionais: Código de idioma e uma instrução MDX personalizada a ser executada em relação ao servidor especificado.You can also specify two additional Advanced options: Language code, and a custom MDX statement to run against the specified server.

informações de conexão adicionais

Se nenhuma instrução MDX foi especificada, você vê a janela do Navegador, que exibe a lista de cubos disponíveis no servidor com a opção de fazer uma busca detalhada de itens dos cubos disponíveis, incluindo dimensões e medidas.If no MDX statement was specified you are presented with the Navigator window, which displays the list of cubes available in the server, with the option to drill down and select items from the available cubes, including dimensions and measures. O Power BI expõe consultas e cubos expostos pelos BAPIs OLAP da Interface de Análise Aberta do BW.Power BI exposes queries and cubes exposed by the BW Open Analysis Interface OLAP BAPIs.

Ao selecionar um ou mais itens do servidor, uma visualização da tabela de saída é criada, com base em sua seleção.When you select one or more items from the server, a preview of the output table is created, based on their selection.

Visualização de tabela do SAP

A janela do Navegador também fornece algumas Opções de Exibição que permitem fazer o seguinte:The Navigator window also provides a few Display Options that allow you to do the following:

  • Exibir Somente Itens Selecionados versus Todos os Itens (exibição padrão): essa opção é útil para verificar o conjunto final de itens selecionados.Display Only Selected Items versus All Items (default view): This option is useful for verifying the final set of items selected. Uma abordagem alternativa para exibir isso é selecionar os Nomes de Coluna na área Visualização.An alternative approach to viewing this is to select the Column Names in the Preview area.
  • Habilitar Visualizações de Dados (comportamento padrão): também é possível controlar se as visualizações de dados devem ser exibidas neste diálogo.Enable Data Previews (default behavior): You can also control whether data previews should be displayed in this dialog. A desabilitação das visualizações de dados reduz a quantidade de chamadas do servidor, pois ele não solicita dados para as visualizações.Disabling data previews reduces the amount of server calls, since it no longer requests data for the previews.
  • Nomes técnicos: o SAP BW dá suporte ao conceito de nomes técnicos para objetos em um cubo.Technical Names: SAP BW supports the notion of technical names for objects within a cube. Os nomes técnicos permitem que um proprietário de cubo exponha nomes amigáveis para objetos do cubo, em vez de apenas expor os nomes físicos desses objetos no cubo.Technical names allow a cube owner to expose user friendly names for cube objects, as opposed to only exposing the physical names for those objects in the cube.

a janela Navegador

Depois de selecionar todos os objetos necessários no Navegador, é possível decidir o que fazer em seguida selecionando um dos seguintes botões na parte inferior da janela do Navegador:After selecting all necessary objects in the Navigator, you can decide what to do next, by selecting one of the following buttons on the bottom of the Navigator window:

  • A seleção de Carga dispara o carregamento de todo o conjunto de linhas para a tabela de saída no modelo de dados do Power BI Desktop e, em seguida, o leva para a visualização Relatório, em que é possível começar a visualizar dados ou fazer modificações adicionais usando as exibições de Dados ou Relações.Selecting Load triggers loading the entire set of rows for the output table into the Power BI Desktop data model, then takes you to Report view where you can begin visualizing the data or making further modifications using the Data or Relationships views.
  • A seleção de Editar mostra o Editor de Consultas, em que é possível executar a transformação de dados adicional e as etapas de filtragem antes que todo o conjunto de linhas seja colocado no modelo de dados do Power BI Desktop.Selecting Edit brings up Query Editor, where you can perform additional data transformation and filtering steps before the entire set of rows is brought into the Power BI Desktop data model.

Além de importar dados de cubos do SAP BW, lembre-se de que também é possível importar dados de uma ampla variedade de fontes de dados no Power BI Desktop e combiná-los em um único relatório.In addition to importing data from SAP BW cubes, remember that you can also import data from a wide range of other data sources in Power BI Desktop, and then you can combine them into a single report. Isso apresenta todos os tipos de cenários interessantes para relatórios e análises dos dados do SAP BW.This presents all sorts of interesting scenarios for reporting and analytics on top of SAP BW data.

Usando o Conector do SAP BW da Implementação 2.0Using Implementation 2.0 SAP BW Connector

Você precisa criar uma nova conexão para usar a Implementação 2.0 do Conector do SAP BW.You must create a new connection to use Implementation 2.0 of the SAP BW Connector. Para criar uma nova conexão, execute as etapas a seguir.To create a new connection, take the following steps.

  1. Na janela Obter dados, selecione o Servidor de Aplicativos do SAP Business Warehouse ou o Servidor de Mensagem do SAP Business Warehouse.From the Get Data window, select either SAP Business Warehouse Application Server or SAP Business Warehouse Message Server.

  2. Será exibida uma caixa de diálogo da nova conexão permitindo a seleção da implementação.You're presented with the new connection dialog, which allows selection of the implementation. A seleção da Implementação 2.0, conforme é mostrado na imagem a seguir, permite as opções Modo de execução, Tamanho do lote e Habilitar estruturas características.Selecting Implementation 2.0, as shown in the following image, enables the Execution mode, Batch size and Enable characteristic structures options.

    Caixa de diálogo de conexão do SAP

  3. Selecione OK e, em seguida, a experiência com o Navegador será a mesma que a descrita na seção anterior para a versão 1 do Conector do SAP BW.Select OK, and subsequently, the Navigator experience is the same as described in the earlier section for the version 1 SAP BW Connector.

Novas opções da Implementação 2.0New options for Implementation 2.0

A Implementação 2.0 é compatível as seguintes opções:Implementation 2.0 supports the following options:

  1. ExecutionMode – especifica a interface MDX usada para executar consultas no servidor.ExecutionMode - Specifies the MDX interface used to execute queries on the server. As opções válidas são as seguintes:Valid options are the following:

     a. SapBusinessWarehouseExecutionMode.BasXml
     b. SapBusinessWarehouseExecutionMode.BasXmlGzip
     c. SapBusinessWarehouseExecutionMode.DataStream
    

    O valor padrão dessa opção é SapBusinessWarehouseExecutionMode.BasXmlGzip.The default value for this option is SapBusinessWarehouseExecutionMode.BasXmlGzip.

    O uso de SapBusinessWarehouseExecutionMode.BasXmlGzip pode melhorar o desempenho em momentos de alta latência para grandes conjuntos de dados.Using SapBusinessWarehouseExecutionMode.BasXmlGzip may improve performance when experiencing high latency for large datasets.

  2. BatchSize – especifica o número máximo de linhas que serão recuperadas de cada vez ao executar uma instrução MDX.BatchSize - Specifies the maximum number of rows that will be retrieved at a time when executing an MDX statement. Um número pequeno de linhas causará mais chamadas para o servidor ao recuperar um conjunto de dados grande.A small number of rows will translate into more calls to the server while retrieving a large dataset. Um número grande de linhas pode melhorar o desempenho, mas pode causar problemas de memória no servidor do SAP BW.A large number of rows may improve performance, but could cause memory issues on the SAP BW server. O valor padrão é 50000 linhas.The default value is 50000 rows.

  3. EnableStructures – um valor lógico que indica se a estruturas características são reconhecidas.EnableStructures - A logical value indicating whether characteristic structures are recognized. O valor padrão dessa opção é false.The default value for this option is false. Afeta a lista de objetos disponíveis para seleção.Affects the list of objects available for selection. Não é compatível com o modo de consulta nativa.Not supported in Native query mode.

A opção ScaleMeasures foi preterida nesta implementação.The ScaleMeasures option has been deprecated in this implementation. O comportamento agora é igual ao da configuração ScaleMeasures = false, que sempre mostra valores fora de escala.The behavior is now the same as setting ScaleMeasures = false, that is always showing unscaled values.

Melhorias adicionais para a Implementação 2.0Additional improvements for Implementation 2.0

A lista com marcadores a seguir descreve algumas das melhorias adicionais fornecidas com a nova implementação:The following bulleted list describes some of the additional improvements that come with the new implementation:

  • Melhoria do desempenhoImproved performance
  • Capacidade de recuperar milhões de linhas de dados e fazer um ajuste fino por meio do parâmetro de tamanho do lote.Ability to retrieve several million rows of data, and fine tuning through the batch size parameter.
  • Capacidade de alternar os modos de execução.Ability to switch execution modes.
  • Suporte para o modo compactado.Support for compressed mode. Principalmente útil para conexões de alta latência ou grandes conjuntos de dados.Especially beneficial for high latency connections or large datasets.
  • Melhoria na detecção de variáveis de dataImproved detection of Date variables
  • [Experimental] As dimensões Expor Data (tipo ABAP DATS) e Tempo (tipo ABAP TIMS), como datas e horas, respectivamente, em vez de valores de texto.[Experimental] Expose Date (ABAP type DATS) and Time (ABAP type TIMS) dimensions as dates and times respectively, instead of text values.
  • Melhoria no tratamento de exceção.Better exception handling. Os erros que ocorrem em chamadas BAPI agora são apresentados.Errors that occur in BAPI calls are now surfaced.
  • Particionamento de coluna nos modos BasXml e BasXmlGzip.Column folding in BasXml and BasXmlGzip modes. Por exemplo, se a consulta MDX gerada recuperar 40 colunas, mas a seleção atual precisar apenas de 10, essa solicitação será passada para o servidor para recuperar um conjunto de dados menor.For example, if the generated MDX query retrieves 40 columns but the current selection only needs 10, this request will be passed onto the server to retrieve a smaller dataset.

Alterar os relatórios existentes para usar a Implementação 2.0Changing existing reports to use Implementation 2.0

A alteração dos relatórios existentes para usar a Implementação 2.0 é possível somente no modo de importação e exige as seguintes etapas manuais.Changing existing reports to use Implementation 2.0 is only possible in Import mode, and requires the following manual steps.

  1. Abra um relatório existente, selecione Editar Consultas na faixa de opções e, em seguida, selecione a consulta do SAP Business Warehouse que deseja atualizar.Open an existing report, select Edit Queries in the ribbon, and then select the SAP Business Warehouse query you would like to update.

  2. Clique com o botão direito do mouse na consulta e selecione Editor Avançado.Right-click the query and select Advanced Editor.

  3. No Editor Avançado altere a chamada SapBusinessWarehouse.Cubes da seguinte maneira:In the Advanced Editor change the SapBusinessWarehouse.Cubes call as follows:

    a.a. Determine se a consulta já contém um registro de opção, como o que é mostrado no exemplo a seguir:Determine whether the query already contains an option record, such as what's shown in the following example:

    trecho de consulta

    b.b. Se sim, adicione a opção Implementação 2.0 e remova a opção ScaleMeasures, se presente, conforme é mostrado:If so, add the Implementation 2.0 option, and remove the ScaleMeasures option, if present, as shown:

    trecho de consulta

    c.c. Se a consulta ainda não incluir um registro de opções, adicione-o.If the query does not already include an options record, just add it. Por exemplo, se ela tiver o seguinte:For example, if it has the following:

    trecho de consulta

    d.d. Altere-o para:Just change it to:

    trecho de consulta

  4. Foram aplicados todos os esforços necessários para tornar a Implementação 2.0 do Conector do SAP BW compatível com a versão 1 do Conector do SAP BW.Every effort has been made to make Implementation 2.0 of the SAP BW Connector compatible with version 1 of the SAP BW Connector. No entanto, poderá haver algumas diferenças devido aos diferentes modos de execução de MDX do SAP BW que estejam sendo usados.However, there may be some differences due to the different SAP BW MDX execution modes being used. Para resolver conflitos, tente alternar entre os modos de execução.To resolve any discrepancies, try switching between execution modes.

Solução de problemasTroubleshooting

Esta seção fornece situações de solução de problemas (e soluções) para trabalhar com o conector do SAP BW.This section provides troubleshooting situations (and solutions) for working with th SAP BW connector.

  1. Dados numéricos do SAP BW retorna pontos decimais em vez de vírgulas.Numeric data from SAP BW returns decimal points instead of commas. Por exemplo, 1,000,000 é retornado como 1.000.000.For example, 1,000,000 is returned as 1.000.000.

    O SAP BW retorna dados decimais com uma , (vírgula) ou um .SAP BW returns decimal data with either a , (comma) or a . (ponto) como separador decimal.(dot) as the decimal separator. Para especificar quais desses SAP BW você deve usar como separador decimal, o driver usado pelo Power BI Desktop faz uma chamada para BAPI_USER_GET_DETAIL.To specify which of those SAP BW should use for the decimal separator, the driver used by Power BI Desktop makes a call to BAPI_USER_GET_DETAIL. Essa chamada retorna uma estrutura chamada PADRÕES, que tem um campo chamado DCPFM que armazena Notação de Formato Decimal.This call returns a structure called DEFAULTS, which has a field called DCPFM that stores Decimal Format Notation. Um dos três valores a seguir é usado:It takes one of the following three values:

    ‘ ‘ (space) = Decimal point is comma: N.NNN,NN
    'X' = Decimal point is period: N,NNN.NN
    'Y' = Decimal point is N NNN NNN,NN
    

    Clientes que relataram esse problema descobriram que a chamada para BAPI_USER_GET_DETAIL falha para um usuário específico (o usuário que está mostrando dados incorretos), com uma mensagem de erro semelhante à seguinte:Customers who have reported this issue found that the call to BAPI_USER_GET_DETAIL is failing for a particular user (the user who is showing the incorrect data), with an error message similar to the following:

    You are not authorized to display users in group TI:
        <item>
            <TYPE>E</TYPE>
            <ID>01</ID>
            <NUMBER>512</NUMBER>
            <MESSAGE>You are not authorized to display users in group TI</MESSAGE>
            <LOG_NO/>
            <LOG_MSG_NO>000000</LOG_MSG_NO>
            <MESSAGE_V1>TI</MESSAGE_V1>
            <MESSAGE_V2/>
            <MESSAGE_V3/>
            <MESSAGE_V4/>
            <PARAMETER/>
            <ROW>0</ROW>
            <FIELD>BNAME</FIELD>
            <SYSTEM>CLNTPW1400</SYSTEM>
        </item>
    

    Para resolver esse erro, os usuários devem solicitar ao administrador do SAP para conceder ao usuário SAPBW que está sendo usado no Power BI o direito de executar BAPI_USER_GET_DETAIL.To solve this error, users must ask their SAP admin to grant the SAPBW user being used in Power BI the right to execute BAPI_USER_GET_DETAIL. Também vale a pena verificar se o usuário tem o valor DCPFM necessário, conforme descrito anteriormente nesta solução de problemas.It’s also worth verifying that the user has the required DCPFM value, as described earlier in this troubleshooting solution.

  2. Conectividade para consultas SAP BExConnectivity for SAP BEx queries

    É possível executar consultas BEx no Power BI Desktop habilitando uma propriedade específica, conforme mostrado na seguinte imagem:You can perform BEx queries in Power BI Desktop by enabling a specific property, as shown in the following image:

Próximas etapasNext steps

Para obter mais informações sobre o SAP e o DirectQuery, confira os seguintes recursos:For more information about SAP and DirectQuery, check out the following resources: