Aide

Installer ST_Raster dans SQL Server

Disponible avec une licence Standard ou Advanced.

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 :

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

Configurer l'instance SQL Server

  1. Connectez-vous à la machine hôte distante SQL Server.
  2. Créez un dossier sur le serveur SQL Server pour conserver la bibliothèque ST_Raster.

    Vérifiez que SQL Server a accès au dossier.

  3. Ajoutez le chemin absolu du dossier au chemin système.
  4. Copiez le fichier libst_raster_sql.dll du répertoire <ArcGIS client installation directory>\DatabaseSupport\SQLServer et collez-le dans le dossier SQL Server créé à l'étape 3.
  5. Copiez le fichier createAssembly.sql du répertoire <ArcGIS client installation directory>\DatabaseSupport\SQLServer et collez-le dans le dossier SQL Server créé à l'étape 3.
  6. A partir d'une invite MS-DOS, 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 for Desktop (Standard ou Advanced) ou exécuter un script Python à partir d'un client ArcGIS for Server ou ArcGIS for 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 for Desktop (Standard ou Advanced), exécutez l'outil Créer un type de raster pour installer le type ST_Raster.

  1. Démarrez ArcCatalog ou ArcMap.
  2. Connectez-vous à la géodatabase en tant qu'administrateur de géodatabase.
  3. 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.

  4. 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.
  5. Cliquez sur OK pour exécuter l'outil.

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.

  1. 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")

  2. 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 for 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 for Server ou ArcGIS for Desktop (Standard ou Advanced).

Exécuter les outils de géotraitement

Si vous avez accès à ArcGIS for 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.

  1. Ouvrez l'outil Exporter un mot-clé de configuration de la géodatabase dans ArcGIS for Desktop.
  2. 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.
  3. Spécifiez un emplacement et un nom de fichier pour le fichier texte à créer.
  4. 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.
  5. Enregistrez et fermez le fichier texte.
  6. 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 la base de données en entrée lorsque vous exécutez les fonctions ExportGeodatabsaeConfigurationKeyword_management et ImportGeodatabaseConfigurationKeyword_management.

  1. 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')

  2. 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.
  3. Enregistrez et fermez le fichier texte.
  4. 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.