Guide d'utilisation et de référence

db2gse.gse_register_layer

Cette procédure mémorisée permet d'enregistrer une colonne spatiale en tant que couche. Lors du traitement de cette procédure, des informations sur la couche sont ajoutées à la vue du catalogue DB2GSE.GEOMETRY_COLUMNS. Pour plus d'informations sur cette vue, reportez-vous à la section DB2GSE.GEOMETRY_COLUMNS.

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

Cette procédure mémorisée ne fonctionne pas avec les types de tables suivants :

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 26. Paramètres d'entrée de la procédure mémorisée db2gse.gse_register_layer.
Nom Type de données Description
layerSchema INTEGER(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_register_layer.

layerTable VARCHAR(128) Nom de la table ou de la vue contenant la colonne qui est enregistrée en tant que couche.

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

layerColumn VARCHAR(128) Nom de la colonne qui est enregistrée en tant que couche. Pour une table, si la colonne indiquée n'existe pas, Extension Spatiale l'ajoute à l'aide de l'instruction ALTER. Pour une vue, la colonne doit déjà exister.

Une seule colonne peut être indiquée pour le paramètre layerColumn. Par conséquent, si vous voulez enregistrer plusieurs colonnes d'une table ou d'une vue en tant que couches, vous devez exécuter cette procédure mémorisée pour chacune de ces colonnes.

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

layerTypeName VARCHAR(64) Type de données de la colonne qui est enregistrée en tant que couche. Seuls les types de données fournis par Extension Spatiale sont acceptés. Vous devez indiquer le type de données en lettres majuscules ; par exemple :
ST_POINT

Vous n'avez pas besoin de spécifier un nom de schéma car ce dernier est automatiquement ajouté.

Ce paramètre ne peut pas prendre la valeur NULL s'il s'agit d'une colonne de table qui doit être créée pendant l'exécution de la procédure mémorisée. Si tel n'est pas le cas, s'il s'agit d'une colonne existant déjà au sein d'une table ou d'une vue, ce paramètre peut prendre la valeur NULL.

srId INTEGER Identificateur du système de références spatiales associé à la couche concernée.

Ce paramètre ne peut pas prendre la valeur NULL pour une couche de table. Extension Spatiale l'ignore lors de l'enregistrement d'une couche de vue.

geoSchema VARCHAR(30) Applicable en cas d'enregistrement d'une colonne de vue en tant que couche. Le paramètre geoSchema indique le schéma de la table sous-jacente de la vue à laquelle appartient la colonne.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de vue en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de table.

Les vues basées sur plusieurs tables de base ou sur d'autres vues ne sont pas prises en charge par ce paramètre.

Commentaire : Si vous n'affectez pas de valeur au paramètre geoSchema, il prendra par défaut la valeur du paramètre layerSchema.

geoTable VARCHAR(128) Applicable en cas d'enregistrement d'une colonne de vue en tant que couche. Le paramètre geoTable indique le nom de la table sous-jacente de la vue à laquelle appartient la colonne.

Les vues basées sur plusieurs tables de base ou sur d'autres vues ne sont pas prises en charge par ce paramètre.

Ce paramètre ne peut pas prendre la valeur NULL en cas d'enregistrement d'une colonne de vue en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de table.

geoColumn VARCHAR(128) Applicable en cas d'enregistrement d'une colonne de vue en tant que couche. Le paramètre geoColumn indique le nom de la colonne de table sous-jacente de la colonne de vue en question.

Les vues basées sur plusieurs tables de base ou sur d'autres vues ne sont pas prises en charge par ce paramètre.

Ce paramètre ne peut pas prendre la valeur NULL en cas d'enregistrement d'une colonne de vue en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de table.

nAttributes SMALLINT Nombre de colonnes contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

attr1Name VARCHAR(128) Nom de la première colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Si vous envisagez d'utiliser le géocodeur par défaut, vous devez stocker les adresses par rue dans la colonne attr1Name.

attr2Name VARCHAR(128) Nom de la seconde colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Si vous envisagez d'utiliser le géocodeur par défaut, vous devez stocker les noms de villes dans la colonne attr2Name.

attr3Name VARCHAR(128) Nom de la troisième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Si vous envisagez d'utiliser le géocodeur par défaut, vous devez stocker les noms ou abréviations des états dans la colonne attr3Name.

attr4Name VARCHAR(128) Nom de la quatrième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Si vous envisagez d'utiliser le géocodeur par défaut, vous devez stocker les codes postaux dans la colonne attr4Name.

attr5Name VARCHAR(128) Nom de la cinquième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr5Name.

attr6Name VARCHAR(128) Nom de la sixième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr6Name.

attr7Name VARCHAR(128) Nom de la septième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr7Name.

attr8Name VARCHAR(128) Nom de la huitième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr8Name.

attr9Name VARCHAR(128) Nom de la neuvième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr9Name.

attr10Name VARCHAR(128) Nom de la dixième colonne contenant les données source qui doivent être géocodées pour cette couche.

Ce paramètre peut prendre la valeur NULL en cas d'enregistrement d'une colonne de table en tant que couche. Extension Spatiale l'ignore lorsqu'il s'agit de l'enregistrement d'une couche de vue.

Le géocodeur par défaut ignore la colonne Attr10Name.

Paramètres de sortie

Tableau 27. Paramètres de sortie de la procédure mémorisée db2gse.gse_register_layer.
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.

Restrictions


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