Instalar ST_Raster en SQL Server—Ayuda

Disponible con una licencia Standard o Advanced.

Configurar instancia de SQL Server
Instalar ST_Raster
Confirmar la instalación
Modificar la configuración de la geodatabase

ST_Raster es un tipo de datos que permite almacenar datos ráster directamente en una tabla de geodatabase. Use el tipo ST_Raster si necesita acceder a los datos ráster de la geodatabase por medio de SQL.

Siga estas instrucciones para hacer lo siguiente:

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

Configurar instancia de SQL Server

Inicie sesión en el equipo host remoto de SQL Server.
Cree una carpeta en el equipo de SQL Server para almacenar la biblioteca ST_Raster.
Asegúrese de que SQL Server tiene acceso a la carpeta.
Agregue la ruta absoluta de la carpeta a la ruta del sistema.

En los dos próximos pasos, necesitará los archivos libst_raster_sql.dll y createAssembly.sql. Puede descargarlos desde My Esri o copiarlos desde el directorio <ArcGIS Server or ArcMap installation directory>\DatabaseSupport\SQLServer.

Pegue los archivos libst_raster_sql.dll y createAssembly.sql en la carpeta de SQL Server que creó en el paso 2.
En una ventana de comando de MS-DOS del equipo con SQL Server, vaya a la ubicación del archivo createAssembly.sql que copió en el paso anterior y ejecute sqlcmd para ejecutarlo.
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 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 el cliente de ArcGIS Desktop.
Conéctese a la geodatabase como administrador de la misma.
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 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")
```
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

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 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.