Les messages ci-après sont émis par les fonctions spatiales. Leurs SQLCODES commencent par les lettres "GSE", suivies par un nombre compris entre 3001 et 3042.
Lorsqu'un message est émis par une fonction spatiale, la valeur SQLSTATE associée est également émise, mais pas son SQLCODE. Pour savoir comment déterminer le SQLCODE, reportez-vous au Tableau 34.
GSE3001E | Erreur système inconnue. |
Explication : Une erreur système inattendue s'est produite.
Réponse de l'utilisateur: Corrigez la syntaxe, puis appelez de nouveau la fonction. Si l'incident persiste, prenez contact avec votre service d'assistance technique.
GSE3002E | Chaîne de texte connue incorrecte. |
Explication : Une chaîne de texte connue incorrecte a été fournie en entrée à la fonction que vous avez appelée.
Réponse de l'utilisateur: Corrigez la chaîne, puis appelez de nouveau la fonction. Pour connaître le format correct des chaînes de texte connues, reportez-vous au manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3003E | SRID incorrect. |
Explication : L'identificateur de système de références spatiales (SRID) que vous avez essayé de transmettre à cette fonction ne figure pas dans le catalogue système de DB2 Extension Spatiale.
Réponse de l'utilisateur: Indiquez un SRID qui figure dans la vue du catalogue DB2GSE.SPATIAL_REF_SYS, ou créez un système de références spatiales avec le SRID indiqué.
GSE3004E | Mémoire insuffisante. |
Explication : La quantité de mémoire disponible était insuffisante. DB2 Extension Spatiale peut nécessiter jusqu'à un méga-octet de mémoire.
Réponse de l'utilisateur: Réallouez de la mémoire pour que DB2 Extension Spatiale en ait davantage à sa disposition. Si vous ne pouvez pas réallouer de la mémoire, augmentez physiquement la mémoire disponible dans votre système.
GSE3005E | Les SRID des géométries sont différents. |
Explication : Les géométries transmises à une fonction DB2 Extension Spatiale doivent partager le même identificateur de système de références spatiales (SRID).
Réponse de l'utilisateur: Recréez l'une des géométries pour que son système de références spatiales soit identique à celui des autres géométries.
GSE3006E | Chaîne binaire incorrecte. |
Explication : Une chaîne binaire connue ou ESRI construite de façon incorrecte a été fournie en entrée à la fonction que vous avez appelée.
Réponse de l'utilisateur: Reconstruisez la chaîne selon le format correct. Pour connaître le format correct, reportez-vous au manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3007E | Aucune géométrie correcte n'a été indiquée. |
Explication : Aucun type de géométrie correct n'a été transmis à la fonction appelée. Les types admis sont les suivants : point, ligne, polygone, multipoint, multiligne ou multipolygone.
Réponse de l'utilisateur: Soumettez à nouveau l'instruction SQL avec un type de géométrie correct.
GSE3008E | Il manque une parenthèse. |
Explication : Le nombre de parenthèses ouvrantes est différent du nombre de parenthèses fermantes dans la chaîne de représentation de texte connue.
Réponse de l'utilisateur: Entrez de nouveau la chaîne, en veillant à ce que le nombre de parenthèses fermantes soit identique au nombre de parenthèses ouvrantes.
GSE3009E | Trop de parties ont été indiquées. |
Explication : Le nombre de parties indiqué dans la chaîne binaire ou de texte est supérieur au nombre de parties fournies.
Réponse de l'utilisateur: Entrez de nouveau la chaîne en indiquant le nombre de parties correct.
GSE3010E | Type de géométrie incorrect. |
Explication : Un type de géométrie incorrect a été transmis à la fonction appelée. Par exemple, une ligne a été transmise à une fonction qui utilise des polygones en entrée.
Réponse de l'utilisateur: Transmettez à la fonction un type de géométrie qu'elle peut traiter, ou utilisez une fonction qui accepte le type de géométrie que vous avez essayé de transmettre.
GSE3011E | Chaîne de texte trop longue. |
Explication : La chaîne de texte de la géométrie dépasse la longueur maximum de 4000 caractères.
Réponse de l'utilisateur: La géométrie contient trop de détails pour pouvoir être convertie en texte. Toutefois, vous pouvez la convertir au format WKB ou au format binaire de forme ESRI.
GSE3012E | Valeur de paramètre incorrecte. |
Explication : Une valeur de paramètre incorrecte a été transmise à la fonction.
Réponse de l'utilisateur: Comparez la syntaxe de la fonction avec la syntaxe de référence fournie dans le manuel DB2 Extension Spatiale - Guide d'utilisation et de référence. Corrigez le paramètre incorrect, puis appelez de nouveau la fonction.
GSE3013E | Taille de grille incorrecte. |
Explication : L'une des spécifications incorrectes suivantes a été détectées :
Réponse de l'utilisateur: Utilisez la fenêtre Création d'un index ou la procédure mémorisée db2gse.gse_enable_idx pour indiquer une taille de grille correcte. Pour connaître les tailles de grille correctes, reportez-vous au manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3014E | Taille de grille trop petite. |
Explication : En raison de la taille de grille indiquée, chaque géométrie contient plus de 1000 cellules de grille.
Réponse de l'utilisateur: Utilisez la fenêtre Création d'un index ou la procédure mémorisée db2gse.gse_enable_idx pour augmenter la taille de grille ou pour ajouter un autre niveau de grille.
GSE3015E | La géométrie produite est incorrecte. |
Explication : Les paramètres entrés ont entraîné la création d'une géométrie incorrecte. Par exemple, les paramètres entrés avec la fonction LineFromShape ont produit une géométrie incorrecte, c'est-à-dire une géométrie qui ne respecte pas l'une de ses propriétés.
Réponse de l'utilisateur: Corrigez le paramètre, puis soumettez de nouveau la géométrie.
GSE3016E | Des géométries incorrectes ont été soumises. |
Explication : La fonction attendait deux géométries d'un type donné et ne les a pas reçu. Par exemple, la fonction ST_Union, qui attend deux géométries de même dimension, a reçu un point et une ligne, qui appartiennent à deux dimensions différentes.
Réponse de l'utilisateur: Indiquez en entrée des géométries acceptées par la fonction. Pour connaître les types de géométries acceptés par cette fonction, reportez-vous au manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3017E | Erreur d'intégrité de géométrie. |
Explication : La fonction ne peut pas traiter la géométrie qui lui a été transmise car une ou plusieurs des propriétés de cette géométrie violent une contrainte d'intégrité.
Réponse de l'utilisateur: Soumettez à nouveau la géométrie après avoir défini correctement ses propriétés. Pour plus d'informations concernant les propriétés des géométries, reportez-vous au manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3018E | Trop de points. |
Explication : La construction d'une géométrie a dépassé la limite de mémoire de 1 Mo. La géométrie comporte trop de points.
Réponse de l'utilisateur: Supprimez les points superflus. Pour optimiser les performances et l'utilisation de la mémoire, n'incluez que les points nécessaires au rendu de la géométrie. Tous les points superflus doivent être exclus.
GSE3019E | Géométrie trop petite. |
Explication : La géométrie renvoyée par la fonction ST_Difference, ST_Intersection, ST_SymmetricDiff ou ST_Union est trop petite pour être représentée par des valeurs du système de coordonnées en cours.
Réponse de l'utilisateur: Si vous avez besoin du résultat, utilisez la procédure mémorisée db2gse.gse_enable_sref pour augmenter la valeur du paramètre xyunits du système de références spatiales de la géométrie source. Recréez ensuite la table dans laquelle cette géométrie est stockée.
GSE3020E | La mémoire tampon est en dehors des limites. |
Explication : La fonction de mémoire tampon a créé une mémoire tampon en dehors du système de coordonnées.
Réponse de l'utilisateur: Réduisez la distance de la mémoire tampon, ou modifiez le système de coordonnées de la géométrie source. Dans la plupart des cas, la modification du système de coordonnées nécessite le rechargement du système de références spatiales.
GSE3021E | Facteur d'échelle incorrect. |
Explication : Un facteur d'échelle (unité XY, unité Z ou unité M) ne peut être inférieur à 1.
Réponse de l'utilisateur: Utilisez la procédure mémorisée db2gse.gse_enable_sref pour corriger les facteurs d'échelle de la vue du catalogue DB2GSE.SPATIAL_REF_SYS qui sont inférieurs à 1.
GSE3022E | Coordonnée en dehors des limites. |
Explication : Une coordonnée est trop grande ou trop petite pour tenir dans les limites du système de coordonnées.
Réponse de l'utilisateur: Déterminez si la coordonnée est correcte. Si elle est correcte, déterminez si elle tient dans les limites du système de coordonnées utilisé. Pour plus d'informations concernant ce système de coordonnées, consultez la vue du catalogue DB2GSE.COORD_REF_SYS.
GSE3023E | ID de système de coordonnées incorrect. |
Explication : Extension Spatiale ne peut pas valider l'identificateur de système de coordonnées indiqué.
Réponse de l'utilisateur: Déterminez si l'identificateur est répertorié dans la vue du catalogue DB2GSE.COORD_REF_SYS. S'il n'y figure pas, assurez-vous qu'il est correct et demandez à votre administrateur de base de données de l'enregistrer dans le catalogue système d'Extension Spatiale.
GSE3024E | Texte d'annotation incorrect. |
Explication : Le texte d'annotation qui définit le système de coordonnées indiqué ne peut pas être converti en une projection correcte.
Réponse de l'utilisateur: Examinez le texte d'annotation de ce système de coordonnées dans la vue du catalogue DB2GSE.COORD_REF_SYS. Déterminez s'il définit correctement le système. Pour plus d'informations à ce sujet, reportez-vous au chapitre relatif aux systèmes de coordonnées dans le manuel DB2 Extension Spatiale - Guide d'utilisation et de référence.
GSE3025E | Erreur de projection. |
Explication : Une erreur s'est produite lors d'une tentative de projection d'une géométrie.
Réponse de l'utilisateur: Assurez-vous que la géométrie ne sort pas du domaine admis pour la projection.
GSE3026E | Les anneaux d'un polygone se chevauchent. |
Explication : Les anneaux d'un polygone ne peuvent pas se chevaucher, mais il peuvent se couper à un point tangent.
Réponse de l'utilisateur: Corrigez les coordonnées du polygone, puis soumettez-le à nouveau.
GSE3027E | Pas assez de points. |
Explication : Les lignes doivent comporter au minimum deux points, et les polygones, au minimum quatre points.
Réponse de l'utilisateur: Soumettez à nouveau la géométrie avec le nombre de points correct.
GSE3028E | Polygone non fermé. |
Explication : Les coordonnées des points de début et de fin du polygone sont différentes.
Réponse de l'utilisateur: Modifiez la liste des coordonnées du polygone, en veillant à ce que les points de début et de fin soient identiques, puis soumettez à nouveau la géométrie.
GSE3029E | Anneau extérieur incorrect. |
Explication : L'anneau extérieur n'englobe pas l'anneau intérieur. L'anneau intérieur est situé en totalité à l'extérieur de l'anneau extérieur, sans aucun chevauchement.
Réponse de l'utilisateur: Assurez-vous que les coordonnées de l'anneau intérieur sont toutes situées à l'intérieur de l'anneau extérieur. Si l'anneau intérieur représente l'anneau extérieur d'un autre polygone, entrez la géométrie sous forme de multipolygone.
GSE3030E | Polygone sans surface. |
Explication : Une géométrie n'est un polygone que si ses coordonnées englobent deux dimensions de l'espace.
Réponse de l'utilisateur: Modifiez les coordonnées du polygone de manière à ce qu'elles englobent une surface, puis soumettez à nouveau le polygone. Sinon, si vous le souhaitez, soumettez une ligne.
GSE3031E | Le polygone contient une pointe. |
Explication : Seuls les points de début et de fin d'un polygone peuvent être identiques. Les autres coordonnées d'un anneau de polygone doivent toutes être différentes et englober ensemble une surface.
Réponse de l'utilisateur: Recherchez les paires de coordonnées dont les valeurs X et Y sont identiques. Modifiez ces points de sorte que le polygone n'englobe qu'une seule surface, puis soumettez à nouveau le polygone.
GSE3032E | Les anneaux extérieurs se chevauchent. |
Explication : Les anneaux extérieurs d'un multipolygone peuvent se couper à un point tangent, mais ils ne peuvent pas se chevaucher.
Réponse de l'utilisateur: Modifiez les coordonnées des anneaux extérieurs de manière à ce qu'ils ne se chevauchent pas, puis soumettez à nouveau le multipolygone.
GSE3033E | Le polygone se coupe. |
Explication : L'anneau d'un polygone ne peut se couper lui-même.
Réponse de l'utilisateur: Modifiez les coordonnées du polygone qui se coupe, puis soumettez à nouveau le polygone.
GSE3034E | Nombre de mesures incorrect. |
Explication : Le paramètre nombre de mesures de la chaîne binaire indique un nombre de mesures différent du nombre de mesures réellement fournies avec la chaîne.
Réponse de l'utilisateur: Modifiez le paramètre nombre de mesures pour qu'il corresponde au nombre de mesures réellement fournies avec la chaîne binaire.
GSE3035E | Nombre de parties incorrect. |
Explication : Le paramètre nombre de parties de la chaîne binaire indique un nombre de parties différent du nombre de parties réellement fournies avec la chaîne.
Réponse de l'utilisateur: Modifiez le paramètre nombre de parties pour qu'il corresponde au nombre de parties réellement fournies avec la chaîne binaire.
GSE3036E | Décalage de partie incorrect. |
Explication : Le paramètre décalage de partie de la chaîne binaire indique un décalage de partie différent du décalage de partie réellement fourni avec la chaîne.
Réponse de l'utilisateur: Modifiez le paramètre décalage de partie pour qu'il corresponde au décalage de partie réellement fourni avec la chaîne binaire.
GSE3037E | Erreur de projection. |
Explication : Une géométrie incorrecte a été rencontrée. Son séparateur de partie est incorrect.
Réponse de l'utilisateur: Prenez contact avec le service de maintenance IBM.
GSE3038E | BLOB trop petit. |
Explication : Le nombre d'octets de l'objet BLOB (Binary Large OBject) indiqué est inférieur au nombre d'octets de l'objet BLOB fourni.
Réponse de l'utilisateur: Indiquez une longueur d'objet BLOB égale au nombre d'octets contenus dans l'objet BLOB, puis appelez de nouveau la fonction.
GSE3039E | Type d'entité incorrect. |
Explication : Une géométrie incorrecte a été rencontrée. Son type d'entité est incorrect.
Réponse de l'utilisateur: Prenez contact avec le service de maintenance IBM.
GSE3040E | Ordre des octets incorrect. |
Explication : L'ordre des octets doit être 0 ou 1.
Réponse de l'utilisateur: Modifiez l'ordre des octets de manière à ce qu'il soit 0 pour little endian ou 1 pour big endian.
GSE3041E | Partie incorrecte. |
Explication : Un paramètre d'une fonction a tenté d'indexer une partie qui n'existe pas. Par exemple, la valeur 3 a été transmise à la fonction ST_GeometryN pour qu'elle renvoie le troisième point d'un multipoint qui n'en contient que deux.
Réponse de l'utilisateur: Corrigez le paramètre incorrect, puis appelez de nouveau la fonction.
GSE3042E | Géométrie vide. |
Explication : Une géométrie vide a été transmise à la fonction ST_AsBinary, alors qu'elle n'est pas admise comme entrée pour cette fonction.
Réponse de l'utilisateur: Modifiez l'instruction SQL que vous avez soumise, de manière à ce que seule une géométrie non vide puisse être transmise à la fonction ST_AsBinary. Par exemple, vous pouvez utiliser une clause WHERE et la fonction ST_IsEmpty pour éliminer les géométries vides.
Lorsqu'une fonction spatiale émet un message, DB2 affiche la forme abrégée du message et la valeur SQLSTATE correspondante dans le message SQL0443N. Par exemple :
DB21034E La commande a été traitée comme une instruction SQL car il ne s'agit pas d'une commande valide pour l'interpréteur de commandes. Le message SQL suivant a été renvoyé lors de son traitement. SQL0443N La routine "DB2GSE.ST_POINTFROMTEX" (nom spécifique "SQL000503150228187") a renvoyé un SQLSTATE d'erreur accompagné du texte de diagnostic "SRID incorrect". SQLSTATE=38601
Pour connaître le SQLCODE associé au SQLSTATE renvoyé dans le message SQL0443N, reportez-vous au Tableau 34. Pour connaître le texte complet associé au SQLCODE, recherchez ce dernier dans le présent chapitre ou entrez la commande suivante :
DB2 ? [SQLCODE]
Tableau 34. Valeurs SQLSTATE et SQLCODE des messages émis par les fonctions spatiales
Si la valeur SQLSTATE est : | . . . la valeur SQLCODE est : |
---|---|
38600 | GSE3002E |
38601 | GSE3003E |
38602 | GSE3004E |
38603 | GSE3005E |
38604 | GSE3006E |
38605 | GSE3007E |
38606 | GSE3008E |
38607 | GSE3009E |
38608 | GSE3010E |
38609 | GSE3011E |
38610 | GSE3012E |
38612 | GSE3013E |
38613 | GSE3014E |
38800 | GSE3015E |
38801 | GSE3016E |
38802 | GSE3017E |
38803 | GSE3018E |
38804 | GSE3019E |
38805 | GSE3020E |
38806 | GSE3021E |
38807 | GSE3022E |
38808 | GSE3023E |
38809 | GSE3024E |
38810 | GSE3025E |
38811 | GSE3026E |
38812 | GSE3027E |
38813 | GSE3028E |
38814 | GSE3029E |
38815 | GSE3030E |
38816 | GSE3031E |
38817 | GSE3032E |
38818 | GSE3033E |
38819 | GSE3034E |
38820 | GSE3035E |
38821 | GSE3036E |
38822 | GSE3037E |
38823 | GSE3038E |
38824 | GSE3039E |
38825 | GSE3040E |
38826 | GSE3041E |
38827 | GSE3042E |
38999 | GSE3043E |