Denodo

Remarque

L’article du connecteur suivant est fourni par Denodo, le propriétaire de ce connecteur et un membre du programme de certification du connecteur Microsoft Power Query. Si vous avez des questions sur le contenu de cet article ou si vous souhaitez voir les modifications apportées à cet article, visitez le site web de Denodo et utilisez les canaux de support là-bas.

Résumé

Élément	Descriptif
État de publication	Disponibilité générale
Produits	Power BI (modèles sémantiques) Power BI (flux de données) Fabric (Dataflow Gen2)
Types d’authentification pris en charge	De base Fenêtres

Remarque

Certaines fonctionnalités peuvent être présentes dans un produit, mais pas d’autres en raison de planifications de déploiement et de fonctionnalités spécifiques à l’hôte.

Conditions préalables

Pour utiliser ce connecteur, vous devez avoir installé la plateforme Denodo et configuré et démarré son service. En cas de connexion à l’aide d’un DSN ODBC, vous devez avoir correctement configuré la connexion dans l’administrateur de source de données ODBC.

Fonctionnalités prises en charge

• Importer
• DirectQuery (modèles sémantiques Power BI)

Se connecter à une source de données ODBC à partir de Power Query Desktop

Pour établir la connexion, procédez comme suit :

1. Pour vous connecter aux données, sélectionnez Obtenir des données à partir du ruban Accueil et sélectionnez Denodo dans la section Base de données .

   

2. Il existe deux façons de se connecter à la source de données de votre choix :

   • Via DSN (nom de source de données ODBC)
   • Utilisation d’une chaîne de connexion

   Dans la section DSN ou Chaîne de connexion de la boîte de dialogue Connecteur Denodo , indiquez le nom de la source de données (DSN) ou la chaîne de connexion en fonction du type de connexion que vous préférez.

   

   Lors de la création d’une chaîne de connexion compatible Denodo, vous devez tenir compte du fait que le champ Pilote doit être omis, car il est défini de manière transparente au moment de la connexion par le connecteur lui-même.

   La chaîne de connexion doit contenir trois paramètres obligatoires : SERVER, PORT et DATABASE :

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

   En outre, il peut contenir un paramètre facultatif : SSLmode :

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

   Les paramètres d’authentification doivent être omis, car l’authentification est configurée dans les étapes ultérieures.

   Remarque

   Lors de l’écriture de la chaîne de connexion, elle doit être prise en compte :

   • La chaîne de connexion doit conserver l’ordre correct de ses paramètres : SERVER, PORT, DATABASE et SSLMode.
   • Le nom de ces paramètres doit toujours être écrit de la même façon. Par exemple, si vous choisissez de les écrire en majuscules, ils doivent toujours être écrits en majuscules ; si vous décidez de les écrire en majuscules (écrire la première lettre d’un mot en majuscules et le reste des lettres en minuscules) elles doivent toujours être écrites de cette façon.

   Sinon, Power BI pourrait ne pas reconnaître les différents jeux de données Denodo dans un rapport comme appartenant à la même source de données Denodo et, par conséquent, demander des identifiants d'authentification distincts pour chacun d'eux.

3. La deuxième section, Activer le mode débogage, est un champ facultatif qui vous permet d’ajouter des informations de trace aux fichiers journaux. Ces fichiers sont créés par Power BI Desktop lorsque vous activez le suivi dans l’application à l’aide de l’onglet Diagnostics dans le menu Options . Notez que la valeur par défaut pour activer le mode débogage est false. Dans ce scénario, il n’y aura pas de données de trace dans les fichiers journaux à partir du connecteur personnalisé Denodo Power BI.

4. La troisième section, Native Query, est un champ facultatif dans lequel vous pouvez entrer une requête. Si ce champ de requête est utilisé, le jeu de données résultant sera le résultat de la requête au lieu d’une table ou d’un ensemble de tables.

   Vous pouvez écrire une requête qui interroge une seule des bases de données auxquelles la source de données est associée.

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

   Si vous souhaitez écrire une requête qui interroge plusieurs bases de données, vous devez spécifier dans la requête la base de données propriétaire de chaque table.

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

5. La dernière section du connecteur Denodo est le mode de connectivité des données, où vous pouvez choisir entre le mode Importation ou directQuery.

6. Quand vous avez terminé, sélectionnez OK.

7. Avant d’afficher la fenêtre de navigateur qui affiche un aperçu des données disponibles dans Denodo Virtual DataPort, vous êtes invité à vous authentifier. Le connecteur personnalisé Denodo Power BI prend en charge deux types d’authentification : Windows et Basic.

   • Windows : Lorsque vous choisissez d’utiliser l’authentification Windows, Power BI Desktop se connecte à Virtual DataPort à l’aide de l’authentification Kerberos.

     

     Dans ce cas :

     • L’authentification Kerberos doit être activée sur le serveur Virtual DataPort.

     • La base de données Denodo Virtual DataPort à laquelle la source de données se connecte doit être configurée avec l’option ODBC/ADO.net authentication type définie sur Kerberos.

     • Power BI Desktop doit s’exécuter dans le domaine Windows, car le pilote ODBC demande le ticket Kerberos à partir du cache de tickets du système d’exploitation.

     • Vérifiez que la page Options avancées de la configuration DSN contient toutes les configurations nécessaires à l’utilisation de Kerberos comme méthode d’authentification.

       

   • De base : ce type d’authentification vous permet de connecter Power BI Desktop à vos données Virtual DataPort à l’aide de vos informations d’identification de serveur Virtual DataPort.

     

     Remarque

     Les versions antérieures du connecteur Denodo nécessitaient l’échappement de certains caractères du mot de passe. Depuis la version 1.0.8, cela n’est plus nécessaire.

8. Une fois que vous avez terminé, sélectionnez Se connecter.

9. Dans le navigateur, sélectionnez les données dont vous avez besoin dans la base de données souhaitée et choisissez Charger, ou choisissez Transformer des données si vous souhaitez modifier les données entrantes.

   

Se connecter à une source de données ODBC à partir du service Power BI à l’aide de la passerelle de données locale

Pour établir la connexion, procédez comme suit :

1. Configurez la passerelle de données locale (passerelle d’entreprise) qui agit comme un pont, en fournissant un transfert rapide et sécurisé de données entre les données locales (données de votre application Power BI Desktop, et non dans le cloud) et le service Power BI.

2. Connectez-vous et inscrivez votre passerelle. Dans l’application de passerelle de données locale, sélectionnez l’onglet État pour vérifier que votre passerelle est en ligne et prête à être utilisée.

   

3. À l’aide de la page des paramètres de passerelle dans le service Power BI, créez une source de données pour le connecteur personnalisé Denodo Power BI.

   

   Pour créer la source de données, vous devez spécifier la façon de vous connecter à la source de données de votre choix :

   • Via DSN
   • Utilisation d’une chaîne de connexion

   Remarque

   Lorsque vous décidez s’il faut se connecter via une chaîne de connexion ou un DSN, il est recommandé d’utiliser ce dernier. Cela est dû au fait que la configuration DSN offre de nombreuses options de configuration supplémentaires qui peuvent ne pas être directement disponibles lors de l’utilisation d’une chaîne de connexion.

   Vous devez également spécifier le mode d’authentification. Les méthodes d’authentification disponibles sont les suivantes :

   • Windows : Lorsque vous choisissez d’utiliser l’authentification Windows, le service Power BI se connecte à Virtual DataPort à l’aide de l’authentification Kerberos. Tu as besoin de:

     • Dans paramètres de source de données, entrez le nom d’utilisateur et le mot de passe pour créer le ticket Kerberos.

     • L’authentification Kerberos doit être activée sur le serveur Virtual DataPort.

     • La base de données Denodo Virtual DataPort à laquelle la source de données se connecte doit être configurée avec l’option ODBC/ADO.net authentication type définie sur Kerberos.

     • Vérifiez que la page Options avancées de la configuration DSN contient toutes les configurations nécessaires à l’utilisation de Kerberos comme méthode d’authentification.

       

   • De base : ce type d’authentification vous permet de créer une source de données dans le service Power BI pour vous connecter à vos données Virtual DataPort à l’aide de vos informations d’identification de serveur Virtual DataPort.

4. Si vous utilisez l’authentification Windows, sous Paramètres avancés pour la source de données, vous pouvez activer le schéma d’authentification unique (SSO) afin d’utiliser les mêmes informations d’identification de l’utilisateur accédant à vos rapports dans Power BI pour accéder aux données requises dans Denodo.

   

   Il existe deux options pour activer l’authentification unique : utiliser l’authentification unique via Kerberos pour les requêtes DirectQuery et utiliser l’authentification unique via Kerberos pour les requêtes DirectQuery et Importer. Si vous utilisez des rapports basés sur DirectQuery, les deux options utilisent les identifiants SSO de l'utilisateur qui se connecte au service Power BI. La différence se produit lorsque vous travaillez avec des rapports basés sur l’importation . Dans ce scénario, l’ancienne option utilise les informations d’identification entrées dans la page de source de données (champs Nom d’utilisateur et mot de passe ), tandis que celle-ci utilise les informations d’identification du propriétaire du jeu de données.

   Il est important de noter qu’il existe des conditions préalables et des considérations particulières que vous devez prendre en compte pour utiliser l’authentification unique Basée sur Kerberos. Voici quelques-unes de ces exigences essentielles :

   • La délégation Kerberos contrainte doit être activée pour l’utilisateur Windows exécutant la passerelle Microsoft Power BI, et la configuration des environnements Active Directory et Microsoft Entra ID locaux doivent être effectuées conformément aux instructions offertes par Microsoft à cet effet.

     Par défaut, Microsoft Power BI Gateway envoie le nom principal d’utilisateur (UPN) lorsqu’il effectue une opération d’authentification par SSO. Par conséquent, vous devez passer en revue l’attribut que vous allez utiliser comme identifiant de connexion dans l’authentification Denodo Kerberos et, s’il est différent de userPrincipalName, ajustez les paramètres de la passerelle en fonction de cette valeur.

   • Le fichier de configuration de Microsoft Power BI Gateway appelé Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, stocké à l’adresse \Program Files\On-premises data gateway a deux propriétés appelées ADUserNameLookupProperty et ADUserNameReplacementProperty qui permettent à la passerelle d’effectuer des recherches d’ID Microsoft Entra locales au moment de l’exécution. Il ADUserNameLookupProperty doit spécifier contre lequel attribut de l'AD local il doit mapper le nom principal de l'utilisateur qui provient de l'ID Microsoft Entra. Par conséquent, dans ce scénario, ADUserNameLookupProperty doit être userPrincipalName. Ensuite, une fois l’utilisateur trouvé, la valeur ADUserNameReplacementProperty indique l’attribut qui doit être utilisé pour authentifier l’utilisateur dont l'identité est usurpée (l’attribut que vous utiliserez comme identificateur de connexion dans Denodo).

     Vous devez également prendre en compte que les modifications apportées à ce fichier de configuration sont au niveau de la passerelle et affectent par conséquent toute source avec laquelle l’authentification unique est effectuée via Microsoft Power BI Gateway.

5. Une fois qu’une source de données est créée pour le connecteur Denodo, vous pouvez actualiser les rapports Power BI. Pour publier un rapport sur powerbi.com, vous devez :

   • Ouvrez l’état dans Power BI Desktop.
   • Sélectionnez Fichier>Publier>Publier sur Power BI.
   • Enregistrez le rapport sur l’ordinateur.
   • Sélectionnez l’espace de travail dans lequel vous souhaitez publier.

Configuration avancée

Utilisation du paramètre ConnectionTimeout.

Si vous souhaitez contrôler la durée d’attente avant d’abandonner une tentative d’établir une connexion à un serveur, vous pouvez utiliser le ConnectionTimeout paramètre.

Ce paramètre ne peut être utilisé qu’à partir de l’éditeur avancé. Pour ce faire, le ConnectionTimeout paramètre doit être ajouté dans les options d’enregistrement, en associant une valeur de type duration à celle-ci.

En savoir plus sur le duration type ici.

Utilisation du paramètre QueryTimeout.

Si vous souhaitez contrôler la durée d’attente avant d’abandonner une tentative d’exécution d’une requête, vous pouvez utiliser le QueryTimeout paramètre.

Ce paramètre ne peut être utilisé qu’à partir de l’éditeur avancé. Pour ce faire, le QueryTimeout paramètre doit être ajouté dans les options d’enregistrement, en associant une valeur de type number à celle-ci. Cette valeur numérique est représentée en millisecondes, par exemple 1 0000 est égale à 10s.

Utilisation du paramètre UserAgent.

Si vous souhaitez spécifier le nom de l’application cliente, vous pouvez utiliser le UserAgent paramètre.

Ce paramètre ne peut être utilisé qu’à partir de l’éditeur avancé. Pour ce faire, le UserAgent paramètre doit être ajouté dans les options d’enregistrement, en associant une valeur de type text.

Utilisation du paramètre Compression.

Il est recommandé d’activer ce paramètre lorsque l’application cliente et le serveur Denodo sont connectés via un wan. Dans ces cas, vous pouvez vous attendre à des améliorations significatives des performances lorsque l’application cliente lit des volumes de données modérés ou volumineux. Pour cela, vous pouvez utiliser le Compression paramètre.

Ce paramètre ne peut être utilisé qu’à partir de l’éditeur avancé. Pour ce faire, le Compression paramètre doit être ajouté dans les options d’enregistrement, en associant une valeur de type number (0 ou 1).

Résolution des problèmes

Le chargement de données lorsqu’un champ d’une vue Denodo a plus de 42 relations avec d’autres vues.

Si une vue Denodo importée en tant que source de données dans Power BI a plus de 42 relations avec d’autres vues, Power BI peut afficher l’erreur suivante lors de l’accès à la fenêtre de transformation de données :

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

Cette erreur est due à une limitation dans la plateforme Microsoft Power Query. Pour contourner ce problème, sélectionnez la source de données défaillante (requête) dans la fenêtre de transformation des données et accédez à l’éditeur avancé avec l’éditeuravancéd’affichage>. Modifiez ensuite l’expression de source de données dans la langue M en ajoutant la propriété suivante à l’argument options de l’appel Denodo.Contents de fonction :

CreateNavigationProperties=false

Votre appel ressemble donc à ce qui suit :

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

Cette propriété indique à Power BI de ne pas essayer et générer des propriétés de navigation à partir des relations inscrites pour la vue Denodo accessible dans cette source de données. Par conséquent, si vous avez besoin que certaines de ces relations soient réellement présentes dans votre modèle de données Power BI, vous devez les inscrire manuellement par la suite.