Denodo

Resumo

Pré-requisitos

Para usar este conector, instale e configure a plataforma Denodo e inicie o seu serviço. Se tiver uma ligação que utiliza um nome de fonte de dados ODBC (DSN), deve configurar corretamente a ligação no administrador da fonte de dados ODBC.

Capacidades suportadas

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

Ligar a uma origem de dados ODBC a partir do Power Query Desktop

Para estabelecer a ligação, siga os seguintes passos:

1. Para se conectar aos dados, na barra Inicial, selecione Obter Dados. Na secção Base de Dados , selecione Denodo.

   

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

   • DSN (nome da fonte de dados ODBC)
   • Cadeia de ligação

   No diálogo Denodo Connector, na secção DSN ou Cadeia de Conexão, indique o nome da origem de dados ou a cadeia de conexão, dependendo do tipo de ligação que prefere.

   

   Ao criar uma cadeia de ligação compatível com Denodo, deve omitir o campo Driver , porque este campo é definido de forma transparente no momento da ligação pelo próprio conector.

   A cadeia de ligaçã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, pode conter um parâmetro opcional: SSLmode.

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

   Omita os parâmetros de autenticação. Configura a autenticação nas etapas seguintes.

   Observação

   Ao escrever a cadeia de ligação, esteja ciente dos seguintes requisitos:

   • A cadeia de ligação deve manter a ordem correta dos seus parâmetros: SERVER, PORT, DATABASE, e SSLMode.
   • O nome desses parâmetros deve ser sempre escrito da mesma maneira. Por exemplo, se optar por escrevê-las em maiúsculas, devem estar sempre escritas em maiúsculas. Se decidir escrevê-las com a primeira letra de uma palavra em maiúsculas e as restantes letras em minúsculas, devem estar sempre escritas dessa forma.

   Caso contrário, o Power BI pode não reconhecer diferentes conjuntos de dados Denodo num relatório como pertencendo à mesma fonte de dados Denodo. Como resultado, o Power BI pode solicitar credenciais de autenticação separadas para cada uma delas.

3. A segunda seção, Ativar modo de depuração, é um campo opcional que permite adicionar informações de rastreamento aos arquivos de log. O Power BI Desktop cria estes ficheiros quando ativas o rastreio na aplicação, usando o separador Diagnósticos no menu de Opções . O valor predefinido para Ativar modo de depuração é falso e, neste cenário, não há dados de rastreio nos ficheiros de registo do conector personalizado Denodo Power BI.

4. A terceira seção, Consulta Nativa, é um campo opcional onde você pode inserir uma consulta. Se usar este campo de consulta, o conjunto de dados é o resultado da consulta em vez de uma tabela ou conjunto de tabelas.

   Pode escrever uma consulta que consulte apenas uma das bases de dados a que 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 quiser escrever uma consulta que consulte mais do que uma base de dados, deve especificar na consulta a base de dados que possui cada tabela.

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

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

6. Quando terminares, seleciona OK.

7. Agora pedem-lhe autenticação. O conector personalizado Denodo Power BI suporta três tipos de autenticação:

   • Windows: Quando escolhe usar autenticação Windows, o Power BI Desktop liga-se ao Virtual DataPort através da autenticação Kerberos.

     

     Neste 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 a opção ODBC/ADO.net tipo de autenticação definido como Kerberos.

     • O Power BI Desktop deve estar a funcionar no domínio do Windows, porque o driver ODBC solicita o ticket de Kerberos da cache de tickets do sistema operativo.

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

       

   • Básico: Este tipo de autenticação liga o Power BI Desktop aos seus dados do Virtual DataPort através das credenciais do seu servidor Virtual DataPort.

     

     Observação

     Versões mais antigas do conector Denodo exigiam que escapasses de certos caracteres de palavra-passe. A partir da versão 1.0.8, esta regra deixou de ser obrigatória.

   • Conta organizacional: Este tipo de autenticação liga o Power BI Desktop aos seus dados do Virtual DataPort através de um conjunto específico de credenciais Microsoft. Esta opção é uma versão especializada do OAuth para Microsoft Entra ID.

     

     Quando seleciona Iniciar sessão, abre-se um separador de iniciar sessão. Introduza as credenciais Microsoft a serem usadas para esta fonte de dados.

     

     Quando estiver iniciado sessão, selecione Conectar. Depois vês o ecrã do navegador para a seleção da tabela.

     

     Observação

     Para aceder às bases de dados Virtual DataPort, deve criar um utilizador no Denodo. O nome do utilizador deve ser o mesmo do email usado no Power BI quando o utilizador inicia sessão na conta organizacional. Ao criar o utilizador no Denodo, deve selecionar EXTERNO como tipo de autenticação. As permissões atribuídas a este utilizador nas bases de dados Denodo determinam quais as bases de dados que podem ser acedidas a partir do Power BI Desktop.

8. Quando terminar, selecione Conectar.

9. No Navigator, seleciona a base de dados e os dados que queres, e depois seleciona Carregar. Alternativamente, se for modificar os dados recebidos, selecione Transformar Dados.

   

Ligue-se ao Denodo a partir do Power Query Online

Para se ligar aos dados da Denodo:

1. Selecione Denodo na página Power Query Ligar à fonte de dados.

2. No diálogo Denodo, introduza a DSN ou String de Ligação para a sua instância Denodo. Para uma cadeia de ligação, deve especificar os parâmetros SERVER, PORT e DATABASE.

3. Escolha se quer ou não ativar o modo de depuração.

4. Inclua o nome do seu gateway de dados local.

   Observação

   É necessário um gateway de dados local porque o conector Denodo utiliza um driver ODBC que deve ser instalado na máquina gateway.

5. Selecione o tipo de autenticação e forneça as suas credenciais:

   • Básico: Introduza o seu nome de utilizador e palavra-passe do Denodo.
   • Conta organizacional: Inicie sessão com a sua conta organizacional.

6. Selecione Avançar para continuar.

7. Na página Choose data, seleciona as vistas ou tabelas que queres carregar e depois seleciona Transformar dados para transformar os dados em Editor do Power Query.

Ligue-se a uma fonte de dados ODBC a partir do serviço Power BI

Para este método de ligação, utiliza-se o gateway de dados local. Siga estes passos:

1. Configure o gateway de dados local (gateway empresarial). Este gateway proporciona uma transferência rápida e segura de dados entre dados locais (dados na sua aplicação Power BI Desktop, não na cloud) e o serviço Power BI.

2. Inicie sessão e registe o 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. No serviço Power BI, nas Definições de Fonte de Dados, crie uma fonte de dados para o conector personalizado Denodo Power BI.

   

   Para criar a fonte de dados, tem de especificar a forma de se ligar à fonte de dados da sua escolha:

   • DSN
   • Cadeia de ligação

   Observação

   Recomendamos a DSN. Oferece muitas opções de configuração que podem não estar diretamente disponíveis quando se usa uma cadeia de ligação.

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

   • Windows: O serviço Power BI liga-se ao Virtual DataPort através da autenticação Kerberos.

     • Em Configurações da Fonte de Dados, insira o nome de usuário e a senha para criar o tíquete Kerberos.
     • No servidor Virtual DataPort, ative a autenticação Kerberos.
     • O banco de dados Denodo Virtual DataPort ao qual a fonte de dados se conecta deve ser configurado com a opção ODBC/ADO.net tipo de autenticação definido como Kerberos.
     • Verifique se a página Opções Avançadas da configuração do DSN contém toda a configuração necessária para usar Kerberos como um método de autenticação.

     

   • Básico: Pode criar uma fonte de dados no serviço Power BI para se ligar aos seus dados do Virtual DataPort, através das credenciais do seu servidor Virtual DataPort.

   • Oauth: Pode criar uma fonte de dados no serviço Power BI para se ligar aos seus dados Virtual DataPort, através das credenciais Microsoft.

     Observação

     Para aceder às bases de dados Virtual DataPort, deve criar um utilizador no Denodo cujo nome seja o mesmo do email usado no Power BI ao iniciar sessão na conta organizacional. Ao criar o utilizador no Denodo, deve selecionar EXTERNO como tipo de autenticação. As permissões concedidas a este utilizador nas bases de dados Denodo determinam quais as bases de dados que podem ser acedidas a partir do Power BI.

4. Se usar Windows authentication, em Definições avançadas para a fonte de dados, pode ativar o login único (SSO) para que os visualizadores de relatórios consultem o Denodo com a sua própria identidade. O conector Denodo suporta dois caminhos SSO: Kerberos e Microsoft Entra ID.

   Kerberos SSO:

   

   Existem duas opções para ativar o SSO do Kerberos: usar SSO via Kerberos para consultas DirectQuery e usar SSO via Kerberos para consultas DirectQuery e Importação. Se estiver a trabalhar com relatórios baseados no DirectQuery, ambas as opções usam as credenciais SSO do utilizador que inicia sessão no serviço Power BI. Se estiver a trabalhar com relatórios baseados em Importar, a primeira opção usa as credenciais introduzidas na página de fonte de dados (campos Nome de utilizador e palavra-passe ), enquanto a segunda usa as credenciais do proprietário do modelo semântico.

   Existem pré-requisitos e considerações particulares que deve ter em conta para usar SSO baseado em Kerberos. Alguns destes requisitos são:

   • Deve ativar a delegação restrita do Kerberos para o utilizador Windows que executa o gateway Power BI. Além disso, configure tanto os ambientes local do Active Directory como do Microsoft Entra ID de acordo com as instruções fornecidas pela Microsoft para este fim.

     Por defeito, o gateway Power BI envia o nome principal do utilizador (UPN) quando realiza uma operação de autenticação SSO. Revise o atributo que usa como identificador de login na autenticação Denodo Kerberos. Se for diferente de userPrincipalName, ajusta as definições do gateway para corresponder.

   • O ficheiro de configuração do Power BI gateway encontra-se Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, localizado em \Program Files\On-premises data gateway. Este ficheiro tem duas propriedades, ADUserNameLookupProperty e ADUserNameReplacementProperty, que permitem ao gateway realizar consultas de Microsoft Entra ID locais em tempo de execução. ADUserNameLookupProperty especifica para que atributo do Active Directory local o gateway mapeia o nome principal do utilizador proveniente do Microsoft Entra ID. Neste cenário, ADUserNameLookupProperty deveria ser userPrincipalName. Quando o utilizador é encontrado, o ADUserNameReplacementProperty valor indica o atributo que autentica o utilizador suplantado (o atributo que usa como identificador de login no Denodo).

     Alterações a este ficheiro de configuração aplicam-se ao nível do gateway e afetam qualquer fonte que utilize autenticação SSO através do gateway Power BI.

   Microsoft Entra ID SSO:

   Quando ativa o SSO do Microsoft Entra ID para o conector Denodo, os utilizadores de um modelo semântico do DirectQuery executam consultas no Denodo com a sua própria identidade do Microsoft Entra ID. O SSO do Entra ID elimina as dependências do Active Directory local e da delegação condicionada de Kerberos que o SSO de Kerberos exige.

   A Entra ID SSO tem os seguintes pré-requisitos:

   • Um administrador de inquilino do Power BI ativa Denodo SSO e Microsoft Entra ID SSO para o gateway de dados nas definições do inquilino.
   • O gateway de dados local executa uma versão que suporta o Entra ID SSO.
   • O servidor Denodo executa uma versão que suporta validação de tokens Microsoft Entra ID.

   

   Depois de o Denodo SSO estar ativado no tenant, as opções Single log-on na página da fonte de dados incluem uma caixa de seleção Use SSO via Azure AD para consultas DirectQuery. Selecione esta caixa para ativar o SSO do Entra ID para qualquer modelo semântico DirectQuery associado à ligação de dados.

   

   Entra ID SSO aplica-se apenas a modelos semânticos DirectQuery. Os modelos importados respondem a consultas de dados importados e não transmitem as identidades dos utilizadores à fonte de dados.

5. Depois de criar uma fonte de dados para o conector Denodo, pode atualizar os relatórios do Power BI. Para publicar um relatório no powerbi.com:

   • Abra o relatório no Power BI Desktop.
   • Selecione Arquivo>Publicar>Publicar no Power BI.
   • Salve o relatório no computador.
   • Selecione o espaço de trabalho onde deseja publicar.

Configuração avançada

Utilização do parâmetro ConnectionTimeout

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

Use este parâmetro apenas do editor avançado. Para isso, o ConnectionTimeout parâmetro deve ser adicionado nas opções de registro, associando um valor do tipo duration a ele.

Saiba mais sobre este duration tipo neste artigo.

Utilização do parâmetro QueryTimeout

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

Use este parâmetro apenas do editor avançado. Para isso, o QueryTimeout parâmetro deve ser adicionado nas opções de registro, associando um valor do tipo number a ele. Este valor numérico é representado em milissegundos (por exemplo, 10000 equivale a 10 segundos).

Utilização do parâmetro UserAgent

Se desejar especificar o nome do aplicativo cliente, você pode usar o UserAgent parâmetro.

Use este parâmetro apenas do editor avançado. Para isso, o UserAgent parâmetro deve ser adicionado nas opções de registro, associando um valor do tipo text.

Utilização do parâmetro de compressão

Recomendamos que ative esta definição quando a aplicação cliente e o servidor Denodo estiverem ligados através de uma WAN. Nesses casos, você pode esperar melhorias significativas de desempenho quando o aplicativo cliente lê volumes de dados moderados ou grandes.

Use este parâmetro apenas do editor avançado. Para isso, o Compression parâmetro deve ser adicionado nas opções de registro, associando um valor do tipo number (0 ou 1).

Solução de problemas

Se uma vista Denodo a ser importada como fonte de dados para o Power BI tiver mais de 42 relações com outras vistas, o Power BI pode apresentar o seguinte erro quando tentar aceder à janela de transformação de dados:

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

Este erro deve-se a uma limitação na plataforma Power Query. Para contornar o problema, selecione a fonte de dados falhada (consulta) na janela de transformação de dados e selecione Ver>Editor Avançado. Depois, editar a expressão da fonte de dados em linguagem M, adicionando a seguinte propriedade ao argumento options da chamada de função Denodo.Contents.

CreateNavigationProperties=false

Assim, a sua chamada seria semelhante a:

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

Esta propriedade instrui o Power BI a não tentar gerar propriedades de navegação a partir das relações registadas para a visualização Denodo acedida nesta fonte de dados. Se precisar que algumas destas relações estejam presentes no seu modelo de dados Power BI, terá de as registar manualmente depois.