Oracle Database

Résumé

Élément	Descriptif
État de publication	Disponibilité générale
Produits	Excel Power BI (modèles sémantiques) Power BI (flux de données) Fabric (Flux de données Gen2) Power Apps (Flux de données) Dynamics 365 Customer Insights Services d'analyse
Types d’authentification pris en charge	Windows (bureau/en ligne) Base de données (poste de travail) De base (en ligne) Compte Microsoft (bureau)
Documentation de référence sur les fonctions	Oracle.Database

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

Versions d’Oracle prises en charge :

• Oracle Database Server 12c (12.1.0.2) et versions ultérieures
• Oracle Autonomous Database - toutes les versions

À compter de la version d’avril 2025 de Power BI Desktop et de la version de mai 2025 de la passerelle de données locale, vous pouvez utiliser le pilote ODP managé Oracle intégré.NET pour vous connecter à la base de données Oracle. Lorsque vous activez cette fonctionnalité, vous n’avez pas besoin d’installer l’outil OCMT manuellement. À compter de juin 2026, vous pouvez également créer une connexion cloud à Oracle Autonomous Database ou à d’autres points de terminaison cloud Oracle sans passerelle. En savoir plus sur cette fonctionnalité.

Si vous n'utilisez pas le nouveau pilote Oracle intégré, vous devez utiliser une passerelle de données locale d'entreprise et installer le client Oracle 64 bits pour Microsoft Tools (OCMT) sur l'ordinateur exécutant la passerelle ou Power BI Desktop. Pour plus d’informations, consultez Gérer votre source de données : Oracle.

Fonctionnalités prises en charge

• Importer
• DirectQuery (modèles sémantiques Power BI)
• Options avancées
  • Délai d’expiration de la commande en minutes
  • Instruction SQL
  • Inclure des colonnes de relation
  • Naviguer à l’aide de la hiérarchie complète

Utilisation de l’option Client Oracle pour Microsoft Tools (OCMT)

Le client Oracle pour Microsoft Tools installe et configure le fournisseur de données Oracle pour .NET (ODP.NET) pour prendre en charge les connexions d’outils Microsoft 32 bits et 64 bits avec des bases de données Oracle locales et cloud, notamment 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, le service Power BI, 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 gratuit. Il peut être téléchargé à partir de la page Oracle Client for Microsoft Tools. Pour Power BI Desktop 64 bits et le service Power BI, utilisez OCMT 64 bits. Pour Power BI Desktop 32 bits, utilisez OCMT 32 bits.

Même si vous disposez déjà d’un client Oracle ou d’un ODP.NET installé sur votre client Power BI, nous vous recommandons vivement d’utiliser le programme d’installation OCMT pour effectuer correctement toutes les étapes de configuration requises par Power BI pour utiliser la base de données Oracle.

• Téléchargements OCMT 64 bits et 32 bits
• Instructions d’installation et d’installation d’OCMT

Se connecter à une base de données Oracle locale à partir de Power BI Desktop

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

1. Sélectionnez l’option de base de données Oracle dans la sélection du connecteur.

2. Spécifiez le nom/alias TNS Oracle Net Services ou la chaîne de connexion Easy Connect (Plus) à laquelle vous connecter dans Serveur. Easy Connect est le plus simple à utiliser en définissant la valeur du serveur sur votre nom d’hôte de serveur Oracle Database/ServiceName, où ServiceName est le nom de base de données global. La capture d’écran suivante utilise un nom de service net.

   

3. Si vous vous connectez à partir de Power BI Desktop, sélectionnez le mode de connectivité des 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, accédez à Utiliser DirectQuery dans Power BI Desktop.

4. Si vous vous connectez à cette base de données Oracle pour la première fois, sélectionnez le type d’authentification que vous souhaitez utiliser, puis entrez 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 (ID Microsoft Entra)

   Pour plus d’informations sur l’authentification, accédez à Authentification avec une source de données.

   

5. Dans navigateur, sélectionnez les données dont vous avez besoin, puis sélectionnez Charger pour charger les données ou transformer des données pour transformer les données.

Se connecter à une base de données Oracle locale à partir de Power Query Online

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

1. Installez et configurez une passerelle de données locale.

2. Dans Power Query Online, sélectionnez l’option de base de données Oracle dans la sélection des sources de données.

3. Dans la boîte de dialogue Base de données Oracle qui s’affiche, spécifiez le nom/alias TNS Oracle Net Services, la chaîne de connexion Easy Connect Plus ou le descripteur de connexion auquel vous connecter dans Serveur.

   

4. Fournissez un nom de connexion, tel que « testoracleserver ».

5. Sélectionnez le nom de votre passerelle de données locale.

6. Si vous vous connectez à cette base de données Oracle pour la première fois, sélectionnez le type d’informations d’identification de la connexion dans le type d’authentification. Choisissez Basic si vous envisagez 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.

7. Entrez vos informations d’identification.

8. Sélectionnez Suivant pour continuer.

9. 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 autonome à partir d’Excel, power BI Desktop, service Power BI, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services et BizTalk Server à l’aide des procédures décrites dans cette section. Ces outils utilisent des ODP.NET non managés pour se connecter. D’autres outils Microsoft, notamment SQL Server Data Tools, SQL Server Integration Services et SQL Server Reporting Services, utilisent des ODP.NET managés pour se connecter à Oracle Autonomous Database à l’aide de procédures similaires.

Pour connecter Power BI à une base de données autonome Oracle, vous avez besoin des comptes et 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 autonome Oracle (Obtenez une base de données autonome Always Free)
• Power BI Desktop (Obtenir Power BI Desktop) ou un compte de service Power BI (Licences du service Power BI pour les utilisateurs de votre organisation)

Télécharger les informations d’identification de votre client

La première étape de la configuration d’une connexion à la base de données Oracle Autonomous consiste à télécharger vos informations d’identification client.

Pour télécharger les informations d’identification de votre client :

1. Dans la page détails de votre base de données Oracle Autonomous, sélectionnez Connexion de base de données.

   

2. Dans la page Connexion de base de données , sélectionnez Télécharger le portefeuille.

   

3. Entrez un mot de passe que vous souhaitez utiliser avec ce portefeuille, confirmez le mot de passe, puis sélectionnez Télécharger.

   

Configurer les informations d’identification Oracle ADB

1. Sur votre ordinateur Windows, accédez au dossier dans lequel vous avez téléchargé vos informations d’identification Oracle ADB à partir du téléchargement de vos informations d’identification client.

2. Décompressez les informations d’identification dans le répertoire que vous avez spécifié dans OCMT en tant que répertoire de fichiers de configuration Oracle. Dans cet exemple, les informations d’identification sont extraites dans c :\data\wallet\wallet_contosomart.

   

   Remarque

   Le fichier tnsnames.ora définit l'adresse et les informations de connexion de votre Oracle Autonomous Database.

3. Ouvrez sqlnet.ora dans un éditeur, tel que le Bloc-notes.

4. Sous WALLET_LOCATION, modifiez le chemin d’accès à votre dossier portefeuille sous l’option Répertoire. Dans cet exemple :

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

5. Enregistrez et fermez le fichier sqlnet.ora.

Ouvrez le fichier tnsnames.ora dans le dossier portefeuilles. Le fichier contient une liste des noms de service net ADB auxquels vous pouvez vous connecter. Dans cet exemple, les noms sont contosomart_high, contosomart_low et contosomart_medium. Vos noms de service net ADB sont différents.

Connecter Power BI Desktop à Oracle ADB

1. Ouvrez Power BI Desktop.

2. Sélectionnez Obtenir les données.

3. Dans Obtenir des données, sélectionnez Base de données>Base de données Oracle.

4. Entrez le nom du service net du serveur Oracle Autonomous Database auquel vous souhaitez vous connecter. Dans cet exemple, le serveur est contosomart_high. Sélectionnez ensuite OK.

   

5. Si vous vous connectez à ce serveur à partir de Power BI Desktop pour la première fois, vous êtes invité à entrer vos informations d’identification. Sélectionnez Base de données, puis entrez le nom d’utilisateur et le 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 oracle autonome spécifique à laquelle vous souhaitez vous connecter. Dans cet exemple, le nom d’utilisateur et le mot de passe d’administrateur initial de la base de données sont utilisés. Sélectionnez ensuite Se connecter.

   

   Remarque

   Vous pouvez utiliser l’authentification Microsoft Entra ID pour vous connecter à Oracle Autonomous Database via l’option de compte Microsoft .

À ce stade, le navigateur s’affiche et affiche les données de connexion.

Vous pouvez également rencontrer l’une des erreurs, car la configuration n’est pas correctement configurée. Ces erreurs sont abordées dans la résolution des problèmes.

Une erreur qui peut se produire dans ce test initial se produit dans Navigator, 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 apparaît à la place des données.

Si cette erreur se produit, assurez-vous que le chemin d’accès au dossier de portefeuille que vous avez fourni dans sqlnet.ora est le chemin complet et correct du dossier portefeuille.

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	Descriptif
Délai d’expiration de la 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 que la connexion reste ouverte plus longtemps. Cette option est disponible uniquement 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 zone est désactivée, ces colonnes n’apparaissent pas.
Naviguer à l’aide de la hiérarchie complète	Si cette option est cochée, le navigateur affiche la hiérarchie complète des tables dans la base de données à laquelle vous vous connectez. S’il est effacé, 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.

Utiliser le pilote Oracle intégré

Pour le mode Importation dans Power BI Desktop

Pour la version de juin 2026 de Power BI Desktop ou de la passerelle de données locale, le comportement par défaut est d’utiliser un pilote ODP.NET géré Oracle intégré pour la connexion. Cette fonctionnalité supprime la nécessité pour les utilisateurs d’installer et de gérer le pilote. Vous pouvez toujours refuser cette fonctionnalité à l’aide des instructions suivantes.

Pour ne pas utiliser ce pilote intégré dans Power BI Desktop, accédez à Options et paramètres (sous l’onglet Fichier) >Options>Fonctionnalités en préversion, puis décochez la case de l’option Activer l’utilisation du fournisseur ODP géré Oracle inclus pour le mode Importation.

Pour le mode DirectQuery dans Power BI Desktop (préversion)

En mode DirectQuery, l’utilisation du pilote ODP.NET Oracle managé intégré est encore en préversion. Pour vous inscrire, suivez les instructions suivantes.

Pour utiliser ce pilote intégré dans Power BI Desktop, accédez à Options et paramètres (sous l’onglet Fichier) >Options>Fonctionnalités en préversion, puis décochez la case correspondant à l’option Activer l’utilisation du fournisseur ODP géré Oracle intégré pour le mode DirectQuery.

Pour le mode Importation dans la passerelle locale

À compter de la version de juin 2026, la passerelle de données locale utilise par défaut le pilote ODP.NET managé Oracle intégré pour la connectivité. Pour ne pas utiliser ce pilote intégré dans la passerelle de données locale pour le mode Importation, modifiez les configurations de passerelle pour mettre à jour le MashupFlight_DisableOracleBundledOdacProviderV2 paramètre en procédant comme suit :

1. Sur l’ordinateur local sur lequel la passerelle de données locale est installée, accédez à C :\Program Files\On-premises Data Gateway.
2. Effectuez une sauvegarde du fichier de configuration nommé Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Ouvrez le fichier de configuration Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config d’origine et recherchez l’entrée MashupFlight_DisableOracleBundledOdacProviderV2.
4. Mettez à jour la MashupFlight_DisableOracleBundledOdacProviderV2 valeur sur True.
5. Redémarrez votre passerelle.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Remarque

Une fois que vous avez modifié le MashupFlight_DisableOracleBundledOdacProviderV2 paramètre dans le fichier Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, la configuration persiste sur les mises à niveau de passerelle de données locales.

Remarque

Si vos modèles sémantiques utilisent toujours une passerelle personnelle pour se connecter à des sources de données Oracle locales, effectuez une mise à niveau vers une passerelle de données locale d’entreprise ou une passerelle de réseau virtuel (VNET), ou déplacez vos charges de travail Oracle cloud vers des connexions cloud directes. Le connecteur Oracle mis à jour ne prend pas en charge les passerelles de données locales personnelles, cela s’applique à la fois au mode Importation et directQuery. Les modèles sémantiques existants peuvent continuer à utiliser une passerelle personnelle jusqu’à ce que vous mettez à jour la liaison de connexion de données. Après avoir mis à jour la liaison, vous ne pouvez pas revenir à la passerelle personnelle. Planifiez vos mises à niveau de connexion Oracle en conséquence.

Pour le mode DirectQuery dans la passerelle de données locale (préversion)

La passerelle de données locale peut utiliser le pilote ODP.NET Oracle managé intégré pour DirectQuery. Cette fonctionnalité est en version préliminaire.

Pour résoudre un alias TNS pour DirectQuery, utilisez une variable d’environnement. Le compte de service de la passerelle ne peut pas accéder aux variables définies au niveau de l’utilisateur. Définissez donc TNS_ADMIN au niveau du système (ordinateur), puis redémarrez le service de passerelle de données locale.

Le pilote intégré ne prend pas en charge l’authentification d’utilisateur proxy Oracle. Pour plus d’informations et de solutions de contournement, consultez l’authentification de l’utilisateur proxy Oracle n’est pas prise en charge.

Méthodes prises en charge pour spécifier TNS_ADMIN avec le pilote Oracle intégré

Il existe trois options pour spécifier TNS_ADMIN :

• Configurer la TNS_ADMIN dans OADC.config
• Utiliser une variable d’environnement
• Utiliser les paramètres d’un OADC précédemment installé

Configurer TNS_ADMIN dans ODAC.config

Si vous utilisez le pilote Oracle intégré et que vous avez accès à modifier des fichiers programme, vous pouvez spécifier TNS_ADMIN dans le fichier de configuration ODAC.config utilisé par le pilote Oracle intégré. Le fichier est situé dans l'emplacement d'installation de Power BI Desktop ou de la passerelle de données locale, sous le sous-dossier « ADO.NET Providers ». Voici un exemple de spécification de chemin d’accès TNS_ADMIN « C :\network\admin ».

Cette valeur de configuration est prioritaire sur d’autres options.

Exemple de configuration

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

Notez que TNS_ADMIN configuré dans le ODAC.config est prioritaire sur un paramètre de TNS_ADMIN dans l’environnement.

Utiliser une variable d’environnement

Si l’utilisateur n’a pas accès à modifier ODAC.config, il peut spécifier TNS_ADMIN en ajoutant une variable d’environnement TNS_ADMIN. La variable d’environnement peut être une variable d’environnement système ou une variable d’environnement utilisateur pour l’utilisateur exécutant Power BI Desktop ou la passerelle de données locale. Définissez la valeur TNS_ADMIN sur « C :\network\admin », par exemple.

La définition de TNS_ADMIN dans l’environnement (en particulier au niveau du système) peut entraîner l’exécution d’autres applications sur cet ordinateur pour récupérer les fichiers de configuration réseau (tels que tnsnames.ora) à partir de l’emplacement vers lequel pointe TNS_ADMIN.

Utiliser les paramètres d’un ODAC précédemment installé

Si ODAC est installé précédemment et que TNS_ADMIN est configuré, Power BI découvre automatiquement TNS_ADMIN.

Les configurations restantes à connecter à une base de données Oracle à partir de Power Query Desktop sont les mêmes que celles décrites dans les sections précédentes.

Liste des propriétés autorisées

Les utilisateurs peuvent spécifier des noms de serveur Oracle à l’aide de descripteurs de connexion tels que (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). Le système applique les propriétés qui peuvent être utilisées dans Desktop et Gateway. Les propriétés autorisées ODAC.config par défaut sont répertoriées dans la section suivante.

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

Les utilisateurs peuvent modifier cette liste de propriétés autorisée s’ils doivent ajouter de nouvelles propriétés ou supprimer des propriétés de la liste pour appliquer des règles plus strictes.

Remarque

Limitations importantes

• L’utilisation du pilote ODP.NET managé Oracle intégré pour DirectQuery est en version préliminaire. Pour plus d’informations, consultez les sections DirectQuery précédentes.
• Le fichier ODAC.config peut nécessiter des droits d’administrateur pour modifier et l’application Power BI Store n’autorise pas la modification de ce fichier.
• Les modifications apportées à ODAC.config sont remplacées pendant la mise à niveau et vous devez enregistrer le fichier à un autre emplacement avant la mise à niveau.
• Pour que la passerelle de données locale fonctionne correctement, assurez-vous que l’utilisateur sous lequel le service de passerelle s’exécute a accès au dossier vers lequel pointe TNS_ADMIN.
• Redémarrez Power BI Desktop ou le service de passerelle de données locale après avoir appliqué les modifications de configuration.

Limitations et considérations

Les sessions Power BI peuvent toujours être actives sur votre base de données Oracle pendant environ 30 minutes après l’actualisation d’un modèle sémantique sur cette base de données Oracle. Seulement après environ 30 minutes, ces sessions deviennent inactives/supprimées sur la base de données Oracle. Ce comportement est voulu.

Résolution des problèmes

Vous pouvez rencontrer l’une des erreurs d’Oracle lorsque la syntaxe d’affectation de noms est incorrecte ou non configurée correctement :

• ORA-12154: TNS: could not resolve the connect identifier specified.
• ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
• ORA-12541: TNS: no listener.
• ORA-12170: TNS: connect timeout occurred.
• ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

Ces erreurs peuvent se produire si le descripteur de connexion de base de données Oracle tnsnames.ora est mal configuré, que le nom du service net fourni est mal orthographié ou que l’écouteur de base de données Oracle n’est pas en cours d’exécution ou n’est pas accessible, tel qu’un pare-feu bloquant l’écouteur ou le port de base de données. Vérifiez que vous respectez les conditions préalables minimales d’installation. Pour plus d’informations : Conditions préalables requises

Visitez le portail d’aide sur les erreurs de base de données Oracle 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.

Lorsque vous utilisez DirectQuery via la passerelle de données locale avec le pilote Oracle intégré, des erreurs telles que les suivantes peuvent indiquer qu’un alias TNS ne peut pas être résolu :

• ORA-12154: TNS name resolution failure
• ORA-50201: Failed to connect to server

Si vous rencontrez ces erreurs, vérifiez que TNS_ADMIN est défini dans la portée système (ordinateur) et que le compte de service de la passerelle peut accéder au dossier vers lequel il pointe, puis redémarrez le service de passerelle de données locale. Pour plus d’informations, consultez les méthodes prises en charge pour spécifier TNS_ADMIN avec le pilote Oracle intégré et le guide de résolution des problèmes d’Oracle Net Services .

Problèmes connus avec le pilote Oracle intégré

Les problèmes connus suivants sont spécifiques au pilote ODP managé Oracle intégré.NET. Plusieurs solutions de contournement reviennent au pilote ODP.NET non géré en désactivant le pilote intégré. Pour connaître les étapes de désactivation de chaque surface( Power BI Desktop Import et DirectQuery, et l’importation de passerelle et DirectQuery), consultez Utiliser le pilote Oracle intégré.

Les alias TNS sur un partage réseau ne sont pas résolus

S’applique à la passerelle de données locale, dans Import et DirectQuery.

Lorsque vos fichiers de configuration réseau Oracle (tnsnames.ora ou le TNS_ADMIN répertoire) sont stockés sur un partage réseau (chemin UNC), le pilote intégré échoue constamment à résoudre le nom du service net (alias TNS). Vous pouvez voir ORA-12154: TNS:could not resolve the connect identifier specified ou ORA-50201: Failed to connect to server. Le même alias se résout correctement avec odP.NET pilote non managé ou lorsque les fichiers se trouvent sur un chemin d’accès local. Le pilote managé intégré ne lit pas de manière fiable les fichiers de configuration réseau Oracle à partir d’un emplacement UNC.

Utilisez l’une des solutions de contournement suivantes :

• Copiez tnsnames.ora (et sqlnet.ora si vous l’utilisez) dans un dossier sur un lecteur local, puis pointez le pilote sur ce dossier. Consultez les méthodes prises en charge pour spécifier TNS_ADMIN avec le pilote Oracle intégré. Pour la passerelle DirectQuery, définissez TNS_ADMIN l’étendue du système (machine), car le compte de service de passerelle ne peut pas lire les variables délimitées par l’utilisateur, puis redémarrer le service de passerelle.
• Vérifiez que le compte de service exécutant la passerelle a accès au partage réseau.
• Entrez un descripteur Easy Connect directement dans le serveur (par exemple, ) au lieu d’un tnsnames.ora alias. Par conséquent, host:port/service_nameaucun fichier de configuration réseau n’est nécessaire.
• Désactivez le pilote intégré pour revenir au pilote ODP.NET pilote non managé, qui peut lire les fichiers à partir du partage.

NLS_LANG est ignoré

S’applique à Power BI Desktop, à la passerelle de données locale et aux connexions cloud service Power BI, dans Import et DirectQuery.

Avec le pilote intégré, le langage de session Oracle, le territoire et les formats de nombre et de date suivent la culture .NET de l'ordinateur (Windows paramètres régionaux et de format), et non la NLS_LANG variable d'environnement. La définition ou la modification NLS_LANG n’a aucun effet. Selon la région de l’ordinateur, ce comportement peut entraîner l’analyse des nombres ou des dates avec les séparateurs ou l’ordre de date incorrects, les requêtes retournent zéro ligne ou valeurs incorrectes, ou des erreurs telles que ORA-01722, ORA-01858ORA-01861ou ORA-01843. Par exemple, un rapport créé sur un ordinateur défini sur l’anglais (États-Unis) peut renvoyer zéro ligne ou erreur sur un ordinateur défini sur l’anglais (Royaume-Uni). Le pilote ODP.NET managé dérive ses paramètres nlS (National Language Support) de la culture de thread .NET plutôt que de NLS_LANG, contrairement au pilote ODP.NET non managé, qui respecte NLS_LANG.

Utilisez l’une des solutions de contournement suivantes :

• Mettre en correspondance les paramètres régionaux de l’ordinateur avec les paramètres régionaux auxquels vos données et requêtes ont été conçues.
• Désactivez le pilote intégré pour revenir à l’ODP.NET pilote non géré, qui honore NLS_LANG.

Pour plus d’informations sur le comportement de globalisation du pilote managé, consultez la documentation de support de globalisation d’Oracle.

FetchSize dans le Registre n’est pas utilisé par le pilote intégré

S’applique à Power BI Desktop et à la passerelle de données locale, pour les modèles d’importation Oracle.

Après avoir basculé vers le pilote intégré, les modèles d’importation Oracle peuvent s’actualiser plus lentement qu’avec le pilote ODP.NET non managé. Le fournisseur ODP intégré.NET ne lit pas la FetchSize propriété à partir du Registre. La valeur par défaut FetchSize pour odp.NET fournisseurs non managés et managés est de 128 Ko dans la version 23.26.2 et antérieure, y compris le fournisseur 23.6 inclus Power BI. Le fournisseur managé ignore tout FetchSize remplacement configuré dans le Registre.

Désactivez le pilote intégré pour revenir au pilote ODP.NET pilote non géré, qui respecte le paramètre de RegistreFetchSize. Sur la passerelle de données locale, définissez-la MashupFlight_DisableOracleBundledOdacProviderV2True dans la configuration groupée du fournisseur dans les paramètres de passerelle.

L’authentification d’utilisateur proxy Oracle n’est pas prise en charge

S’applique à la passerelle de données locale (version de juin 2026 et ultérieure) pour Oracle Import et DirectQuery qui utilisent un compte proxy Oracle.

Après la mise à niveau vers la passerelle de juin 2026, qui est par défaut le fournisseur managé intégré, Power BI rapports qui se connectent à Oracle à l’aide d’un compte proxy Oracle échouent à la fois dans Import et DirectQuery. La même source de données fonctionne lorsque la connexion utilise un compte Oracle non proxy. L'authentification par utilisateur proxy Oracle Database ( connexion en tant qu'utilisateur de base de données pour le compte d'un autre schéma (par exemple, le User Id=proxy_user[target_schema] formulaire) n'est pas prise en charge par la version 23.6 du fournisseur ODP managé intégré.NET qui est actuellement fourni avec Power BI.

Utilisez l’une des solutions de contournement suivantes :

• Utilisez un compte Oracle non proxy si possible.
• Pour l’importation, désactivez le pilote intégré pour l’importation sur la passerelle en définissant MashupFlight_DisableOracleBundledOdacProviderV2Truesur , de sorte que la passerelle revient au pilote ODP.NET non managé, qui prend en charge les comptes proxy.
• Pour DirectQuery, le paramètre Importer ne s’applique pas. Contactez Support Microsoft pour désactiver le pilote intégré pour le chemin DirectQuery de passerelle. Cette configuration n’est pas en libre-service aujourd’hui.

Impossible de mettre à jour les informations d’identification de connexion au cloud personnel Oracle

S’applique aux service Power BI, pour les connexions cloud personnelles Oracle.

Dans la page Gérer les connexions et les passerelles de l'service Power BI, la mise à jour des informations d'identification d'une connexion cloud personnelle Oracle ne fonctionne pas. Au lieu de cela, mettez à jour les informations d’identification à partir du volet paramètres du modèle sémantique :

1. Ouvrez le volet paramètres du modèle sémantique et accédez à la passerelle et aux connexions cloud.
2. Définissez la source de données pour utiliser la connexion cloud personnelle.
3. Sous Informations d’identification de la source de données, modifiez les informations d’identification de la source de données.

Si vous avez téléchargé Power BI Desktop à partir du 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 retourné est : Référence d’objet non définie. Pour résoudre le problème, téléchargez Power BI Desktop à partir du Centre de téléchargement au lieu du Microsoft Store.

Si le message d'erreur référence d'objet non définie se produit dans Power BI lorsque vous vous connectez à une base de données Oracle à l'aide de la passerelle de données sur site, suivez les instructions 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 .

Contenu connexe

Optimiser Power Query lors du développement de colonnes de table