Pular para o conteúdo
Octo × Fontes FDO Pedir um diagnóstico

Octo para fontes de dados FDO no MapGuide

Cada camada começa numa conexão. Quem decide o que ela expõe é você.

No MapGuide Open Source 4.0, todo mapa lê dados por um provedor FDO: PostGIS, SQL Server, Oracle, OGR, GDAL, SHP, SDF, SQLite, WMS, WFS. O Octo lê pela API mapagent os provedores e as fontes do repositório, acha senha em claro e conexão quebrada, leva arquivos para o banco com contagem conferida e mede filtros e junções em vez de supor. Trocar fonte em produção, criar objeto no banco e publicar dado pessoal ficam com o administrador, o DBA e o responsável técnico.

À esquerda, cinco fontes de dados ligadas por provedores FDO: PostGIS, SQL Server, Oracle, Shapefile e serviço WFS, uma delas com conexão falhando; no centro, o Octo; à direita, um mapa fictício com camadas de lotes, hidrografia e zoneamento e um terminal que chama a operação TESTCONNECTION da mapagent PostGIS OSGeo.PostgreSQL SQL Server OSGeo.SQLServerSpatial Oracle King.Oracle · falhou .shp Shapefile OSGeo.SHP Serviço WFS OSGeo.WFS SANEAMENTO · SEM CONEXÃO MAPA FICTÍCIO · 3 CAMADAS OK $ curl mapagent.fcgi? OPERATION=TESTCONNECTION ok Cadastro ok Hidrografia falhou Saneamento senha Tributos (em claro) GETFEATUREPROVIDERS · FDO 4.2 OCTO × FONTES FDO MAPGUIDE OS 4.0 F-04
Ilustração: provedores FDO alimentando camadas de um mapa e teste de conexão pela mapagent; dados fictícios.
MapGuide Open Source4.0anunciado em 12/10/2025, LGPL 2.1
FDO no instalador 4.04.2FDO_VERSION=4.2.0.0, GDAL interno 2.4.4
Provedores no instalador Windows133 desligados por padrão (ArcSDE, King Oracle, MySQL)
Fontes15listadas no fim da página
01

O que o Octo faz com as fontes FDO.

Seis entregas possíveis, tiradas do levantamento. Todas começam com conta de leitura, registram a versão do MapGuide, do FDO e de cada provedor, e vão para revisão de quem responde pelo servidor e pelo dado.

Inventário de fontes e provedores

Pergunta ao servidor quais provedores estão instalados (GETFEATUREPROVIDERS), lista os FeatureSource do repositório e lê provedor, parâmetros, extensões e junções de cada um.

Entrega: planilha por fonte, sem alterar nada

Senha em claro e credencial separada

Marca o FeatureSource com Password preenchido no XML e propõe %MG_USERNAME%/%MG_PASSWORD% com a credencial guardada à parte (MG_USER_CREDENTIALS), sem nunca copiar a senha.

Entrega: lista de achados para o administrador

Teste de conexão em lote

TESTCONNECTION em todas as fontes, fora do pico, com o resultado cruzado com as camadas e mapas que dependem de cada uma.

Entrega: mapa de impacto de cada conexão quebrada

Arquivos para o banco

Leva SHP e SDF para o PostGIS com ogr2ogr, índice espacial e contagem de origem e destino, e prepara o novo FeatureSource OSGeo.PostgreSQL em homologação.

Entrega: esquema de homologação + relatório de contagem

Junção medida

Acha AttributeRelate com ForceOneToOne escondendo 1:N, mede o tempo da camada e propõe view no banco quando o DBA concorda.

Entrega: tempos lado a lado e SQL revisável

Filtros que o provedor aceita

Cruza GETPROVIDERCAPABILITIES com os filtros e expressões das camadas, e testa LIKE, IN, NULL, INTERSECTS e WITHINDISTANCE pela mapagent.

Entrega: bateria de filtros com contagem e tempo
02

Oito braços, uma conexão conferida.

O mesmo ciclo do Octo, aplicado às fontes de dados do MapGuide. Cada braço tem um papel estreito; quem troca fonte em produção, cria objeto no banco e decide o que é publicado são pessoas.

  1. Descoberta

    Levanta o que já existe

    Provedores e versões do servidor, FeatureSources do repositório e as camadas e mapas que dependem de cada um.

  2. Dados

    Lê esquemas e chaves

    Classes, chaves de identidade, contexto espacial e cardinalidade das junções; aponta o 1:N escondido por ForceOneToOne.

  3. Segurança

    Cuida do acesso e do dado

    Senha em claro no XML, conta de banco com privilégio demais e dado pessoal em camada pública. Conta de leitura em todo o levantamento.

  4. Arquitetura

    Escolhe o caminho

    Provedor nativo ou OGR; view no banco ou AttributeRelate; arquivo na rede ou PostGIS; o que vai e o que não vai para o pool de conexões.

  5. Desenvolvimento

    Escreve o script

    Python, shell e SQL com log, só leitura por padrão, senha fora da linha de comando e a fonte de cada sintaxe anotada no arquivo.

  6. Revisão

    Confere pelo número

    Contagem de feições pela mapagent, tempo da janela do mapa e plano da consulta no banco. Ausência de erro não é conferência.

  7. Publicação

    Entrega em homologação

    Só com o seu ok, prepara o FeatureSource novo em Session:// ou numa pasta de homologação. A troca em Library:// de produção é feita por uma pessoa.

  8. Documentação

    Registra o que vale no seu servidor

    Versão do MapGuide, do FDO e do provedor, parâmetros sem senha, filtros testados, tempos medidos e quem aprovou cada troca.

O Octo trabalha com acesso de leitura e como apoio. Não troca fonte em produção, não cria conta nem objeto no banco sem o DBA, não altera o serverconfig.ini sem o administrador e não decide o que pode ser publicado.

03

Cada tarefa, o seu caminho.

O critério que o Octo usa para escolher, com o código e a documentação da versão instalada.

TarefaCaminhoObservação
Saber o que o servidor lêGETFEATUREPROVIDERS, GETPROVIDERCAPABILITIESNada é alterado
Listar e ler as fontesENUMERATERESOURCES + GETRESOURCECONTENTSenha mascarada na saída
Testar conexõesTESTCONNECTIONEm horário combinado
Ver esquema e classesDESCRIBEFEATURESCHEMA, GETCLASSES, GETSPATIALCONTEXTSContexto espacial de cada fonte
Contar e consultar feiçõesSELECTAGGREGATES, SELECTFEATURES com FILTEROperadores dependem do provedor
Escrever feiçõesWeb API (PHP, Java, .NET)Não exposto pela mapagent
Guardar credencial%MG_USERNAME%/%MG_PASSWORD% + MG_USER_CREDENTIALSSenha fora do XML
Arquivo para bancoogr2ogr + índice GIST + contagemGDAL da estação ≠ GDAL 2.4.4 do FDO
Junção entre fontesView no banco, quando o DBA concordaUseFdoJoinOptimization só vale na mesma fonte
Ajustar pool e cache[FeatureServiceProperties] do serverconfig.iniVale para o servidor inteiro
04

Do inventário ao padrão da casa.

Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.

Proposta, não promessa

1 Hoje

Inventário e achados

O Octo mostra o que o servidor lê, o que está quebrado e onde há senha exposta, sem mexer em nada.

  • Planilha de fontes por provedor
  • Conexões testadas e camadas afetadas
  • Lista de achados de segurança
Ganho: saber o tamanho do problema antes de mexer
2 Próximo

Migração e junções medidas

Arquivos levados ao banco com contagem conferida e junções lentas comparadas com views, sempre em homologação.

  • Esquema de homologação com relatório
  • FeatureSources novos com credencial separada
  • Bateria de filtros com tempos
Ganho: a equipe revisa números, não XML por XML
3 Depois

Padrão de fonte da casa

Modelos aprovados de FeatureSource por provedor, conferência automática a cada recurso novo e monitoramento de conexões.

  • Modelo de FeatureSource por banco
  • Checagem de senha em claro a cada publicação
  • Teste diário de conexões com alerta
Ganho: nenhuma camada nova nasce com o problema antigo
05

Confirmado em fonte.

Cada ponto abaixo tem fonte publicada pela OSGeo (página do projeto, listas oficiais, área de downloads), pelo repositório oficial ou pela Autodesk. Os exemplos são roteiros, não execuções. As fontes estão na seção seguinte.

4

pontos com fonte publicada, cada um com a referência indicada ao lado.

ConfirmadoMapGuide 4.0 e FDO 4.2
O MapGuide Open Source 4.0 foi anunciado em 12/10/2025; o instalador do ramo 4.0 declara FDO_VERSION=4.2.0.0. Os dois são LGPL 2.1.Fonte: lista mapguide-internals; MapGuide.wxs e License.txt no SVN da OSGeo
ConfirmadoProvedores do instalador
Treze provedores registrados no Windows; ArcSDE, King Oracle e MySQL desligados por padrão por exigirem bibliotecas externas. O script de compilação Linux não compila o ArcSDE.Fonte: MapGuide.wxs (ramo 4.0); build_fdo.sh:190 ("We never build ArcSDE provider")
ConfirmadoCredencial fora do XML
O código define %MG_USERNAME%, %MG_PASSWORD% e o dado de recurso MG_USER_CREDENTIALS, que substitui os marcadores pela credencial guardada.Fonte: ResourceDefs.cpp (ramo 4.0); referência da Web API, SetResourceData
ConfirmadoFiltro FDO e junções
Nulo é "propriedade NULL" (sem IS); há INTERSECTS, ENVELOPEINTERSECTS, WITHINDISTANCE e GEOMFROMTEXT. ForceOneToOne força 1:1 em relação 1:N.Fonte: yyFilter.y; FeatureSource-1.0.0.xsd
06

O que o Octo faz e o que fica com vocês.

O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.

O Octo prepara

Levanta, calcula, organiza e gera os documentos: scripts, inventários, relatórios e mapas.

Entrega: material pronto para conferir

A sua equipe confere

O profissional habilitado confere o que o Octo entregou antes de assinar. Se algo não fecha, volta para o Octo com a correção.

Etapa: conferência por quem assina

Quem assina

O Octo não assina. Projeto, laudo, ART/RRT, prestação de contas e qualquer documento oficial continuam assinados pelo profissional habilitado da empresa ou do órgão: aqui, o responsável técnico pelo mapa ou pelo sistema.

Assinatura: responsável técnico pelo mapa ou sistema
07

Fontes.

Código do MapGuide e do FDO no SVN da OSGeo e no espelho do GitHub, listas da OSGeo e documentação de GDAL e PostgreSQL usados no levantamento, consultados em 31/10/2026.

Suas fontes de dados, conferidas uma a uma.

O diagnóstico começa por um inventário das fontes do seu MapGuide e um teste de conexões, com conta de leitura, sem mexer em nada. Você recebe a lista do que está quebrado, do que está exposto e de como conferir, e decide com ela na mão.