ArcMap

Instalar ST_Raster en Oracle

Disponible con una licencia Standard o Advanced.

ST_Raster es un tipo de datos que permite almacenar datos ráster directamente en una tabla de geodatabase. El tipo ST_Raster se utiliza cuando es necesario acceder a los datos ráster de geodatabase por medio de SQL.

Utilice la herramienta de geoprocesamiento Crear tipo de ráster o una secuencia de comandos de Python que llame a la herramienta para instalar el tipo ST_Raster en una geodatabase.

Una vez que haya instalado el tipo , debe cambiar los ajustes de la configuración de la geodatabase de forma que los nuevos ráster creados en la geodatabase utilicen el tipo de datos ST_Raster.

Actualizar el archivo extproc

El agente de procedimiento externo de Oracle (extproc) debe acceder a la biblioteca ST_Raster (libst_raster_ora).

Si ArcMap o ArcGIS for Server se ha instalado en el servidor de Oracle, puede actualizar el archivo extproc.ora para que apunte a libst_raster_ora en <ArcGIS client installation directory>\DatabaseSupport\Oracle\<Operating System>. Asegúrese de definir el archivo en la biblioteca correcta para el sistema operativo del servidor de Oracle. Una vez que se haya actualizado exptroc.ora, instale ST_Raster.

Si no hay ningún cliente de ArcGIS instalado en el servidor de Oracle, debe copiar primero la biblioteca libst_raster_ora en el servidor de Oracle, actualizar el archivo extproc.ora y crear la biblioteca.

Siga estos pasos si ArcMap o ArcGIS Server no se ha instalado en el servidor de Oracle:

  1. Cree un directorio en el servidor de Oracle al que pueda acceder su instancia de Oracle.
  2. Descargue las bibliotecas desde My Esri o copie la biblioteca libst_raster_ora desde <ArcMap or ArcGIS Server installation directory>\DatabaseSupport\Oracle\<Operating System>.
  3. Guarde la biblioteca libst_raster_ora adecuada para el sistema operativo del servidor de Oracle en el directorio que ha creado.
  4. Actualice el archivo extproc.ora para incluir la ruta de la biblioteca libst_raster_ora.
  5. Usando SQL, conéctese a la base de datos de Oracle como usuario sde y cree la biblioteca libst_raster_ora de Oracle.

    CREATE LIBRARY LIBST_RASTER
 AS '<absolute path to libst_raster_ora library>'
/

Ahora que el servidor de Oracle se ha configurado, puede instalar ST_Raster.

Instalar ST_Raster

Puede ejecutar la herramienta Crear tipo de ráster desde ArcGIS for Desktop (Standard o Advanced) o ejecutar una secuencia de comandos de Python desde un cliente de ArcGIS for Server o de ArcGIS for Desktop (Standard o Advanced) para instalar el tipo ST_Raster.

Ejecutar la herramienta Crear tipo de ráster

Si tiene acceso a ArcGIS for Desktop (Standard o Advanced), puede ejecutar la herramienta Crear tipo de ráster para instalar el tipo ST_Raster.

  1. Inicie ArcCatalog, ArcMap o ArcGIS Pro.
  2. Conéctese a la geodatabase como administrador de la misma.
  3. Abra la herramienta Crear tipo de ráster .

    Esta herramienta está en el conjunto de herramientas de la Administración de geodatabase, en la caja de herramientas de la Administración de datos.

  4. Especifique la conexión de la base de datos que creó en el paso 2 como Conexión de base de datos de entrada.
  5. Haga clic en el botón Aceptar para ejecutar la herramienta.

Utilizar Python

Puede ejecutar una línea de comandos de Python para crear un archivo de conexión de base de datos (.sde) que conecte a la geodatabase como administrador de la geodatabase e instalar el tipo ST_Raster en la geodatabase.

  1. Abra una ventana de comando, importe el módulo ArcPy y utilice la función CreateDatabaseConnection_management para crear un archivo de conexión de base de datos (.sde) que conecte a la geodatabase como administrador de la misma. Si se conecta utilizando la autenticación de base de datos, asegúrese de que guarda el nombre de usuario y la contraseña con el archivo de conexión.

    En este ejemplo, se crea un archivo de conexión (adminconnect.sde) en C:\temp. La conexión se realiza a la instancia teamdata/orcl de Oracle como usuario sde.

    import arcpy
arcpy.CreateDatabaseConnection_management (r'c:/temp',"adminconnect.sde", "ORACLE", "teamdata/orcl", "DATABASE_AUTH", "sde", "Cky00r", "SAVE_USERNAME")

  2. Instale el tipo ST_Raster.

    En este caso, el archivo adminconnect.sde lo utiliza la función CreateRasterType_management para conectar a la geodatabase e instalar el tipo ST_Raster:

    arcpy.CreateRasterType_management (r'c:/temp/adminconnect.sde')

Confirmar la instalación

Utilizando un cliente de SQL, conéctese como cualquier usuario que tenga acceso a la base de datos de Oracle en la que instaló ST_Raster y pruebe la instalación del tipo ST_Raster ejecutando la siguiente instrucción SELECT:

SELECT sde.st_raster_util.describe() 
 FROM dual;

Los resultados correctos de esta consulta incluyen Sin datos disponibles si aún no existen datos ráster en la geodatabase o una lista de las columnas de ráster de la base de datos.

Se devuelve un mensaje de error si el agente de escucha de Oracle no se inicia, o si no se puede acceder a la biblioteca libst_raster_ora. Es posible que no se pueda acceder a la biblioteca si ST_Raster no se instaló, si el archivo extproc.ora no se actualizó con la ruta a la biblioteca libst_raster_ora o si la biblioteca libst_raster_ora se copió en una ubicación incorrecta.

En este ejemplo, se ejecuta la utilidad describe para enumerar las columnas ST_Raster y las columnas de rásteres binarios existentes en la base de datos. En este caso, se trata de una geodatabase nueva y aún no hay columnas de ráster en la base de datos. Si no aparece un mensaje de error, la instalación se realizó de manera correcta.

SELECT sde.st_raster_util.describe() 
 FROM dual;
SDE.ST_RASTER_UTIL.DESCRIBE()
No data found.

En este ejemplo, también se ejecuta la utilidad describe. Sin embargo, en este caso, la ruta a la biblioteca libst_raster_ora no se agregó al parámetro ENV extproc.ora. Corrija el problema y ejecute la consulta nuevamente para asegurarse de que se haya solucionado.

SELECT sde.st_raster_util.describe() 
 FROM dual;
ERROR:
ORA-28575: unable to open RPC connection to external procedure agent
ORA-06512: at "SDE.ST_RASTER_UTIL", line 190
ORA-06512: at "SDE_ST_RASTER_UTIL", line 377

Una vez que ha confirmado que ST_Raster está instalado, modifique los ajustes de la palabra clave de configuración.

Modificar la configuración de la geodatabase

Una vez que ST_Raster está instalado en la geodatabase, debe modificar la configuración de la geodatabase de modo que ST_Raster esté disponible para que lo utilicen los usuarios cuando creen datasets ráster y catálogos de ráster. Para ello, puede conectarse desde ArcGIS for Desktop (Standard o Advanced) y ejecutar herramientas de geoprocesamiento o puede utilizar una línea de comandos de Python desde un cliente de ArcGIS for Server o ArcGIS for Desktop (Standard o Advanced).

Ejecutar herramientas de geoprocesamiento

Si tiene acceso a ArcGIS for Desktop, puede utilizar la herramienta Exportar palabra clave de configuración de geodatabase para exportar la configuración actual de la geodatabase a un archivo de texto, establecer el parámetro RASTER_STORAGE en ST_Raster en el archivo de texto e importar el archivo de texto modificando utilizando la herramienta Importar palabra clave de configuración de geodatabase.

  1. Abra la herramienta Exportar palabra clave de configuración de geodatabase en ArcGIS for Desktop.
  2. Utilice la conexión de la base de datos que ha creado para instalar ST_Raster como Conexión de la base de datos de entrada.
  3. Especifique una ubicación y el nombre de archivo para el archivo de texto que se va a crear.
  4. Abra el archivo de texto en un editor de texto y establezca RASTER_STORAGE en ST_Raster.
    • Si desea que todos los datasets ráster y los catálogos de ráster utilicen el tipo ST_Raster sin que los usuarios tengan que especificar una palabra clave, modifique el parámetro RASTER_STORAGE bajo la palabra clave DEFAULTS.
    • Si solo algunos de los datasets ráster y de los catálogos de ráster deben utilizar el tipo ST_Raster, cree una palabra clave personalizada y establezca el parámetro RASTER_STORAGE para esa palabra clave en ST_Raster.
  5. Guarde y cierre el archivo de texto.
  6. Importe el archivo de texto modificado a la geodatabase utilizando la herramienta Importar palabra clave de configuración de geodatabase.

Utilizar Python

Si utiliza la función ArcPy ExportGeodatabsaeConfigurationKeyword_management para exportar la configuración de geodatabase actual a un archivo de texto, edite y guarde el archivo de texto y, a continuación, utilice la función ImportGeodatabaseConfigurationKeyword_management para importar los cambios en la geodatabase.

Utilice el archivo de conexión de base de datos que creó al instalar ST_Raster como base de datos de entrada cuando ejecute las funciones ExportGeodatabsaeConfigurationKeyword_management y ImportGeodatabaseConfigurationKeyword_management.

  1. Exporte la configuración de geodatabase actual.

    En este ejemplo, el archivo gdbconfig se exporta a la carpeta C:\temp.

    arcpy.ExportGeodatabaseConfigurationKeyword_management (r'c:/temp/adminconnect.sde', r'c:/temp/gdbconfig.txt')

  2. Abra el archivo de texto en un editor de texto y establezca RASTER_STORAGE en ST_Raster.
    • Si desea que todos los datasets ráster y los catálogos de ráster utilicen el tipo ST_Raster sin que los usuarios tengan que especificar una palabra clave, modifique el parámetro RASTER_STORAGE bajo la palabra clave DEFAULTS.
    • Si solo algunos de los datasets ráster y de los catálogos de ráster deben utilizar el tipo ST_Raster, cree una palabra clave personalizada y establezca el parámetro RASTER_STORAGE para esa palabra clave en ST_Raster.
  3. Guarde y cierre el archivo de texto.
  4. Importe el archivo editado.

    arcpy.ImportGeodatabaseConfigurationKeyword_management (r'c:/temp/adminconnect.sde', r'c:/temp/gdbconfig.txt')

Los nuevos valores de configuración se pueden utilizar cuando se crean datos.