Guide d'utilisation et de référence

db2gse.gse_import_shape

Cette procédure mémorisée permet d'importer un fichier SHAPE ESRI dans une base de données activée pour les opérations spatiales. Elle peut fonctionner selon deux modes :

Pour un exemple du code requis pour appeler cette procédure mémorisée, reportez-vous à la fonction C gseImportShape dans le programme exemple. Pour plus d'informations sur ce programme, consultez le Rédaction d'applications pour Extension Spatiale.

Lorsque vous importez un ensemble de représentations de formes ESRI, vous recevez au moins deux fichiers. Le nom de ces fichiers est identique mais leurs extensions sont différentes. Par exemple, les extensions des deux fichiers que vous recevez dans tous les cas sont .shp et .shx.

Pour recevoir les fichiers correspondant à un ensemble de représentations de formes, affectez le nom (commun) des fichiers au paramètre fileName. N'indiquez pas d'extension. Ainsi, tous les fichiers dont vous avez besoin (.shp, .shx, et autres, le cas échéant) seront importés.

Par exemple, supposons qu'un ensemble de représentations de formes ESRI soit stocké dans des fichiers appelés Lakes.shp et Lakes.shx. Pour importer ces représentations, il vous suffit d'affecter le nom Lakes au paramètre fileName.

Les fichiers de transfert SDE possèdent un nom mais pas d'extension. Par conséquent, pour importer un fichier de transfert SDE, affectez son nom, mais aucune extension, au paramètre fileName.

Autorisation

L'ID utilisateur sous lequel est appelée la procédure mémorisée doit disposer des droits ou privilèges suivants :

Paramètres d'entrée

Tableau 22. Paramètres d'entrée de la procédure mémorisée db2gse.gse_import_shape.
Nom Type de données Description
layerSchema VARCHAR(30) Nom du schéma auquel appartient la table ou la vue spécifiée dans le paramètre layerTable.

Ce paramètre peut prendre la valeur NULL.

Commentaire : Si vous n'affectez pas de valeur au paramètre layerSchema, il prendra par défaut l'ID utilisateur sous lequel est appelée la procédure mémorisée db2gse.gse_import_shape.

layerTable VARCHAR(128) Nom de la table dans laquelle le fichier SHAPE doit être chargé.

Ce paramètre ne peut pas prendre la valeur NULL.

layerColumn VARCHAR(30) Nom de la colonne enregistrée en tant que couche, dans laquelle les données du fichier SHAPE doivent être chargées.

Ce paramètre ne peut pas prendre la valeur NULL.

fileName VARCHAR(128) Nom du fichier SHAPE à importer.

Ce paramètre ne peut pas prendre la valeur NULL.

exceptionFile VARCHAR(128) Chemin d'accès et nom du fichier destiné au stockage des formes (SHAPE) dont l'importation a échoué. Il s'agit d'un nouveau fichier qui est généré au cours de l'exécution de la procédure db2gse.gse_import_shape.

Affectez un nom de fichier, mais pas d'extension, au paramètre exceptionFile.

Ce paramètre ne peut pas prendre la valeur NULL.

srId INTEGER Identificateur du système de références spatiales à associer à la couche dans laquelle les données du fichier SHAPE doivent être chargées.

Ce paramètre peut prendre la valeur NULL.

Commentaire : Si l'identificateur n'est pas spécifié, les transformations internes s'effectueront selon la résolution maximale possible pour le fichier SHAPE.

commitScope INTEGER Nombre d'enregistrements par point de contrôle.

Ce paramètre peut prendre la valeur NULL.

Paramètres de sortie

Tableau 23. Paramètres de sortie de la procédure mémorisée db2gse.gse_import_shape.
Nom Type de données Description
msgCode INTEGER Code associé aux messages susceptibles d'être renvoyés par le demandeur de la procédure mémorisée.
msgText VARCHAR(1024) Message d'erreur complet, tel que généré sur le serveur Extension Spatiale.


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]