Base de données Oracle
Résumé
| Élément | Description |
|---|---|
| État de publication | Disponibilité générale |
| PRODUITS | Excel Power BI (Modèles sémantiques) Power BI (Dataflows) Fabric (Dataflow Gen2) Power Apps (Dataflows) Dynamics 365 Customer Insights Analysis Services |
| Types d'authentification pris en charge | Windows (bureau/en ligne) Base de données (bureau) Basique (en ligne) Compte Microsoft (bureau) |
| Documentation de référence sur la fonction | Oracle.Database |
Remarque
Certaines fonctionnalités peuvent être présentes dans un produit, mais pas dans d'autres en raison de planifications de déploiement et de fonctionnalités spécifiques à l'hôte.
Prérequis
Versions d’Oracle prises en charge :
- Serveur Oracle Database 12c (12.1.0.2) et versions ultérieures
- Oracle Autonomous Database - toutes les versions
Avant de pouvoir vous connecter à une base de données Oracle à l’aide de Power Query, vous devez installer le client Oracle for Microsoft Tools (OCMT).
Pour vous connecter à une base de données Oracle avec la passerelle de données locale, vous devez avoir installé le client OCMT 64 bits sur l’ordinateur exécutant la passerelle. Pour plus d’informations, consultez Gérer votre source de données – Oracle.
Fonctionnalités prises en charge
- Importer
- DirectQuery (pour les modèles sémantiques Power BI)
- Options avancées
- Délai de commande en minutes
- SQL statement
- Inclure des colonnes de relation
- Naviguer avec la hiérarchie complète
Téléchargez et installez Oracle Client for Microsoft Tools
Le client Oracle for Microsoft Tools installe et configure Oracle Data Provider for .NET (ODP.NET) pour prendre en charge les connexions d’outils Microsoft 32 bits et 64 bits avec des bases de données Oracle sur site et cloud, dont Oracle Autonomous Database (ADB). OCMT est un programme d’installation graphique qui automatise le processus de configuration du client Oracle Database. Il prend en charge la connexion avec Power BI Desktop, Power BI Service, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services et BizTalk Server.
OCMT est un logiciel libre. Il peut être téléchargé sur la page Oracle Client for Microsoft Tools. Pour Power BI Desktop 64 bits et Power BI Service 64 bits, utilisez OCMT 64 bits. Pour Power BI Desktop 32 bits, utilisez OCMT 32 bits.
Même si vous avez déjà installé un client Oracle ou ODP.NET sur votre client Power BI, il est fortement recommandé d’utiliser l’installateur OCMT pour accomplir correctement toutes les étapes de configuration requises par Power BI pour fonctionner avec une base de données Oracle.
- Téléchargement du client OCMT 64 bits et 32 bits
- Instructions d’installation et de configuration d’OCMT
Connexion à une base de données Oracle sur site depuis Power Query Desktop
Pour établir la connexion, effectuez les étapes suivantes :
Dans la sélection du connecteur, sélectionnez l’option Base de données Oracle.
Spécifiez le nom de service Oracle/TNS alias ou la chaîne de connexion Easy Connect (Plus) à laquelle vous souhaitez vous connecter dans Serveur. Easy Connect est la méthode la plus simple en définissant la valeur de Serveur sur le nom d’hôte/nom de service de votre serveur de base de données Oracle, où Nom de service est le nom de base de données globale. La capture d’écran suivante utilise un nom de service réseau.
Si vous vous connectez à partir de Power BI Desktop, sélectionnez le mode de Connectivité de données Importer ou DirectQuery. Le reste de ces exemples d’étapes utilisent le mode de connectivité des données d’importation. Pour en savoir plus sur DirectQuery, veuillez consulter Utilisation de DirectQuery dans Power BI Desktop.
Si vous vous connectez à cette base de données Oracle pour la première fois, sélectionnez le type d’authentification à utiliser, puis saisissez vos informations d’identification. Les types d’authentification disponibles sont les suivants :
- Windows (authentification Windows)
- Base de données (nom d’utilisateur et mot de passe)
- Compte Microsoft (Microsoft Entra ID)
Pour plus d’informations sur l’authentification, consultez Authentification avec une source de données.
Dans Navigateur, sélectionnez les données dont vous avez besoin, puis Charger pour charger les données, ou Transformer les données pour les transformer.
Connexion à une base de données Oracle sur site depuis Power Query en ligne
Pour établir la connexion, effectuez les étapes suivantes :
Depuis Power Query en ligne, sélectionnez l’option Base de données Oracle dans la sélection des sources de données.
Dans la boîte de dialogue Base de données Oracle qui s’affiche, spécifiez le nom de service Oracle/TNS alias, la chaîne de connexion Easy Connect Plus ou le descripteur de connexion auquel vous souhaitez vous connecter dans Serveur.
Indiquez un Nom de connexion, comme par exemple « testoracleserver ».
Sélectionnez le nom de votre passerelle de données locale.
Remarque
Vous devez sélectionner une passerelle de données locale pour ce connecteur, que la base de données Oracle se trouve sur votre réseau local ou sur un site web.
Si vous vous connectez à cette base de données Oracle pour la première fois, sélectionnez le type d’informations d’identification pour la connexion dans Type d’authentification. Choisissez Basique si vous prévoyez de vous connecter avec un nom d’utilisateur et un mot de passe Oracle. Choisissez Windows lors de l’utilisation de l’authentification du système d’exploitation Windows et avec le client Et le serveur Oracle s’exécutant sur Windows.
Entrez vos informations d’identification.
Sélectionnez Suivant pour continuer.
Dans Navigateur, choisissez les données dont vous avez besoin, puis sélectionnez Transformer les données pour transformer les données dans l’Éditeur Power Query.
Se connecter à une Base de données autonome Oracle
Remarque
Actuellement, vous pouvez vous connecter à une base de données Oracle Autonomous à partir d’Excel, Power BI Desktop, Power BI Service, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services et BizTalk Server en utilisant les procédures de cette section. Ces outils utilisent des ODP.NET non managés pour se connecter. D’autres outils Microsoft, y compris SQL Server Data Tools, SQL Server Integration Services et SQL Server Reporting Services, utilisent ODP.NET géré pour se connecter à Oracle Autonomous Database en suivant des procédures largement similaires.
Pour connecter Power BI à une base de données Oracle Autonomous, vous avez besoin des comptes et des applications suivants :
- Un compte Oracle.com (Inscription au compte Oracle.com)
- Un compte Oracle Cloud (Inscription au compte Oracle Cloud)
- Une base de données Oracle Autonomous (Obtenez une base de données autonome « Always Free» (toujours gratuite))
- Power BI Desktop (Obtenir Power BI Desktop) ou un compte service Power BI (Licenciation du service Power BI pour les utilisateurs de votre organisation)
- Passerelle de données locale si vous utilisez le service Power BI (Téléchargez et installez une passerelle standard)
Télécharger vos informations d’identification client
La première étape de configuration d’une connexion à la Base de données autonome Oracle consiste à télécharger vos informations d’identification client.
Pour télécharger vos informations d’identification client :
Dans la page des détails de votre Base de données autonome Oracle, sélectionnez Connexion à la base de données.
Dans la page Connexion à la base de données, sélectionnez Télécharger le portefeuille.
Entrez le mot de passe que vous souhaitez utiliser avec ce portefeuille, confirmez-le, puis sélectionnez Télécharger.
Configurer les informations d’identification Oracle ADB
Sur votre ordinateur Windows, accédez au dossier dans lequel vous avez téléchargé vos informations d’identification Oracle ADB à partir de Télécharger vos informations d’identification client.
Décompressez les informations d’identification dans le répertoire que vous avez spécifié dans OCMT en tant que Répertoire du fichier de configuration Oracle. Dans cet exemple, les informations d’identification sont extraites dans le dossier c:\data\wallet\wallet_contosomart.
Remarque
Le fichier tnsnames.ora définit l’adresse de votre base de données autonome Oracle et les informations de connexion.
Ouvrez sqlnet.ora dans un éditeur, tel que le Bloc-notes.
Sous WALLET_LOCATION, sous l’option Répertoire, modifiez le chemin d’accès au dossier de votre portefeuille. Dans cet exemple :
WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))Enregistrez et fermez le fichier sqlnet.ora.
Ouvrez le fichier tnsnames.ora dans le dossier des portefeuilles. Le fichier contient une liste de noms de services ADB net auxquels vous pouvez vous connecter. Dans cet exemple, les noms sont contosomart_high, contosomart_low et contosomart_medium. Les noms de vos services ADB net sont différents.
Connexion de Power BI Desktop à Oracle ADB
Ouvrez Power BI Desktop.
Sélectionnez Obtenir des données.
Dans Obtenir les données, sélectionnez Base de données>Base de données Oracle.
Saisissez le nom de service net du serveur de base de données autonome Oracle auquel vous souhaitez vous connecter. Dans cet exemple, le Serveur est contosomart_high. Sélectionnez ensuite OK.
Si vous vous connectez à ce serveur à partir de Power BI Desktop pour la première fois, vous êtes invité à saisir vos informations d’identification. Sélectionnez Base de données, puis entrez les nom d’utilisateur et mot de passe de la base de données Oracle. Les informations d’identification que vous entrez ici sont le nom d’utilisateur et le mot de passe de la Base de données autonome Oracle spécifique à laquelle vous souhaitez vous connecter. Dans cet exemple, les nom d’utilisateur et mot de passe de l’administrateur initial de la base de données sont utilisés. Sélectionnez Connecter.
Remarque
Vous pouvez utiliser l’authentification Microsoft Entra ID pour vous connecter à Oracle Autonomous Database via l’option Compte Microsoft.
À ce stade, le Navigateur s’affiche, montrant les données de connexion.
Il se peut que vous rencontriez des erreurs indiquant que la configuration n’est pas correcte. Ces erreurs sont abordées dans Résolution des problèmes.
Une erreur susceptible de se produire pendant ce test initial apparaît dans le Navigateur, où la base de données semble être connectée, mais ne contient aucune donnée. Au lieu de cela, une erreur « Oracle: ORA-28759: failure to open file » s’affiche à la place des données.
Si cette erreur se produit, assurez-vous que le chemin du dossier de portefeuille que vous avez fourni dans sqlnet.ora est complet et correct.
Configurer la passerelle
Dans le service Power BI, dans l’angle supérieur droit, sélectionnez l’icône d’engrenage, puis Gérer les passerelles.
Dans Ajouter une source de données, sélectionnez Ajouter des sources de données pour utiliser la passerelle.
Dans Nom de la source de données, entrez le nom que vous souhaitez utiliser comme paramètre de source de données.
Dans Type de source de données, sélectionnez Oracle.
Dans Serveur, saisissez le nom de service net du serveur de base de données autonome Oracle auquel vous souhaitez vous connecter.
Dans Méthode d’authentification, sélectionnez De base.
Entrez les nom d’utilisateur et mot de passe pour la Base de données autonome Oracle. Dans cet exemple, le nom d’utilisateur par défaut de l’administrateur de base de données (ADMIN) et le mot de passe sont utilisés.
Sélectionnez Ajouter.
Si tout a été installé et configuré correctement, le message Connexion réussie s’affiche. Vous pouvez maintenant vous connecter à la base de données autonome Oracle en suivant les mêmes étapes décrites dans Connexion à une base de données Oracle sur site depuis Power Query en ligne.
Se connecter à l’aide d’options avancées
Power Query Desktop et Power Query Online fournissent un ensemble d’options avancées que vous pouvez ajouter à votre requête si nécessaire.
Le tableau suivant répertorie toutes les options avancées que vous pouvez définir dans Power Query Desktop et Power Query Online.
| Option avancée | Description |
|---|---|
| Délai de commande en minutes | Si votre connexion dure plus de 10 minutes (délai d’expiration par défaut), vous pouvez entrer une autre valeur en minutes pour garder la connexion ouverte plus longtemps. Cette option n’est disponible que dans Power Query Desktop. |
| Instruction SQL | Pour plus d’informations, consultez Importer des données à partir d’une base de données à l’aide d’une requête de base de données native. |
| Inclure des colonnes de relation | Si cette option est activée, elle inclut des colonnes qui peuvent avoir des relations avec d’autres tables. Si cette case est désactivée, ces colonnes n’apparaissent pas. |
| Naviguer avec la hiérarchie complète | Si cette option est activée, le navigateur affiche la hiérarchie complète des tables dans la base de données à laquelle vous vous connectez. Si elle est désactivée, le navigateur affiche uniquement les tables dont les colonnes et les lignes contiennent des données. |
Une fois que vous avez sélectionné les options avancées dont vous avez besoin, sélectionnez OK dans Power Query Desktop ou Suivant dans Power Query Online pour vous connecter à votre base de données Oracle.
Problèmes connus et limitations
Les sessions Power BI peuvent rester actives sur votre Oracle Database pendant environ 30 minutes après l’actualisation d’un modèle sémantique sur Oracle Database. Ces sessions ne deviennent inactives/supprimées sur la base de données Oracle qu’après environ 30 minutes. Ce comportement est normal.
Dépannage
Vous pourriez rencontrer l’une des erreurs suivantes dans Oracle quand la syntaxe de dénomination est incorrecte ou n’est pas configurée correctement :
- ORA-12154: TNS: could not resolve the connect identifier specified (ORA-12154 : TNS : l’identificateur de connexion indiqué n’a pas pu être résolu).
- ORA-12514: TNS listener does not currently know of service requested in connect descriptor (ORA-12514 : le processus d’écoute ne connaît pas actuellement le service demandé dans le descripteur de connexion).
- ORA-12541: TNS: no listener (ORA-12541 : TNS : pas de processus d’écoute).
- ORA-12170: TNS: Connect timeout occurred (ORA-12170 : TNS : une expiration de la connexion s’est produite).
- ORA-12504: TNS listener was not given the SERVICE_NAME in CONNECT_DATA (ORA-12504 : le processus d’écoute n’a pas reçu SERVICE_NAME dans CONNECT_DATA).
Ces erreurs peuvent survenir si le descripteur de connexion à la base de données Oracle tnsnames.ora est mal configuré, si le nom du service réseau fourni est mal orthographié, ou si l’écouteur de la base de données Oracle ne fonctionne pas ou n’est pas accessible, par exemple si un pare-feu bloque l’écouteur ou le port de la base de données. Assurez-vous de respecter les exigences minimales d’installation. Pour plus d’informations : Conditions préalables requises
Visitez le portail d’aide sur les erreurs Oracle Database pour passer en revue les causes et résolutions courantes de l’erreur Oracle que vous rencontrez. Entrez votre erreur Oracle dans la barre de recherche du portail.
Si vous avez téléchargé Power BI Desktop à partir de Microsoft Store, il se peut que vous ne puissiez pas vous connecter aux bases de données Oracle en raison d’un problème de pilote Oracle. Si vous rencontrez ce problème, le message d’erreur renvoyé est : Référence d’objet non définie. Pour résoudre le problème, effectuez les actions suivantes :
- Téléchargez Power BI Desktop depuis le Centre de téléchargement au lieu de Microsoft Store.
Si vous voyez le message d’erreur Référence d’objet non définie dans Power BI Gateway quand vous vous connectez à une base de données Oracle à l’aide de la passerelle de données locale, suivez les instructions fournies dans Gérer votre source de données - Oracle.
Si vous utilisez Power BI Report Server, consultez les instructions de l’article Type de connexion Oracle.
Étapes suivantes
Optimiser Power Query lors du développement des colonnes de table