Type de connexion Oracle (Générateur de rapports Power BI)

S’APPLIQUE À : Power BI Report Builder Power BI Desktop

Pour utiliser des données d'une base de données Oracle dans votre rapport, vous devez avoir un dataset basé sur une source de données de rapport de type Oracle. Ce type de source de données intégré utilise directement le fournisseur de données Oracle et requiert un composant logiciel client Oracle. Cet article explique comment télécharger et installer les pilotes pour le générateur de rapports Power BI.

Pilotes 32 bits pour le générateur de rapports Power BI

Power BI Report Builder utilise ODP.NET managé pour la création de rapports paginés (RDL). Les étapes suivantes ne sont nécessaires que si vous utilisez des pilotes Oracle ODAC 12.2 et ultérieur. Sinon, ils sont installés par défaut dans une configuration qui n’est pas appliquée à l’échelle de la machine pour une nouvelle installation de base d’Oracle. Ces étapes supposent que vous avez installé les fichiers ODAC 18.x dans le dossier c:\oracle32 où le générateur de rapports Power BI est installé. Pour inscrire ODP.NET managé, effectuez les étapes suivantes :

1. Sur le site de téléchargement d’Oracle, installez « ODAC with Oracle Developer Tools for Visual Studio - OUI » d’Oracle (32 bits).

2. Inscrivez le client managé ODP.NET dans GAC :

   C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

3. Ajoutez les entrées du client managé ODP.NET à machine.config :

   C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

Pilotes 64 bits pour Power BI Report Builder

Power BI Report Builder utilise ODP.NET managé pour la création de rapports paginés (RDL). Les étapes suivantes ne sont nécessaires que si vous utilisez des pilotes Oracle ODAC 12.2 et ultérieur. Sinon, ils sont installés par défaut dans une configuration qui n’est pas appliquée à l’échelle de la machine pour une nouvelle installation de base d’Oracle. Ces étapes partent du principe que vous avez installé les fichiers ODAC 18.x dans le dossier c:\oracle64 où Power BI Report Builder est installé. Pour inscrire ODP.NET managé, effectuez les étapes suivantes :

1. Sur le site de téléchargement Oracle, installez le programme d'installation Oracle 64 bits ODAC Oracle (OUI).

2. Inscrivez le client managé ODP.NET dans GAC :

   C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

3. Ajoutez les entrées du client managé ODP.NET à machine.config :

   C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
   

Connection string

Contactez l'administrateur de votre base de données pour connaître les informations de connexion et d'identification à utiliser pour se connecter à la source de données. L'exemple de chaîne de connexion suivant spécifie une base de données Oracle sur le serveur nommé « Oracle18 » utilisant Unicode. Le nom du serveur doit correspondre à ce qui est défini dans le fichier de configuration Tnsnames.ora comme nom d'instance de serveur Oracle.

Data Source="Oracle18"; Unicode="True"  

Pour obtenir d’autres exemples sur les chaînes de connexion, consultez Créer des chaînes de connexion de données - Générateur de rapports Power BI.

Informations d’identification

Les informations d'identification sont obligatoires pour exécuter des requêtes, afficher l'aperçu du rapport localement et afficher l'aperçu du rapport sur le portail web Power BI.

Après avoir publié votre rapport, vous pouvez avoir besoin de le lier à une connexion Power BI Gateway. Pour plus d’informations, consultez Gérer votre source de données : Oracle

Requêtes

Pour créer un dataset, vous pouvez soit sélectionner une procédure stockée dans une liste déroulante, soit créer une requête SQL. Pour générer une requête, vous devez utiliser le concepteur de requêtes textuel. Pour plus d’informations, consultez Interface utilisateur du concepteur de requêtes relationnelles (Générateur de rapport Power BI).

Vous pouvez spécifier des procédures stockées qui ne retournent qu'un seul jeu de résultats. L'utilisation des requêtes basées sur curseur n'est pas prise en charge.

Paramètres

Si la requête inclut des variables de requête, les paramètres de rapport sont générés automatiquement. Les paramètres nommés sont pris en charge par cette extension. Pour la version 9 ou ultérieure d'Oracle, les paramètres à valeurs multiples sont pris en charge.

Les paramètres de rapport sont créés avec des valeurs de propriétés par défaut que vous devrez peut-être modifier. Par exemple, chaque paramètre de rapport a le type de données Texte. Après avoir créé les paramètres de rapport, vous devrez peut-être modifier les valeurs par défaut.

Considérations et limitations

Avant de pouvoir connecter une source de données Oracle, l'administrateur système doit installer au préalable la version du fournisseur de données .NET pour Oracle qui prend en charge la récupération des données à partir de la base de données Oracle. Ce fournisseur de données doit être installé sur le même ordinateur que le Générateur de rapports Power BI et sur l’ordinateur hébergeant Power BI Gateway. Pour plus d’informations, consultez Gérer votre source de données : Oracle.

Solution de contournement pour appeler des procédures stockées

Lorsque vous utilisez une source de données Oracle, si le type de requête du rapport paginé est défini en tant que procédure stockée, il ne parvient pas à s’exécuter dans le service Power BI en raison d’une limitation de Power BI Gateway. Pour contourner ce problème, si vous utilisez Oracle 12 ou version ultérieure, définissez le type de requête sur texte et appelez la procédure stockée en ligne, comme dans l’exemple suivant.

DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
   SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
   DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;

Informations sur les plateformes et les versions

Pour plus d’informations sur la prise en charge de la plateforme et des versions, consultez Sources de données prises en charge pour les rapports paginés Power BI.

Contenu connexe

• Gérer votre source de données - Oracle
• Filtrer, regrouper et trier des données (Générateur de rapports Power BI)
• Expressions (Power BI Report Builder)