Os códigos SQLCODEs das mensagens retornadas pelas funções espaciais começam com as letras "GSE", seguidos de números no intervalo de 3.001 a 3.042.
Quando uma mensagem é retornada por uma função espacial, seu valor SQLSTATE associado também é retornado, mas não seu código SQLCODE. Para obter informações sobre como encontrar o código SQLCODE, consulte a página
GSE3001E | Falha desconhecida do sistema. |
Explicação: Ocorreu um erro inesperado.
Resposta do Usuário: Corrija a sintaxe e invoque a função novamente. Se o problema ainda for observado, entre em contato com o suporte técnico.
GSE3002E | Cadeia de Texto Convencional inválida |
Explicação: Uma cadeia de Texto Convencional inválida foi inserida como uma entrada para a função invocada.
Resposta do Usuário: Corrija a cadeia e invoque a função novamente. Para determinar o formato adequado para cadeias de Texto Convencional, consulte Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3003E | SRID inválido |
Explicação: O identificador do sistema de referências espaciais (SRID) que você tentou passar para essa função não está listado no catálogo do sistema DB2 Spatial Extender.
Resposta do Usuário: Especifique um SRID que esteja registrado atualmente na exibição de catálogo DB2GSE.SPATIAL_REF_SYS ou crie um sistema de referências espaciais que tenha o SRID que você deseja especificar.
GSE3004E | Memória insuficiente |
Explicação: Não há memória disponível suficiente. O DB2 Spatial Extender requer no máximo um megabyte de memória.
Resposta do Usuário: Realoque a memória para que haja maior disponibilidade para o DB2 Spatial Extender. Se não for possível realocar a memória, adicione mais memória física.
GSE3005E | Os SRIDs geométricos são diferentes. |
Explicação: As figuras geométricas passadas para uma função do DB2 Spatial Extender devem compartilhar o mesmo identificador do sistema de referências espaciais (SRID).
Resposta do Usuário: Crie novamente uma das figuras geométricas para que o seu sistema de referências espaciais corresponda as do outro.
GSE3006E | Cadeia binária inválida. |
Explicação: Uma cadeia Binária Convencional ou Binária ESRI foi inserida como uma entrada para a função que você invocou.
Resposta do Usuário: Reconstrua a cadeia com o formato correto. Para determinar o formato correto, consulte Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3007E | Figura geométrica válida não especificada. |
Explicação: Não foi passado um tipo válido de figura geométrica para a função que você invocou. Os tipos válidos são figura geométrica, ponto, segmento de reta, polígono, pontos múltiplos, segmentos de reta múltiplos e polígonos múltiplos.
Resposta do Usuário: Submeta novamente a instrução SQL com um tipo de figura geométrica válido.
GSE3008E | Parênteses díspares. |
Explicação: O número de parênteses esquerdos na cadeia de representação de Texto Convencional não é igual ao número de parênteses direitos.
Resposta do Usuário: Insira a cadeia novamente, fornecendo um número de parênteses direitos correspondente aos esquerdos.
GSE3009E | Excesso de partes especificadas. |
Explicação: O número de partes indicado na cadeia de texto ou binária é maior que o número real de partes fornecidas.
Resposta do Usuário: Insira a cadeia novamente com o número correto de partes.
GSE3010E | Tipo de figura geométrica incorreto. |
Explicação: O tipo incorreto de figura geométrica foi passado para a função que você invocou. Por exemplo, um segmento de reta pode ter sido passado para uma função que recebe polígonos como uma entrada.
Resposta do Usuário: Passe para a função um tipo de figura geométrica que a função possa processar ou utilize uma função que aceite o tipo de figura geométrica que você deseja passar.
GSE3011E | A cadeia de texto é muito longa. |
Explicação: A cadeia de texto de figura geométrica excede o comprimento máximo de 4.000 caracteres.
Resposta do Usuário: A figura geométrica contém detalhes em excesso para ser convertida em texto. No entanto, você tem a alternativa de convertê-la num formato WKB ou num formato binário de formato ESRI.
GSE3012E | Valor de parâmetro inválido. |
Explicação: Um parâmetro inválido foi passado para a função.
Resposta do Usuário: Compare a sintaxe da função com a listada no Manual e Referência do Usuário do DB2 Spatial Extender. Corrija o parâmetro inválido e submeta a função novamente.
GSE3013E | Tamanho de grade inválido. |
Explicação: Uma das seguintes especificações inválidas foi feita:
Resposta do Usuário: Utilize a janela Criar Índice ou o procedimento armazenado db2gse.gse_enable_idx para especificar um tamanho de grade válido. Para obter informações sobre tamanhos de grades válidos, consulte Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3014E | Tamanho da grade muito pequeno. |
Explicação: O tamanho da grade que foi especificado resulta em mais de 1.000 células de grade por figura geométrica.
Resposta do Usuário: Utilize a janela Criar Índice ou o procedimento armazenado db2gse.gse_enable_idx para aumentar o tamanho da grade ou adicionar outro nível de grade.
GSE3015E | Figura geométrica inválida produzida. |
Explicação: Os parâmetros inseridos produziram uma figura geométrica inválida. Por exemplo, os parâmetros inseridos com a função LineFromShape produzem uma figura geométrica inválida. Figura geométrica inválida é a que viola uma propriedade geométrica.
Resposta do Usuário: Corrija o parâmetro e submeta a figura geométrica novamente.
GSE3016E | Erro ao submeter figura geométrica. |
Explicação: A função aguardava duas figuras geométricas de um certo tipo e não as recebeu. Por exemplo, a ST_Union esperava duas figuras geométricas da mesma dimensão e recebeu um ponto e um segmento de reta, que têm dimensões diferentes.
Resposta do Usuário: Especifique figuras geométricas aceitas pela função como entradas válidas. Para determinar quais tipos de figuras geométricas são válidos para essa função, consulte Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3017E | Erro de integridade de figura geométrica. |
Explicação: A função não pode processar a figura geométrica que lhe foi passada, porque uma ou mais propriedades da figura geométrica violam uma limitação de integridade.
Resposta do Usuário: Submeta a figura geométrica novamente com suas propriedades definidas de modo correto. Para obter informações sobre as propriedades das figuras geométricas, consulte o Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3018E | Pontos em excesso. |
Explicação: A construção de uma figura geométrica excedeu o limite de armazenamento de 1 MB; a figura geométrica tem pontos em excesso.
Resposta do Usuário: Remova os pontos desnecessários. Por considerações de desempenho e armazenamento, experimente incluir apenas os pontos necessários para produzir uma figura geométrica. Todos os pontos não-essenciais devem ser excluídos.
GSE3019E | A figura geométrica é muito pequena. |
Explicação: A figura geométrica retornada pela função ST_Difference, ST_Intersection, ST_SymmetricDiff, ou ST_Union é muito pequena para ser representada pelos valores do sistema de coordenadas atual.
Resposta do Usuário: Se um resultado for necessário, utilize o procedimento armazenado db2gse.gse_enable_sref para incrementar o parâmetro xyunits do sistema de referências espaciais da figura geométrica de origem. Em seguida, crie novamente a tabela na qual a figura geométrica de origem está armazenada.
GSE3020E | Buffer fora dos limites. |
Explicação: A função de buffer criou um buffer fora do sistema de coordenadas.
Resposta do Usuário: Reduza a distância do buffer ou altere o sistema de coordenadas da figura geométrica. Na maioria dos casos, a alteração do sistema de coordenadas requer a recarga do sistema espacial.
GSE3021E | Fator de escala inválido. |
Explicação: Um fator de escala (uma unidade XY, uma unidade Z ou uma unidade M) não pode ser inferior a 1.
Resposta do Usuário: Utilize o procedimento armazenado db2gse.gse_enable_sref para corrigir todos os fatores de escala na exibição de catálogo DB2GSE.SPATIAL_REF_SYS que sejam inferiores a 1.
GSE3022E | Coordenada fora dos limites. |
Explicação: Uma coordenada é muito grande ou muito pequena para caber nos limites do sistema de coordenadas.
Resposta do Usuário: Verifique se a coordenada está correta. Se estiver, verifique se cabe nos limites do sistema de coordenadas que você está utilizando. Para obter informações sobre esse sistema de coordenadas, consulte a exibição de catálogo DB2GSE.COORD_REF_SYS.
GSE3023E | ID do sistema de coordenadas inválido. |
Explicação: O Spatial Extender não pode validar o identificador do sistema de coordenadas especificado.
Resposta do Usuário: Verifique se o identificador está listado na exibição de catálogo DB2GSE.COORD_REF_SYS. Se não estiver, verifique se está correto e peça ao administrador do banco de dados que o registre no catálogo do sistema Spatial Extender.
GSE3024E | Texto de anotação inválido. |
Explicação: O texto de anotação que define o sistema de coordenadas especificado não pode ser convertido numa projeção válida.
Resposta do Usuário: Observe o texto de anotação para esse sistema de coordenadas na exibição de catálogo DB2GSE.COORD_REF_SYS. Verifique se o texto define o sistema adequadamente. Para obter informações de ajuda, consulte o capítulo sobre sistemas de coordenadas em Manual e Referência do Usuário do DB2 Spatial Extender.
GSE3025E | Erro de Projeção |
Explicação: Ocorreu um erro durante uma tentativa de projetar uma figura geométrica.
Resposta do Usuário: Certifique-se de que a figura geométrica esteja dentro do domínio legal da projeção.
GSE3026E | Contornos do polígono sobrepostos. |
Explicação: Os contornos de um polígono não podem se sobrepor, mas podem fazer interseção tangencial.
Resposta do Usuário: Corrija as coordenadas do polígono e o submeta novamente.
GSE3027E | Muito poucos pontos. |
Explicação: Um segmento de reta deve consistir em pelo menos dois pontos e os polígonos devem consistir em pelo menos quatro pontos.
Resposta do Usuário: Submeta a figura geométrica novamente com o número de pontos correto.
GSE3028E | O polígono não está fechado. |
Explicação: As coordenadas dos pontos inicial e final do polígono não são as mesmas.
Resposta do Usuário: Edite a lista de coordenadas do polígono, certificando-se de que os pontos inicial e final sejam iguais, e submeta-o novamente.
GSE3029E | Contorno exterior inválido. |
Explicação: O contorno exterior não contém o contorno interior. O contorno interior está completamente fora do contorno exterior, sem nenhuma sobreposição.
Resposta do Usuário: Certifique-se de que as coordenadas do contorno interior estejam completamente dentro do contorno exterior. Se o contorno interior realmente representar o contorno exterior de outro polígono, insira a figura geométrica como um polígono múltiplo.
GSE3030E | O polígono não tem área. |
Explicação: Uma figura geométrica é um polígono somente quando suas coordenadas dividem o espaço em duas dimensões.
Resposta do Usuário: Edite as coordenadas do polígono para conterem uma área e submeta o polígono novamente. Ou, se for apropriado, submeta um segmento de reta.
GSE3031E | O polígono contém um encavalamento. |
Explicação: Somente os pontos inicial e final de um polígono podem ser idênticos. Todas as outras coordenadas de um contorno de polígono devem ser diferentes e, em conjunto, conter uma área.
Resposta do Usuário: Procure pares coordenados que tenham valores de X e Y idênticos. Edite esses pontos de modo que o polígono contenha uma única área e, em seguida, submeta o polígono novamente.
GSE3032E | Contornos exteriores sobrepostos. |
Explicação: Os contornos exteriores de um polígono múltiplo podem fazer interseção tangencial, mas não podem se sobrepor.
Resposta do Usuário: Edite as coordenadas dos contornos exteriores para que não se sobreponham e submeta o polígono novamente.
GSE3033E | O polígono faz interseção com ele mesmo. |
Explicação: O contorno de um polígono não pode fazer interseção com ele mesmo.
Resposta do Usuário: Edite as coordenadas do contorno que está fazendo interseção com ele mesmo e submeta o polígono novamente.
GSE3034E | Número de medidas inválido. |
Explicação: O parâmetro número de medidas da cadeia binária contém um número de medidas diferente do fornecido com a cadeia.
Resposta do Usuário: Edite o parâmetro número de medidas para que corresponda ao número fornecido na cadeia binária.
GSE3035E | Número de partes inválido. |
Explicação: O parâmetro número de partes da cadeia binária especificou um número de partes diferente do fornecido com a cadeia.
Resposta do Usuário: Edite o parâmetro número de partes para que corresponda ao número fornecido na cadeia binária.
GSE3036E | Deslocamento de partes inválido. |
Explicação: O parâmetro deslocamento de partes da cadeia binária especificou um deslocamento de partes diferente do fornecido na cadeia.
Resposta do Usuário: Edite o parâmetro deslocamento de partes para que corresponda aos deslocamentos de partes fornecidos com a cadeia binária.
GSE3037E | Erro de projeção. |
Explicação: Uma figura geométrica ilegal foi encontrada; seu separador de partes é inválido.
Resposta do Usuário: Entre em contato com o representante de serviços IBM.
GSE3038E | BLOB muito pequeno. |
Explicação: O número de bytes no objeto grande binário (BLOB- binary large object) é inferior ao número de bytes no BLOB fornecido.
Resposta do Usuário: Torne o comprimento do BLOB igual ao número de bytes no BLOB e submeta a função novamente.
GSE3039E | Tipo de entidade inválido. |
Explicação: Uma figura geométrica ilegal foi encontrada; seu tipo de entidade associado é inválido.
Resposta do Usuário: Entre em contato com o representante de serviços IBM.
GSE3040E | Ordem de bytes inválida |
Explicação: A ordem de bytes deve ser 0 ou 1.
Resposta do Usuário: Edite a ordem de bytes para que seja 0 para little endian ou 1 para big endian.
GSE3041E | Parte inválida. |
Explicação: Um parâmetro de função indexou uma parte inexistente. Por exemplo, esse erro pode ocorrer quando a função ST_GeometryN recebeu um 3 para retornar um terceiro ponto em pontos múltiplos, quando esses contêm apenas dois pontos.
Resposta do Usuário: Edite o parâmetro e submeta a função novamente.
GSE3042E | Figura geométrica vazia. |
Explicação: Uma figura geométrica vazia foi passada para a função ST_AsBinary, embora não seja permitida como entrada para essa função.
Resposta do Usuário: Edite a instrução SQL que você submeteu para que somente figuras geométricas não-vazias sejam passadas para a função ST_AsBinary. Por exemplo, pode-se usar uma cláusula WHERE para desqualificar figuras geométricas vazias com a função ST_IsEmpty.
Quando uma função espacial retorna uma mensagem, o DB2 exibe a forma abreviada da mensagem e o valor SQLSTATE correspondente dentro da mensagem SQL0443N. Veja um exemplo:
DB21034E O comando foi processado como uma instrução SQL, porque não era um comando válido do Processador de Linha de Comandos. Durante o processamento de SQL foi retornado: SQL0443N A rotina "DB2GSE.ST_POINTFROMTEX" (nome específico "SQL000503150228187") retornou um erro SQLSTATE com o texto de diagnóstico "SRID Inválido". SQLSTATE=38601
Para descobrir qual SQLCODE está associado à instrução SQLSTATE retornada na mensagem SQL0443N, consulte Tabela 34. Para ver o texto completo associado ao SQLCODE, consulte esse capítulo ou emita o seguinte comando:
DB2 ? [SQLCODE]
Tabela 34. Valores SQLSTATE e SQLCODE de mensagens retornadas pelas funções espaciais
Se o valor de SQLSTATE for: | . . . O SQLCODE será: |
---|---|
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 |