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