Installer ST_Raster dans SQL Server—Aide

Disponible avec une licence Standard ou Advanced.

Configurer l'instance SQL Server
Installer ST_Raster
Confirmer l'installation
Modifier la configuration de la géodatabase

ST_Raster est un type de données qui vous permet de stocker des données raster directement dans une table de géodatabase. Utilisez le type ST_Raster si vous avez besoin d'accéder aux données raster de votre géodatabase à l'aide de SQL.

Suivez ces instructions pour effectuer les opérations suivantes :

Configurer l'instance SQL Server.
Installer ST_Raster et vérifier que le type est présent dans la base de données.
Changer la configuration de la géodatabase afin que les utilisateurs puissent créer des données ST_Raster.

Configurer l'instance SQL Server

Connectez-vous à la machine hôte distante SQL Server.
Créez un dossier sur la machine SQL Server pour conserver la bibliothèque ST_Raster.
Vérifiez que SQL Server a accès au dossier.
Ajoutez le chemin absolu du dossier au chemin système.

Pour les deux prochaines étapes, vous avez besoin des fichiers libst_raster_sql.dll et createAssembly.sql. Vous pouvez les télécharger sur My Esri ou les copier à partir du répertoire <ArcGIS Server or ArcMap installation directory>\DatabaseSupport\SQLServer.

Collez les fichiers libst_raster_sql.dll et createAssembly.sql dans le dossier SQL Server que vous avez créé à l'étape 2.
A partir d'une invite MS-DOS sur la machine SQL Server, accédez à l'emplacement du fichier createAssembly.sql que vous avez copié à l'étape précédente et exécutez sqlcmd pour l'exécuter.
L'assembly doit être créé par un utilisateur sysadmin.
Voici la syntaxe à utiliser pour exécuter le script :
```
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
```
Par exemple
```
sqlcmd -E -S instance1 -d  ssgdb 
-v st_raster_path="c:\mygdblibraries\libst_raster_sql.dll" 
-v  admindb=ssgdb -i createAssembly.sql
```
Reportez-vous à la documentation sur Microsoft SQL Server pour en savoir plus sur l'utilitaire sqlcmd et sur son utilisation.

Une fois l'instance SQL Server configurée, procédez à l'installation de ST_Raster et modifiez la configuration de la géodatabase.

Installer ST_Raster

Vous pouvez exécuter l'outil Créer un type de raster à partir d'ArcGIS Desktop (Standard ou Advanced) ou exécuter un script Python à partir d'un client ArcGIS Server ou ArcGIS Desktop (Standard ou Advanced) pour installer le type ST_Raster.

Exécutez l'outil Créer un type de raster.

Si vous avez accès à ArcGIS Desktop (Standard ou Advanced), exécutez l'outil Créer un type de raster pour installer le type ST_Raster.

Démarrez le client ArcGIS Desktop.
Connectez-vous à la géodatabase en tant qu'administrateur de géodatabase.
Ouvrez l'outil Créer un type de raster.
Cet outil se trouve dans le jeu d'outils Geodatabase Administration de la boîte à outils Gestion des données.
Spécifiez la connexion à la base de données que vous avez créée à l'étape 2 comme Connexion à la géodatabase en entrée.
Cliquez sur OK (ArcMap) ou sur Exécuter (ArcGIS Pro).

Utiliser Python

Ensuite, vous pouvez exécuter un script Python pour créer un fichier de connexion à une base de données (.sde) qui permet d'établir une connexion à la géodatabase en tant qu'administrateur de géodatabase, et installer le type ST_Raster dans la géodatabase.

Ouvrez une fenêtre de commande, importez le module ArcPy, puis utilisez la fonction CreateDatabaseConnection_management pour créer un fichier de connexion à la base de données (.sde) qui permet d'établir une connexion à la géodatabase en tant qu'administrateur de géodatabase. Si vous vous connectez à l'aide de l'authentification de la base de données, veillez à enregistrer le nom d'utilisateur et le mot de passe avec le fichier de connexion.
Dans cet exemple, un fichier de connexion (adminconnect.sde) est créé dans C:\temp. La connexion à la géodatabase de projets sur l'instance SQL Server TEAMDATA est établie en tant qu'utilisateur SDE.
```
import arcpy
arcpy.CreateDatabaseConnection_management (r'c:/temp',"adminconnect.sde", "SQL_SERVER", "teamdata", "DATABASE_AUTH", "sde", "Cky00r", "SAVE_USERNAME", "projects")
```
Installez le type ST_Raster.
Dans ce cas, le fichier adminconnect.sde est utilisé par la fonction CreateRasterType_management pour établir une connexion à la géodatabase et installer le type ST_Raster :
```
arcpy.CreateRasterType_management (r'c:/temp/adminconnect.sde')
```

Confirmer l'installation

A l'aide de SQL Server Management Studio, connectez-vous en tant qu'utilisateur ayant accès à la base de données où vous avez installé ST_Raster, puis testez l'installation du type ST_Raster en exécutant l'instruction SELECT suivante sur cette base de données :

SELECT <dbo or sde>.st_raster_util_getVersion();

La requête doit renvoyer au moins 1 000.

Maintenant que vous avez confirmé que ST_Raster est installé, modifiez les paramètres du mot-clé de configuration.

Modifier la configuration de la géodatabase

Une fois ST_Raster installé dans la géodatabase, vous devez modifier la configuration de la géodatabase pour que les utilisateurs puissent utiliser ST_Raster lorsqu'ils créent des jeux de données raster et des catalogues d'images. Vous pouvez vous connecter à partir d'ArcGIS Desktop (Standard ou Advanced), puis exécuter des outils de géotraitement pour y parvenir ou utiliser un script Python à partir d'un client ArcGIS Server ou ArcGIS Desktop (Standard ou Advanced).

Exécuter les outils de géotraitement

Si vous avez accès à ArcGIS Desktop, vous pouvez utiliser l'outil Exporter un mot-clé de configuration de la géodatabase pour exporter les paramètres de configuration actuels de la géodatabase dans un fichier texte, définir le paramètre RASTER_STORAGE sur ST_Raster dans le fichier texte et importer le fichier texte modifié à l'aide de l'outil Importer un mot-clé de configuration de la géodatabase

Ouvrez l'outil Exporter un mot-clé de configuration de la géodatabase dans ArcGIS Desktop.
Utilisez la connexion à la base de données que vous avez créée pour installer ST_Raster en tant que Connexion à la géodatabase en entrée.
Spécifiez un emplacement et un nom de fichier pour le fichier texte à créer.
Ouvrez le fichier texte dans un éditeur de texte et définissez RASTER_STORAGE sur ST_Raster.
- Pour que tous les jeux de données raster et les catalogues d'images utilisent le type ST_Raster sans qu'il soit nécessaire de spécifier un mot-clé, modifiez le paramètre RASTER_STORAGE sous le mot-clé DEFAULTS.
- Si seuls certains des jeux de données raster et catalogues d'images doivent utiliser le type ST_Raster, créez un mot-clé personnalisé et définissez le paramètre RASTER_STORAGE pour ce mot-clé sur ST_Raster.
Enregistrez et fermez le fichier texte.
Importez le fichier texte modifié dans la géodatabase à l'aide de l'outil Importer un mot-clé de configuration de la géodatabase.

Utiliser Python

La fonction ArcPy ExportGeodatabsaeConfigurationKeyword_management permet d'exporter les paramètres de configuration actuels de la géodatabase dans un fichier texte et de modifier, puis enregistrer le fichier, et la fonction ImportGeodatabaseConfigurationKeyword_management permet d'importer les modifications dans la géodatabase.

Utilisez le fichier de connexion à la base de données que vous avez créé lors de l'installation de ST_Raster pour input_database lorsque vous exécutez les fonctions ExportGeodatabsaeConfigurationKeyword_management et ImportGeodatabaseConfigurationKeyword_management.

Exportez la configuration de la géodatabase actuelle.
Dans cet exemple, le fichier gdbconfig est exporté vers le dossier C:\temp.
```
arcpy.ExportGeodatabaseConfigurationKeyword_management (r'c:/temp/adminconnect.sde', r'c:/temp/gdbconfig.txt')
```
Ouvrez le fichier texte dans un éditeur de texte et définissez RASTER_STORAGE sur ST_Raster.
- Pour que tous les jeux de données raster et les catalogues d'images utilisent le type ST_Raster sans qu'il soit nécessaire de spécifier un mot-clé, modifiez le paramètre RASTER_STORAGE sous le mot-clé DEFAULTS.
- Si seuls certains des jeux de données raster et catalogues d'images doivent utiliser le type ST_Raster, créez un mot-clé personnalisé et définissez le paramètre RASTER_STORAGE pour ce mot-clé sur ST_Raster.
Enregistrez et fermez le fichier texte.

Importez le fichier mis à jour.

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

Vous pouvez utiliser vos nouveaux paramètres de configuration dès que les données sont créées.