Referência e Manual do Usuário

Mensagens retornadas pelas funções espaciais

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

Note to reviewers::
Cross-reference will be inserted here.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GSE3042EFigura 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


[ Início da Página | Página Anterior | Próxima Página | Índice | Índice Remissivo ]