Denodo

Resumo

Pré-requisitos

Para usar esse conector, a plataforma Denodo deve ser instalada e configurada e seu serviço iniciado. Se você tiver uma conexão usando um DSN ODBC, deverá configurar corretamente a conexão no Administrador da Fonte de Dados ODBC.

Capacidades suportadas

• Importação
• DirectQuery (modelos semânticos do Power BI)

Conectar-se a uma fonte de dados ODBC do Power Query Desktop

Para fazer a conexão, execute as seguintes etapas:

1. Para se conectar aos dados, selecione Obter Dados na faixa de opções Página Inicial e selecione Denodo na seção Banco de Dados .

   

2. Há duas maneiras de se conectar à fonte de dados de sua escolha:

   • Por meio de DSN (nome da fonte de dados ODBC)
   • Usando uma cadeia de conexão

   Na seção DSN ou cadeia de conexão da caixa de diálogo Conector de Denodo , forneça o DSN (nome da fonte de dados) ou a cadeia de conexão , dependendo do tipo de conexão que você preferir.

   

   Ao criar uma cadeia de conexão compatível com Denodo, você deve levar em conta que o campo Driver deve ser omitido, pois esse campo é definido de forma transparente no momento da conexão pelo próprio conector.

   A cadeia de conexão deve conter três parâmetros obrigatórios: SERVER, PORT e DATABASE:

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>
   

   Além disso, ele pode conter um parâmetro opcional: SSLmode:

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>;SSLmode=<SSL mode>
   

   Os parâmetros de autenticação devem ser omitidos, pois a autenticação é configurada em etapas posteriores.

   Observação

   Quando você escreve a cadeia de conexão, as seguintes considerações devem ser levadas em conta:

   • A cadeia de conexão deve manter a ordem correta de seus parâmetros: SERVER, PORT, DATABASE e SSLMode.
   • O nome desses parâmetros sempre deve ser escrito da mesma maneira. Por exemplo, se você optar por escrevê-las com todas as letras maiúsculas, elas devem sempre ser escritas assim. Se decidir pela capitalização (escrevendo a primeira letra em maiúscula e o restante em minúsculas), elas devem sempre ser escritas dessa forma.

   Fazer o contrário poderia impedir o Power BI de reconhecer diferentes conjuntos de dados do Denodo em um relatório como pertencentes à mesma fonte de dados do Denodo e, como consequência, solicitar credenciais de autenticação separadas para cada um deles.

3. A segunda seção, Habilitar modo de depuração, é um campo opcional que permite adicionar informações de rastreamento aos arquivos de log. Esses arquivos são criados pelo Power BI Desktop quando você habilita o rastreamento no aplicativo usando a guia Diagnóstico no menu Opções . Observe que o valor padrão para habilitar o modo de depuração é falso e, nesse cenário, não há dados de rastreamento nos arquivos de log do conector personalizado do Denodo Power BI.

4. A terceira seção, Native Query, é um campo opcional em que você pode inserir uma consulta. Se esse campo de consulta for usado, o conjunto de dados resultante será o resultado da consulta em vez de uma tabela ou um conjunto de tabelas.

   Você pode escrever uma consulta que consulta apenas um dos bancos de dados aos quais a fonte de dados está associada.

   SELECT title, name FROM film JOIN language ON film.language_id = language.language_id WHERE film.language_id = 1
   

   Se você quiser escrever uma consulta que consulte mais de um banco de dados, será necessário especificar na consulta o banco de dados que possui cada tabela.

   SELECT i_item_sk, country FROM sakila.country, ewd.item
   

5. A última seção no Conector de Denodo é o modo de conectividade de dados, em que você pode escolher entre o modo de importação ou o modo DirectQuery.

6. Quando terminar, selecione OK.

7. Antes de mostrar a janela do navegador que exibe uma visualização dos dados disponíveis no Denodo Virtual DataPort, você será solicitado a autenticação. O conector personalizado do Denodo Power BI dá suporte a dois tipos de autenticação: Windows e Basic.

   • Windows: Quando você opta por usar a autenticação do Windows, o Power BI Desktop se conecta ao Virtual DataPort usando a autenticação Kerberos.

     

     Nesse caso:

     • A autenticação Kerberos deve ser habilitada no servidor DataPort Virtual.

     • O banco de dados Denodo Virtual DataPort ao qual a fonte de dados se conecta deve ser configurado com o tipo de autenticação ODBC/ADO.net de opção definido como Kerberos.

     • O Power BI Desktop deve estar em execução no domínio do Windows, pois o driver ODBC solicita o tíquete Kerberos do cache de tíquetes do sistema operacional.

     • Verifique se a página Opções Avançadas da configuração de DSN contém toda a configuração necessária para usar Kerberos como um método de autenticação.

       

   • Básico: esse tipo de autenticação permite que você conecte o Power BI Desktop aos dados do Virtual DataPort usando suas credenciais de servidor DataPort Virtual.

     

     Observação

     Versões mais antigas do conector Denodo exigiam o escape de determinados caracteres de senha. A partir da versão 1.0.8, esse escape não é mais necessário.

   • Conta organizacional: esse tipo de autenticação permite que você conecte o Power BI Desktop aos dados do Virtual DataPort usando um conjunto específico de credenciais da Microsoft. Esse tipo de autenticação é uma versão especializada do OAuth para a ID do Microsoft Entra.

     

     Quando você seleciona Entrar, uma guia de entrada é aberta. Insira as credenciais da Microsoft a serem usadas para essa fonte de dados.

     

     Depois de entrar, selecione Conectar e a tela do navegador para selecionar a tabela será carregada.

     

     Observação

     Para acessar bancos de dados VDP, um usuário deve ser criado no Denodo cujo nome é o mesmo que o email usado no Power BI ao entrar na conta organizacional. Quando você cria o usuário no Denodo, EXTERNAL deve ser selecionado como tipo de autenticação. As permissões fornecidas a esse usuário nos bancos de dados de Denodo determinam quais bancos de dados podem ser acessados do Power BI Desktop.

8. Depois de terminar, selecione Conectar.

9. No Navegador, selecione os dados necessários no banco de dados desejado e escolha Carregar ou escolha Transformar Dados se quiser modificar os dados de entrada.

   

Conectar-se a uma fonte de dados ODBC do serviço do Power BI usando o gateway de dados local

Para fazer a conexão, execute as seguintes etapas:

1. Configure o gateway de dados local (gateway empresarial) que atua como uma ponte, fornecendo transferência rápida e segura de dados entre dados locais (dados em seu aplicativo do Power BI Desktop, não na nuvem) e o serviço do Power BI.

2. Faça login e registre seu gateway. No aplicativo de gateway de dados local, selecione a guia Status para verificar se o gateway está online e pronto para ser usado.

   

3. Usando a página de configurações do gateway no serviço do Power BI, crie uma fonte de dados para o conector personalizado do Denodo Power BI.

   

   Para criar a fonte de dados, você precisa especificar a maneira de se conectar à fonte de dados de sua escolha:

   • Por meio do DSN
   • Usando uma cadeia de conexão

   Observação

   Ao decidir se deseja se conectar por meio de uma cadeia de conexão ou DSN, é recomendável usar a última. Esse método é recomendado porque a configuração de DSN oferece muito mais opções de configuração que podem não estar diretamente disponíveis ao usar uma cadeia de conexão.

   Você também precisa especificar o modo de autenticação. Os métodos de autenticação disponíveis são:

   • Windows: Quando você opta por usar a autenticação do Windows, o serviço do Power BI conecta-se ao Virtual DataPort usando a autenticação Kerberos. Você precisa:

     • Nas Configurações da Fonte de Dados, insira o nome de usuário e a senha para criar o tíquete Kerberos.

     • A autenticação Kerberos deve ser habilitada no servidor DataPort Virtual.

     • O banco de dados Denodo Virtual DataPort ao qual a fonte de dados se conecta deve ser configurado com o tipo de autenticação ODBC/ADO.net de opção definido como Kerberos.

     • Verifique se a página Opções Avançadas da configuração de DSN contém toda a configuração necessária para usar Kerberos como um método de autenticação.

       

   • Básico: esse tipo de autenticação permite que você crie uma fonte de dados no serviço do Power BI para se conectar aos dados do Virtual DataPort usando suas credenciais do servidor DataPort Virtual.

   • Oauth: Esse tipo de autenticação permite que você crie uma fonte de dados no serviço do Power BI para se conectar aos dados do Virtual DataPort usando as credenciais da Microsoft.

     Observação

     Para acessar os bancos de dados VDP, um usuário deve ser criado no Denodo cujo nome é o mesmo que o email usado no Power BI ao fazer logon na conta organizacional. Quando você cria o usuário no Denodo, EXTERNAL deve ser selecionado como tipo de autenticação. As permissões fornecidas a esse usuário nos bancos de dados do Denodo determinam quais bancos de dados podem ser acessados do Power BI.

4. Se você usar a autenticação do Windows, em configurações avançadas para a fonte de dados, poderá habilitar o esquema de autenticação de SSO (logon único) para usar as mesmas credenciais do usuário que acessa seus relatórios no Power BI para acessar os dados necessários no Denodo.

   

   Há duas opções para habilitar o SSO: usar o SSO via Kerberos para consultas DirectQuery e usar o SSO via Kerberos para consultas DirectQuery e Importação. Se você estiver trabalhando com relatórios baseados no DirectQuery , ambas as opções usarão as credenciais de SSO do usuário que entra no serviço do Power BI. A diferença vem quando você trabalha com relatórios baseados em Import. Nesse cenário, a opção anterior usa as credenciais inseridas na página de fonte de dados (campos Nome de usuário e senha ), enquanto a última usa as credenciais do proprietário do conjunto de dados.

   É importante observar que há pré-requisitos e considerações específicos que você deve levar em conta para usar o SSO baseado em Kerberos. Alguns desses requisitos essenciais são:

   • A delegação restrita do Kerberos deve ser habilitada para o usuário do Windows que executa o Gateway do Microsoft Power BI. Além disso, a configuração dos ambientes do Active Directory local e da ID do Microsoft Entra deve ser executada de acordo com as instruções oferecidas pela Microsoft para essa finalidade.

     Por padrão, o Gateway do Microsoft Power BI envia o UPN (nome principal do usuário) quando executa uma operação de autenticação SSO. Portanto, você precisa examinar o atributo que usa como identificador de logon na Autenticação Kerberos do Denodo e, se for diferente de userPrincipalName, ajustar as configurações do gateway de acordo com esse valor.

   • O arquivo de configuração do Microsoft Power BI Gateway chamado Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, armazenado em \Program Files\On-premises data gateway tem duas propriedades chamadas ADUserNameLookupProperty e ADUserNameReplacementProperty que permitem que o gateway execute pesquisas locais de ID do Microsoft Entra no runtime. Ele ADUserNameLookupProperty deve especificar em relação a qual atributo do AD local deve mapear o nome principal de usuário proveniente do Microsoft Entra ID. Portanto, neste cenário, ADUserNameLookupProperty deve ser userPrincipalName. Em seguida, depois que o usuário é encontrado, o ADUserNameReplacementProperty valor indica o atributo que deve ser usado para autenticar o usuário representado (o atributo que você usa como o identificador de logon no Denodo).

     Você também deve levar em conta que as alterações nesse arquivo de configuração estão no nível do gateway e, portanto, afetam qualquer fonte com a qual a autenticação de SSO é feita por meio do Gateway do Microsoft Power BI.

5. Depois que uma fonte de dados for criada para o conector de Denodo, você poderá atualizar os relatórios do Power BI. Para publicar um relatório no powerbi.com, você precisa:

   • Abra o relatório no Power BI Desktop.
   • Selecione Arquivo>Publicar>Publicar no Power BI.
   • Salve o relatório no computador.
   • Selecione o workspace onde você deseja publicar.

Configuração avançada

Uso do parâmetro ConnectionTimeout

Se você quiser controlar quanto tempo aguardar antes de abandonar uma tentativa de fazer uma conexão com um servidor, poderá usar o ConnectionTimeout parâmetro.

Esse parâmetro só pode ser usado no editor avançado. Para fazer isso, o ConnectionTimeout parâmetro deve ser adicionado nas opções de registro, associando um valor de tipo duration a ele.

Saiba mais sobre o duration tipo aqui.

Uso do parâmetro QueryTimeout

Se você quiser controlar quanto tempo aguardar antes de abandonar uma tentativa de fazer a execução de uma consulta, poderá usar o QueryTimeout parâmetro.

Esse parâmetro só pode ser usado no editor avançado. Para fazer isso, o QueryTimeout parâmetro deve ser adicionado nas opções de registro, associando um valor de tipo number a ele. Esse valor numérico é representado em milissegundos, por exemplo, 10000 é igual a 10s.

Uso do parâmetro UserAgent

Se você quiser especificar o nome do aplicativo cliente, poderá usar o UserAgent parâmetro.

Esse parâmetro só pode ser usado no editor avançado. Para fazer isso, o UserAgent parâmetro deve ser adicionado nas opções de registro, associando um valor do tipo text.

Uso do parâmetro compression

Recomendamos que você ative essa configuração quando o aplicativo cliente e o servidor Denodo estiverem conectados por meio de uma WAN. Nesses casos, você pode esperar melhorias significativas de desempenho quando o aplicativo cliente lê volumes de dados moderados ou grandes. Para isso, você pode usar o Compression parâmetro.

Esse parâmetro só pode ser usado no editor avançado. Para fazer isso, o Compression parâmetro deve ser adicionado nas opções de registro, associando um valor de tipo number (0 ou 1).

Resolução de problemas

Carregar dados quando um campo em um modo de exibição Denodo tem mais de 42 relações com outras exibições

Se uma exibição de Denodo sendo importada como uma fonte de dados para o Power BI tiver mais de 42 relações com outras exibições, o Power BI poderá exibir o seguinte erro ao acessar a janela de transformação de dados:

Preview.Error: The type of the current preview value is too complex to display.

Esse erro ocorre devido a uma limitação na plataforma Microsoft Power Query. Para contornar isso, selecione a fonte de dados com falha (consulta) na janela de transformação de dados e acesse o editor avançado com Exibição>Editor Avançado. Em seguida, edite a expressão da fonte de dados no idioma M adicionando a seguinte propriedade ao argumento options da chamada de função Denodo.Contents:

CreateNavigationProperties=false

Portanto, sua chamada seria semelhante a:

  Source = Denodo.Contents(<dsn>, null, [CreateNavigationProperties=false])

Essa propriedade instrui o Power BI a não tentar gerar propriedades de navegação das relações registradas para a exibição Denodo acessada nesta fonte de dados. Portanto, se você precisar que algumas dessas relações estejam realmente presentes em seu modelo de dados do Power BI, será necessário registrá-las manualmente posteriormente.