Denodo

Artigo
01/24/2024

Nota

O seguinte artigo do conector é fornecido por Denodo, o proprietário deste conector e um membro do Programa de Certificação do Microsoft Power Query Connector. Se você tiver dúvidas sobre o conteúdo deste artigo ou tiver alterações que gostaria de ver feitas neste artigo, visite o site da Denodo e use os canais de suporte lá.

Resumo

Item	Description
Estado de Lançamento	Disponibilidade Geral
Produtos	Power BI (modelos semânticos) Power BI (Fluxos de Dados) Malha (Dataflow Gen2)
Tipos de autenticação suportados	Básico Windows

Nota

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Pré-requisitos

Para usar esse conector, você deve ter instalado a plataforma Denodo, configurado e iniciado seu serviço. No caso de uma conexão usando um DSN ODBC, você deve ter configurado corretamente a conexão no Administrador de Fonte de Dados ODBC.

Capacidades suportadas

Importar
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:

Para se conectar aos dados, selecione Obter dados da faixa de opções Página Inicial e selecione Denodo na seção Banco de dados .
Há duas maneiras de se conectar à fonte de dados de sua escolha:
- Através 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 Denodo, forneça o Nome da Fonte de Dados (DSN) ou a Cadeia de Conexão, dependendo do tipo de conexão de sua preferência.

Ao criar uma cadeia de conexão compatível com Denodo, você deve levar em conta que o campo Driver deve ser omitido, pois isso é 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.
Nota

Ao escrever a cadeia de conexão, ela deve ser levada em consideração:
- A cadeia de conexão deve manter a ordem correta de seus parâmetros: SERVER, PORT, DATABASE e SSLMode.
- O nome desses parâmetros deve ser sempre escrito da mesma maneira. Por exemplo, se você optar por escrevê-los em maiúsculas, eles devem sempre ser escritos em maiúsculas; Se você decidir escrevê-los em maiúsculas (escrevendo a primeira letra de uma palavra em maiúsculas e o resto das letras em minúsculas), eles devem sempre ser escritos dessa forma.
Fazer o contrário poderia impedir que o Power BI reconhecesse diferentes conjuntos de dados Denodo em um relatório como pertencentes à mesma fonte de dados Denodo e, como consequência, solicitasse credenciais de autenticação separadas para cada um deles.
A segunda seção, Ativar 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 modo de depuração é false e, nesse cenário, não haverá dados de rastreamento nos arquivos de log do conector personalizado do Denodo Power BI.
A terceira seção, Consulta Nativa, é um campo opcional onde 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 desejar escrever uma consulta que consulte mais de um banco de dados, será necessário especificar na consulta o banco de dados proprietário de cada tabela.
```
SELECT i_item_sk, country FROM sakila.country, ewd.item
```
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.
Quando terminar, selecione OK.
Antes de mostrar a janela do navegador que exibe uma visualização dos dados disponíveis no Denodo Virtual DataPort, você será solicitado para autenticação. O conector personalizado do Denodo Power BI suporta 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 DataPort Virtual usando a 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 em execução no domínio do Windows, porque 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 do 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 do servidor Virtual DataPort.
Quando terminar, selecione Conectar.
No Navegador, selecione os dados necessários do banco de dados desejado e escolha Carregar ou escolha Transformar dados se quiser modificar os dados recebidos.

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

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

Configure o gateway de dados local (gateway corporativo) que atua como uma ponte, fornecendo transferência de dados rápida e segura entre dados locais (dados em seu aplicativo Power BI Desktop, não na nuvem) e o serviço Power BI.
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.
Usando a página de configurações de gateway no serviço Power BI, crie uma fonte de dados para o conector personalizado Denodo Power BI.

Para criar a fonte de dados, você precisa especificar a maneira de se conectar à fonte de dados de sua escolha:
- Através do DSN
- Usando 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 Power BI se conecta à Porta de Dados Virtual usando a autenticação Kerberos. Necessita de:
  - Em 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 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: esse tipo de autenticação permite que você crie uma fonte de dados no serviço Power BI para se conectar aos dados da Porta de Dados Virtual usando suas credenciais de servidor de Porta de Dados Virtual.
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 logon único (SSO) 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 SSO via Kerberos para consultas DirectQuery e Usar SSO via Kerberos para consultas DirectQuery e Importar. Se você estiver trabalhando com relatórios baseados em 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 importação . Nesse cenário, a primeira opção usa as credenciais inseridas na página da fonte de dados (campos Nome de usuário e Senha ), enquanto a segunda 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 de Kerberos deve ser habilitada para o usuário do Windows que executa o Microsoft Power BI Gateway, e a configuração dos ambientes locais do Ative Directory e do Microsoft Entra ID 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 nome principal do usuário (UPN) quando executa uma operação de autenticação SSO. Portanto, você precisará revisar o atributo que usará como identificador de login 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 Gateway do Microsoft Power BI 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 em tempo de execução. O ADUserNameLookupProperty deve especificar em relação a qual atributo do AD local ele deve mapear o nome principal do usuário que vem da ID do Microsoft Entra. Assim, neste cenário, ADUserNameLookupProperty deve ser userPrincipalName. Em seguida, uma vez 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ê usará como identificador de login 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, afetarão qualquer fonte com a qual a autenticação SSO é feita por meio do Gateway do Microsoft Power BI.
Depois que uma fonte de dados é criada para o conector Denodo, você pode atualizar os relatórios do Power BI. Para publicar um relatório sobre 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 espaço de trabalho onde deseja publicar.

Resolução de Problemas

Carregando dados quando um campo em uma exibição Denodo tem mais de 42 relações com outras exibições.

Se um modo de exibição Denodo que está sendo importado como uma fonte de dados para o Power BI tiver mais de 42 relações com outros modos de exibição, 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.

Este erro deve-se 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 View>Advanced Editor. Em seguida, edite a expressão da fonte de dados na linguagem M adicionando a seguinte propriedade ao options argumento da chamada de Denodo.Contents função:

CreateNavigationProperties=false

Assim, a sua chamada seria semelhante a:

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

Essa propriedade instruirá o Power BI a não tentar gerar propriedades de navegação a partir das relações registradas para o modo de exibição Denodo acessado nesta fonte de dados. Portanto, se você precisar que alguns desses relacionamentos estejam realmente presentes em seu modelo de dados do Power BI, precisará registrá-los manualmente posteriormente.

Partilhar via