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