Configurar Oracle extproc para acceder a la geodatabase con SQL

Las funciones SQL de ST_Geometry y ST_Raster en Oracle usan bibliotecas compartidas a las que se accede a través del agente de procedimiento externo de Oracle, o extproc. Para utilizar SQL con ST_Geometry o ST_Raster, o para acceder a las columnas XML de ArcSDE en las vistas GDB_ITEMS_VW y GDB_ITEMRELATIONSHIPS_VW, Oracle debe tener acceso a las bibliotecas. Por consiguiente, las bibliotecas deben estar presentes en el servidor Oracle, y deben ser llamadas mediante el marco de procedimiento externo de Oracle.

Es posible usar ST_Geometry y ST_Raster en ArcGIS sin configurar Oracle listener. Sin embargo, no tendrá funcionalidad completa desde los clientes de ArcGIS y no tendrá funcionalidad desde los clientes SQL, como SQL*Plus. Por ejemplo, no puede usar funciones SQL en las columnas ST_Geometry en las capas de consulta en ArcMap o tablas de versiones que contengan columnas ST_Raster, eliminar una fila que incluya una columna ST_Raster ni ejecutar funciones SQL desde los clientes SQL si Oracle listener no está configurado. Además, no puede publicar datos que utilicen el tipo ST_Geometry como un servicio de entidades para un servidor de datos espaciales si no configura el Oracle listener.

La instalación de ST_Raster es opcional. Consulte Instalar el tipo ST_Raster en Oracle para obtener instrucciones.

Nota:

Si la base de datos de Oracle está instalada en un servidor de Windows, pero no tiene instalado el servidor de aplicaciones ArcSDE, deberá instalar Microsoft Visual C++ 2008 SP1 Redistributable Package (x64). Si Microsoft Visual C++ 2008 SP1 Redistributable Package (x64) no está en el servidor de Oracle, descárguelo del sitio web de Microsoft e instálelo.

Si utiliza Oracle 11g, edite el archivo extproc.ora para llamar a las funciones mediante el marco de procedimiento externo de Oracle. Si utiliza Oracle 10g, configure Oracle listener.

Oracle 11g

Oracle recomienda que configure EXTPROC modificando el archivo extproc.ora en lugar de configurar el listener para Oracle 11g. El archivo extproc.ora se encuentra en el directorio ORACLE_HOME\hs\admin.

Una vez que haya movido la biblioteca ST_Geometry (st_shapelib) y/o ST_Raster al servidor de Oracle, modifique el archivo extproc.ora para que se dirija hacia la ubicación de las bibliotecas.

En un servidor de Windows, agregaría líneas en un modo similar al que se presenta a continuación:

EXTPROC_DLLS=ONLY:C:\\mylibraries\\st_shapelib.dll

EXTPROC_DLLS=ONLY:C:\\mylibraries\\libst_raster_ora.dll

Si está utilizando ambas bibliotecas, podrá ubicarlas en una línea:

EXTPROC_DLLS=ONLY:C:\\mylibraries\\st_shapelib.dll;C:\\mylibraries\\libst_raster_ora.dll

En estos ejemplos, las bibliotecas están ubicadas en una carpeta llamada mylibrares, que fue creada en el servidor de Oracle para almacenar las bibliotecas.

En un servidor Linux o UNIX:

SET EXTPROC_DLLS=ONLY:/user/esrilibs/libst_shapelib.so

SET EXTPROC_DLLS=ONLY:/user/esrilibs/libst_raster_ora.so

Si está utilizando ambas bibliotecas, podrá ubicarlas en una línea:

SET EXTPROC_DLLS=ONLY:/user/esrilibs/libst_shapelib.so:/user/esrilibs/libst_raster_ora.so

En estos ejemplos, las bibliotecas están ubicadas en el directorio esrilibs del usuario, que fue creado en el servidor de Oracle para almacenar las bibliotecas.

Oracle 10g

Los Oracle listeners son altamente configurables. Por ejemplo, hay varios listeners asociados con su base de datos, y cada uno de ellos puede administrar diversos tipos de solicitudes de servicio. Este es un tema complejo, y este documento no cubre las diversas variaciones del tema. Es importante consultar la Oracle Database Net Services Administrator's Guide para obtener los detalles sobre la configuración de los listeners.

Indicar a extproc dónde encontrar las bibliotecas compartidas es el aspecto más importante de la configuración del listener. Debe modificar la configuración del listener para especificar la ubicación de las bibliotecas compartidas y reiniciar el proceso de Oracle listener para que los cambios de la configuración tengan efecto.

Hay dos archivos de configuración estándar de Oracle Listener relacionados: tnsnames.ora y listener.ora. Estos archivos, por lo general, están en ORACLE_HOME/net/admin. Este documento presenta los valores de configuración que son necesarios.

Existen varias formas de administrar la configuración. Puede editar los archivos de texto con un editor de texto, usar Oracle Net Manager o usar Oracle Net Configuration Assistant. Oracle proporciona documentación sobre cómo configurar el listener. Consulte la Oracle Database Net Services Administrator's Guide para obtener detalles.

El archivo tnsnames.ora contiene un directorio de los servicios de bases de datos conocidos. Este archivo puede definir los servicios en la base de datos local o en servidores remotos. Una entrada es específicamente para el uso del servidor de la base de datos local para que use comunicaciones entre procesos (IPC) a fin de enviar llamadas de función al extproc. Esta entrada se etiqueta EXTPROC_CONNECTION_DATA. También puede alterar los valores SID y Key en esta entrada.

Estos elementos se utilizan para vincular esta entrada a la información correspondiente en el archivo listener.ora. La clave puede ser cualquier nombre corto, pero tanto el archivo listener.ora como el archivo tnsnames.ora deben tener la misma clave. Estos valores distinguen entre mayúsculas y minúsculas. Solo los usa el proceso del listener y no los usuarios o las aplicaciones.

En el archivo listener.ora se describen algunos de los servicios (no necesariamente todos) para los cuales el listener escucha solicitudes.

Los valores que pueden modificarse en este archivo incluyen:

• SID_LIST_LISTENER

  Esta etiqueta comienza una lista de SID que puede manejar el listener llamado LISTENER (el nombre de listener predeterminado).

• SID_LIST y SID_DESC

  Las entradas SID_DESC en el encabezado SID_LIST definen servicios. La primera en la lista maneja las solicitudes de extproc, y la segunda maneja las sesiones de los clientes.

• SID_NAME

  El valor de este debe corresponder con el SID especificado para extproc en el archivo tnsnames.ora.

• ORACLE_HOME

  Define la ubicación de inicio de Oracle para este servicio. Los archivos del programa extproc se cargan desde una carpeta debajo de esta ubicación.

• PROGRAM

  Especifica el nombre del archivo ejecutable de extproc. Este nombre, que distingue entre mayúsculas y minúsculas, podría ser extproc o extproc.exe, según el tipo de sistema operativo. El archivo está ubicado en ORACLE_HOME/bin.

• ENVS

  Es una lista de las variables de entorno que usa extproc cuando se ejecuta. La lista está delimitada por comas. Debe incluir una definición de la variable de entorno EXTPROC_DLLS y cualquier otra variable de entorno que extproc necesite cuando se ejecuta, que suelen incluir LD_LIBRARY_PATH, SHLIB_PATH o LIBPATH en UNIX y sistemas Linux, o PATH en servidores Windows. La variable de ruta suele incluir la ubicación de la geometría y las bibliotecas del motor de proyección.

• EXTPROC_DLLS

  Esta variable de entorno define una lista de bibliotecas desde donde extproc puede cargar y llamar funciones directamente. Aquí debe especificar la ruta al archivo que contiene la biblioteca forma, necesaria para acceder a los tipos ST_Geometry o a las vistas GDB_ITEMS_VW y GDB_ITEMRELATIONSHIPS_VW mediante SQL, y la biblioteca st_raster, necesaria para acceder al tipo ST_Raster mediante SQL.

  La lista está delimitada por comas para los servidores Oracle instalados en UNIX y delimitadas por punto y coma para los servidores Oracle instalados en Windows. Todas las rutas deben ser absolutas y apuntar a directorios locales o una ruta UNC a los que puede acceder el usuario del sistema Oracle. Esto también significa que, si instaló un servidor de aplicaciones ArcSDE en un servidor que no es Oracle, debe copiar las bibliotecas de ráster y forma del directorio bin en SDEHOME al servidor Oracle.

  No existe una sustitución de la variable de entorno.

  Las palabras clave opcionales ANY y ONLY pueden usarse para flexibilizar o restringir la forma en que extproc usa los archivos de la biblioteca. Si coloca ANY delante de la ruta, Oracle podrá cargar cualquier biblioteca desde la ruta especificada, y usted no tendrá que proporcionar un nombre de biblioteca. Si coloca ONLY delante de la ruta, Oracle utilizará solo la biblioteca específica que proporcionó en la ruta.

• KEY

  El valor establecido para esta entrada vincula este listener con la entrada de servicio correspondiente en el archivo tnsnames.ora. Distingue a este listener de otros listeners de IPC que podrían estar presentes en el mismo servidor de base de datos. La clave puede ser cualquier nombre corto pero debe ser el mismo en los archivos listener.ora y tnsnames.ora. La clave distingue entre mayúsculas y minúsculas.

Pasos:

1. Antes de hacer algún cambio, haga copias de seguridad de los archivos tnsnames.ora y listener.ora.
2. Abra el archivo tnsnames.ora en el servidor Oracle.
3. Cambie los valores SID y Key en EXTPROC_CONNECTION_DATA en el archivo tnsnames.ora.

   EXTPROC_CONNECTION_DATA = (DESCRIPTION =     (ADDRESS_LIST =       (ADDRESS = (PROTOCOL = IPC)(Key = EXTPROC1))     )     (CONNECT_DATA =       (SID = PLSExtProc)       (PRESENTATION = RO)     ) )

   Esta entrada siempre debe tener la etiqueta EXTPROC_CONNECTION_DATA. El servidor de la base de datos usa esta entrada para que las comunicaciones entre procesos envíen llamadas de función a extproc.

4. Abra el archivo listener.ora en el servidor Oracle.
5. Cambie las entradas necesarias para configurar los servicios desde los cuales el listener aceptará solicitudes.

   El primer ejemplo es para un sistema operativo Windows en el que están instalados el servidor de aplicaciones ArcSDE y Oracle:

    LISTENER = (DESCRIPTION_LIST =     (DESCRIPTION =       (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1)) (ADDRESS = (PROTOCOL = TCP)(HOST = svr1.dmn1.com)(PORT = 1521))     )  )  SID_LIST_LISTENER =   (SID_LIST =     (SID_DESC =       (SID_NAME = PLSExtProc)       (ORACLE_HOME = C:\oracle\product\10.2.0\db_1)       (PROGRAM = extproc)          (ENVS="EXTPROC_DLLS=C:\ArcSDE\sdeexe\bin\st_shapelib.dll;c:\ArcSDE\sdeexe\bin\libst_raster_ora.dll")  )   )

   En este ejemplo se muestra una entrada para un servidor Linux o UNIX en el cual están instalados el servidor de aplicaciones ArcSDE y Oracle:

    LISTENER = (DESCRIPTION_LIST =     (DESCRIPTION =       (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1)) (ADDRESS = (PROTOCOL = TCP)(HOST = svr1.dmn1.com)(PORT = 1521))     ) )  SID_LIST_LISTENER =   (SID_LIST =     (SID_DESC =       (SID_NAME = PLSExtProc) (ORACLE_HOME = /servit/oracle/product/10.2.0/db_1)       (PROGRAM = extproc)          (ENVS="EXTPROC_DLLS=/servit/ArcSDE/sdeexe/lib/libst_shapelib.so:/servit/ArcSDE/sdeexe/lib/libst_raster_ora.so")     )    )

6. Después de cambiar el archivo listener.ora, reinicie Oracle listener.