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 Server están instalados en el servidor de Oracle, puede actualizar el archivo extproc.ora para que señale 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 exptroc.ora se haya actualizado, inicie la instalación de 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:
- Cree un directorio en el servidor de Oracle al que pueda acceder su instancia de Oracle.
- Descargue las bibliotecas desde My Esri o copie la biblioteca libst_raster_ora desde <ArcMap or ArcGIS Server installation directory>\DatabaseSupport\Oracle\<Operating System>.
- Guarde la biblioteca libst_raster_ora adecuada para el sistema operativo del servidor de Oracle en el directorio que ha creado.
- Actualice el archivo extproc.ora para incluir la ruta de la biblioteca libst_raster_ora.
- 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 Desktop (Standard o Advanced) o ejecutar una secuencia de comandos de Python desde un cliente de ArcGIS Server o de ArcGIS Desktop (Standard o Advanced) para instalar el tipo ST_Raster.
Ejecutar la herramienta Crear tipo de ráster
Si tiene acceso a ArcGIS Desktop (Standard o Advanced), puede ejecutar la herramienta Crear tipo de ráster para instalar el tipo ST_Raster.
- Inicie un cliente de ArcGIS Desktop.
- Conéctese a la geodatabase como usuario sde.
- 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.
- Especifique la conexión de la base de datos que creó en el paso 2 como Conexión de base de datos de entrada.
- Haga clic en Aceptar (ArcMap) o Ejecutar (ArcGIS Pro).
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.
- 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")
- Instale el tipo ST_Raster.
En este caso, el archivo adminconnect.sde se usa en la función CreateRasterType_management para establecer conexión con 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 ha instalado, si el archivo extproc.ora no se ha actualizado con la ruta de la biblioteca libst_raster_ora o si la biblioteca libst_raster_ora se ha copiado 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 extproc.oraENV. 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 Desktop (Standard o Advanced) y ejecutar herramientas de geoprocesamiento o puede utilizar una secuencia de comandos de Python ejecutada desde un cliente de ArcGIS Server o de ArcGIS Desktop (Standard o Advanced).
Ejecutar herramientas de geoprocesamiento
Si tiene acceso a ArcGIS Desktop, puede usar la herramienta Exportar palabra clave de configuración de geodatabase para exportar la configuración actual de la geodatabase a un archivo de texto, definir el parámetro RASTER_STORAGE como ST_Raster en el archivo de texto e importar el archivo de texto modificado usando la herramienta Importar palabra clave de configuración de geodatabase.
- Abra la herramienta Exportar palabra clave de configuración de geodatabase en ArcGIS Desktop.
- 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.
- Especifique una ubicación y el nombre de archivo para el archivo de texto que se va a crear.
- 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 en 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 defina el parámetro RASTER_STORAGE de esa palabra clave en ST_Raster.
- Guarde y cierre el archivo de texto.
- 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 para la input_database cuando ejecute las funciones ExportGeodatabsaeConfigurationKeyword_management y ImportGeodatabaseConfigurationKeyword_management.
- 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')
- 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 en 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 defina el parámetro RASTER_STORAGE de esa palabra clave en ST_Raster.
- Guarde y cierre el archivo de texto.
- 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.