Skip to main content

Configurer le processus extproc pour accéder à ST_Geometry dans Oracle

Dans Oracle, les fonctions SQL ST_Geometry utilisent une bibliothèque partagée accessible par Oracle par l’intermédiaire de l’agent de procédure externe Oracle ou extproc. Le cadre de procédure externe Oracle nécessite l’accès au fichier physique de la bibliothèque ST_SHAPELIB pour que vous puissiez exécuter les opérations suivantes :

Étapes préparatoires

La bibliothèque ST_Geometry est créée pour les systèmes d’exploitation spécifiques. Connectez-vous à My Esri et téléchargez le fichier de bibliothèque correspondant au système d’exploitation sur lequel Oracle s’exécute et spécifique à la version du client ArcGIS que vous utilisez.

L’instance Oracle doit avoir accès à la bibliothèque ST_Geometry. Placez la bibliothèque sur la machine Oracle dans un répertoire auquel l’instance Oracle a accès.

Avant de configurer le fichier extproc Oracle, effectuez les opérations suivantes :

  1. Téléchargez la bibliothèque ST_Geometry à partir de My Esri et placez-la dans un répertoire sur la machine Oracle.

    Remarque :

    Veillez à télécharger ou à copier la bibliothèque appropriée pour votre système d’exploitation Oracle.

    La bibliothèque ST_Geometry requiert Microsoft Visual C++ Redistributable Package (x64) lorsqu’elle est déployée sur un serveur Microsoft Windows. Pour connaître la version requise du paquetage, reportez-vous à la rubrique Configuration ArcGIS requise pour Oracle. Si ce paquetage n’est pas présent sur le serveur Oracle, téléchargez-le depuis le site de Microsoft et installez-le.

    Lorsque vous exécutez l’outil de géotraitement Créer un type spatial pour activer ST_Geometry dans une base de données Oracle ou lorsque vous exécutez l’outil de géotraitement Créer une géodatabase d’entreprise ou Activer une géodatabase d’entreprise pour créer une géodatabase, les outils définissent un chemin d’accès par défaut à la bibliothèque ST_SHAPELIB.

  2. Connectez-vous à l’instance Oracle en tant qu’utilisateur sde depuis un client SQL et exécutez la commande SQL suivante pour confirmer que le chemin défini par l’outil correspond à l’emplacement de la bibliothèque ST_Geometry :

    SELECT file_spec
 FROM user_libraries
 WHERE library_name = 'ST_SHAPELIB';

    Si le chemin renvoyé ne correspond pas à l’emplacement du fichier de bibliothèque ST_Geometry, recréez la bibliothèque après avoir configuré le processus extproc.

Configurer le processus extproc

Configurez le fichier Oracle extproc.ora de sorte qu’il pointe vers l’emplacement du fichier de bibliothèque ST_Geometry. Consultez la documentation Oracle pour plus d’informations sur la syntaxe Oracle SQL.

  1. Effectuez une sauvegarde du fichier extproc.ora sur le serveur Oracle.

  2. Ouvrez le fichier extproc.ora dans un éditeur de texte et modifiez-le de sorte qu’il pointe vers l’emplacement de la bibliothèque st_shapelib.dll (Windows) ou libst_shapelib.so (Linux ou UNIX).

  3. Enregistrez et fermez le fichier extproc.ora.

    Il peut être nécessaire de redémarrer l’instance Oracle pour qu’elle identifie les changements apportés au fichier extproc.ora.

  4. Si le fichier de bibliothèque ST_Geometry ne se trouve plus à l’emplacement par défaut ou si aucun emplacement n’a été défini, créez ou recréez la bibliothèque ST_SHAPELIB dans la base de données Oracle.

    Vous devez vous connecter à la base de données en tant qu’utilisateur sde pour créer ou recréer la bibliothèque ST_Geometry.

  5. Si vous avez recréé la bibliothèque, recompilez le paquetage sde.st_geometry_shapelib_pkg.

    Les clients qui doivent accéder à la bibliothèque (y compris les services Web) doivent se reconnecter à la base de données.

Valider la configuration du fichier extproc

Vous pouvez interroger la bibliothèque ST_Geometry pour vous assurer que le processus extproc peut y accéder.

  1. Connectez-vous à un client SQL Oracle.

  2. Exécutez la requête suivante :

     SELECT sde.ST_AsText(
   SDE.ST_Geometry('POINT (10 10)', 0)
  )
 FROM dual;

    Si le processus extproc est configuré correctement, la requête renvoie le résultat suivant :

    SDE.ST_ASTEXT(SDE.ST_GEOMETRY('POINT(1010)',0))
-------------------------------------------
POINT (10.00000000 10.00000000)

    Si le fichier extproc n’est pas correctement configuré, la requête renvoie un ou plusieurs des messages suivants :

    ORA-06520: PL/SQL : Erreur lors du chargement de la bibliothèque externe

    ORA-06522 : Chargement DLL impossible

    ORA-06512 : "SDE.ST_GEOMETRY_SHAPELIB_PKG", ligne 0

    ORA-06512 : "SDE.ST_GEOMETRY_OPERATORS", ligne 68

Mises à niveau et bibliothèque ST_Geometry

Vous devez télécharger ou copier de nouvelles versions du fichier de bibliothèque pour obtenir les correctifs et améliorations inclus dans de nouvelles versions de la bibliothèque lorsque vous mettez à niveau la géodatabase dans Oracle ou devez mettre à niveau le type ST_Geometry dans une base de données Oracle.

Oracle peut marquer la bibliothèque comme non valide lorsqu’elle est remplacée ou après la mise à jour de l’instance Oracle par vos soins. Oracle recompile parfois automatiquement les objets de base de données non valides lorsque les objets sont référencés par un client. Cependant, dans certains cas, ils ne sont pas compilés automatiquement.

La bibliothèque ST_Geometry appartient à l’utilisateur sde. Pour vérifier le statut de la bibliothèque (et de tous les fichiers appartenant à l’utilisateur sde), connectez-vous à un client SQL en tant qu’utilisateur sde et exécutez l’instruction suivante :

SELECT object_name, object_type
FROM USER_OBJECTS
WHERE STATUS = 'INVALID';

Si le corps du paquetage sde.st_geometry_shapelib_pkg est renvoyé dans la liste des objets non valides, recompilez-le comme décrit à l’étape 5 de la section Configurer le processus extproc ci-dessus.

Si plusieurs objets ne sont pas valides, vous pouvez tous les recompiler dans la même structure. Consultez la documentation d’Oracle pour prendre connaissance des privilèges requis et des instructions de recompilation d’objets.