ArcMap

Instalar ST_Raster en SQL Server

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.

Siga estas instrucciones para hacer lo siguiente:

  1. Configure la instancia de SQL Server.
  2. Instale ST_Raster y confirme que el tipo está presente en la base de datos.
  3. Cambie la configuración de la geodatabase para que los usuarios puedan crear datos ST_Raster.

Configurar instancia de SQL Server

  1. Inicie sesión en el equipo host remoto de SQL Server.
  2. Cree una carpeta en el servidor de SQL Server para almacenar la biblioteca ST_Raster.

    Asegúrese de que SQL Server tiene acceso a la carpeta.

  3. Agregue la ruta absoluta de la carpeta a la ruta del sistema.
  4. Copie el archivo libst_raster_sql.dll del directorio <ArcGIS client installation directory>\DatabaseSupport\SQLServer y péguelo en la carpeta de SQL Server que ha creado en el paso 3.
  5. Copie el archivo createAssembly.sql del directorio <ArcGIS client installation directory>\DatabaseSupport\SQLServer y péguelo en la carpeta de SQL Server que ha creado en el paso 3.
  6. En una ventana de comando de MS-DOS, navegue hasta la ubicación del archivo createAssembly.sql que ha copiado en el paso anterior y ejecute sqlcmd.

    Un usuario sysadmin debe crear el ensamblado.

    A continuación se muestra la sintaxis para ejecutar la secuencia de comandos:

    sqlcmd -E -S <SQL Server instance> -d  <database name> 
-v st_raster_path="<full path to folder created in step 3>\libst_raster_sql.dll" 
-v  admindb=<database name> -i createAssembly.sql

    Por ejemplo:

    sqlcmd -E -S instance1 -d  ssgdb 
-v st_raster_path="c:\mygdblibraries\libst_raster_sql.dll" 
-v  admindb=ssgdb -i createAssembly.sql

    Consulte la documentación de Microsoft SQL Server si desea obtener información sobre la utilidad sqlcmd y sus usos.

Una vez configurada la instancia de SQL Server, continúe con la instalación de ST_Raster y modifique la configuración de la geodatabase.

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. Iniciar ArcMap o ArcCatalog.
  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 geodatabase de proyectos de la instancia teamdata de SQL Server como usuario sde.

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

  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

Cuando utilice SQL Server Management Studio, conéctese como cualquier usuario que tenga acceso a la base de datos en la que instaló ST_Raster y pruebe la instalación del tipo ST_Raster mediante la ejecución de la siguiente declaración SELECT en esa base de datos:

SELECT <dbo or sde>.st_raster_util_getVersion();

La consulta debería dar como resultado al menos 1000.

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.