Utilize este procedimento armazenado para importar um arquivo de formato do ESRI para um banco de dados que tenha sido ativado para operações espaciais. O procedimento armazenado pode operar de uma destas duas formas:
Para obter um exemplo do código para chamada deste procedimento armazenado, consulte a função C gseImportShape no programa de amostra. Para obter informações sobre este programa, consulte Gravando aplicações para Spatial Extender.
Ao importar um conjunto de representações de formato do ESRI, você recebe, pelo menos, dois arquivos. Todos os arquivos possuem o mesmo prefixo para o nome, mas extensões diferentes. Por exemplo, as extensões dos dois arquivos que você sempre recebe são .shp e .shx.
Para receber os arquivos de um conjunto de representações de formato, atribua o nome que os arquivos possuem em comum ao parâmetro fileName. Não especifique uma extensão. Dessa forma, você pode certificar-se de que todos os arquivos de que precisa - o arquivo .shp, o arquivo .shx e quaisquer outros que possam estar incluídos - serão importados.
Por exemplo, suponha que um conjunto de representações de formatos do ESRI esteja armazenado nos arquivos chamados Lakes.shp e Lakes.shx. Ao importar estas representações, você deve atribuir somente o nome Lakes no parâmetro fileName.
Os arquivos de transferência SDE possuem nomes, mas não extensões. Portanto, ao importar um arquivo de transferência SDE, você atribui seu nome, sem a extensão, ao parâmetro fileName.
A ID de usuário com a qual este procedimento armazenado é chamado deve conter um dos seguintes privilégios ou autoridades:
Parâmetros de entrada
Tabela 22. Parâmetros de entrada para o procedimento armazenado db2gse.gse_import_shape.
Nome | Tipo de dados | Descrição |
---|---|---|
layerSchema | VARCHAR(30) | Nome do esquema ao qual pertence a tabela ou view especificados no
parâmetro layerTable.
Este parâmetro pode ser nulo. Comentário: Se você não fornecer um valor para o parâmetro layerSchema, ele assumirá a ID de usuário com que o procedimento armazenado db2gse.gse_import_shape é chamado. |
layerTable | VARCHAR(128) | Nome da tabela na qual deve ser carregado o arquivo de formato é
importado.
Este parâmetro não pode ser nulo. |
layerColumn | VARCHAR(30) | Nome da coluna que foi registrada como camada na qual serão carregados os
dados de formato.
Este parâmetro não pode ser nulo. |
fileName | VARCHAR(128) | Nome do arquivo de formato que deverá ser importado.
Este parâmetro não pode ser nulo. |
exceptionFile | VARCHAR(128) | Caminho e nome do arquivo no qual serão armazenados os formatos que não
puderam ser importados. Este é um novo arquivo que será criado quando o
procedimento armazenado db2gse.gse_import_shape for
executado.
Atribua um nome do arquivo, sem a extensão, ao parâmetro exceptionFile. Este parâmetro não pode ser nulo. |
srId | INTEGER | Identificador do sistema de referência espacial a ser usado pela camada
na qual os dados de formato serão carregados.
Este parâmetro pode ser nulo. Comentário: Se este identificador não estiver especificado, a transformação interna será definida com a resolução máxima possível para o arquivo de formato. |
commitScope | INTEGER | Número de registros por ponto de verificação.
Este parâmetro que é I foi nulo. |
Parâmetros de saída
Tabela 23. Parâmetros de saída para o procedimento armazenado db2gse.gse_import_shape.
Nome | Tipo de dados | Descrição |
---|---|---|
msgCode | INTEGER | Código associado às mensagens que o responsável pela chamada deste procedimento armazenado poderá retornar. |
msgText | VARCHAR(1024) | Mensagem de erro completa, conforme construída no servidor Spatial Extender. |