Connecteur Oracle Database

Catégorie : Connecteurs de bases de données

Introduction

Ce document est créé pour aider à configurer un connecteur mindzieDataDesigner vers Oracle Database. mindzieDataDesigner est l'outil ETL utilisé par mindzieStudio pour convertir les tables de bases de données en journaux d'événements pour le process mining. L'objectif de ce document est d'aider à créer la chaîne de connexion et à ouvrir les ports sur le pare-feu si nécessaire.

Aperçu

Le connecteur Oracle fournit une connectivité native aux instances Oracle Database en utilisant Oracle Managed Data Access (ODP.NET). Ce connecteur offre des performances élevées, un support complet des fonctionnalités Oracle, et une gestion optimisée des fuseaux horaires pour les entreprises internationales.

Exigences système

  • Système de base de données : Oracle Database 11g Release 2 ou version ultérieure (19c recommandé)
  • Éditions supportées : Express Edition (XE), Standard Edition, Enterprise Edition
  • Support des plateformes : Windows, Linux, Unix
  • Support cloud : Oracle Cloud Infrastructure (OCI), Amazon RDS pour Oracle, Oracle Autonomous Database
  • Dépendances : Oracle Managed Data Access (ODP.NET) - inclus avec le connecteur

Format de la chaîne de connexion

Format basique (Easy Connect)

Data Source=hostname:port/service_name;User Id=username;Password=password;

Format TNS Names

Data Source=tns_alias;User Id=username;Password=password;

Paramètres de connexion

Paramètre Description Obligatoire Exemple
Data Source Détails de connexion au serveur Oui oracle-server:1521/ORCL
User Id Nom d'utilisateur Oracle Oui PROCESS_MINING
Password Mot de passe Oracle Oui SecurePassword123
Connection Timeout Délai d'attente connexion (secondes) Non 60
Command Timeout Délai d'attente commande (secondes) Non 600
Pooling Activation du pool de connexions Non true
Min Pool Size Nombre minimum de connexions pool Non 1
Max Pool Size Nombre maximum de connexions pool Non 100
DBA Privilege Privilèges administratifs Non SYSDBA
Persist Security Info Persister les informations de sécurité Non false

Exemples de connexion

Oracle Express Edition (XE) locale

Data Source=localhost:1521/XE;User Id=MINDZIE_USER;Password=password;

Oracle Enterprise Database

Data Source=oracle-prod.company.com:1521/PRODDB;User Id=PROCESS_MINING;Password=SecurePassword123;Connection Timeout=60;

Utilisation des TNS Names

Data Source=PROD_ORACLE;User Id=MINDZIE_USER;Password=SecurePassword123;

Oracle Autonomous Database (Cloud)

Data Source=mydb_high;User Id=ADMIN;Password=CloudPassword123;

Connexion avec paramètres avancés

Data Source=oracle-server:1521/ORCL;User Id=MINDZIE_USER;Password=password;
Pooling=true;Min Pool Size=5;Max Pool Size=50;Connection Timeout=30;

Connexion Pluggable Database (PDB)

Data Source=oracle-server:1521/PDB1;User Id=PROCESS_USER;Password=password;

Méthodes d'authentification

Authentification base de données

  • Authentification standard par nom d'utilisateur/mot de passe Oracle
  • Utilisateurs créés avec des instructions CREATE USER
  • Méthode d'authentification la plus commune

Authentification OS

Data Source=oracle-server:1521/ORCL;Integrated Security=yes;

Authentification Proxy

Data Source=oracle-server:1521/ORCL;User Id=app_user;Password=password;Proxy User Id=end_user;

Dépannage

Problèmes courants de connexion

Erreur "ORA-12154 : TNS : impossible de résoudre l'identificateur de connexion"

  • Vérifiez la configuration des noms TNS dans tnsnames.ora
  • Contrôlez les variables d'environnement ORACLE_HOME et TNS_ADMIN
  • Utilisez la syntaxe Easy Connect en alternative
  • Validez le nom du service et le nom d'hôte

Erreur "ORA-01017 : nom d'utilisateur/mot de passe invalide"

  • Vérifiez que les identifiants sont corrects et que l'utilisateur existe
  • Vérifiez si le compte est verrouillé : ALTER USER username ACCOUNT UNLOCK;
  • Assurez-vous que l'utilisateur possède le privilège CREATE SESSION
  • Vérifiez que le mot de passe n’a pas expiré

Erreur "ORA-12505 : TNS : le listener ne connaît pas actuellement le SID donné"

  • Vérifiez l'usage du nom de service versus SID
  • Vérifiez le statut du listener Oracle : lsnrctl status
  • Utilisez le nom de service au lieu du SID dans les versions Oracle modernes
  • Validez l'enregistrement du service de base de données

Erreur "ORA-00257 : erreur d'archivage"

  • Contrôlez l'espace des logs d'archives Oracle
  • Contactez l'administrateur Oracle pour maintenance
  • Envisagez d'utiliser une connexion en lecture seule si disponible

Accès serveur mindzie : Pour renforcer la sécurité, vous pouvez configurer votre pare-feu pour n'autoriser les connexions qu'à partir des serveurs mindzie en ajoutant en liste blanche des adresses IP spécifiques. Contactez le support mindzie pour obtenir les adresses IP actuelles des serveurs mindzie que vous utilisez.

Problèmes Oracle Cloud

Erreur "ORA-28040 : protocole d'authentification non compatible"

  • Mettez à jour le client Oracle vers une version compatible
  • Vérifiez les exigences d'authentification Oracle Cloud
  • Contrôlez la configuration SSL/TLS

Configuration Oracle Autonomous Database

Prérequis

  1. Télécharger le Wallet : Récupérez le wallet de connexion depuis la console Oracle Cloud
  2. Extraire le Wallet : Placez les fichiers dans un répertoire accessible
  3. Configurer TNS_ADMIN : Pointez vers le répertoire du wallet
  4. Chaîne de connexion : Utilisez les noms de services du fichier tnsnames.ora

Connexion Autonomous Database

Data Source=mydb_high;User Id=ADMIN;Password=WalletPassword123;

Configuration Wallet

  • Extrayez wallet.zip dans un répertoire sécurisé
  • Définissez la variable d'environnement TNS_ADMIN
  • Utilisez les noms de service prédéfinis (HIGH, MEDIUM, LOW)

Informations complémentaires

💡 Astuce : Pour les déploiements Oracle en entreprise, envisagez d'utiliser les chaînes de connexion Oracle Real Application Clusters (RAC) avec plusieurs hôtes pour assurer la haute disponibilité et la répartition de charge.