Guia

Conectar o Power BI

O OpenAGROs é um serviço OData v4 padrão. O Power BI descobre as coleções, os tipos e o que dá para filtrar sozinho.

1. Conectar

1. No Power BI Desktop: Obter dados → Feed OData.
2. Endereço: https://service.agrosti.com.br/odata/v1/ — com a barra no fim.
3. Escolha Básico e confirme.
4. Na tela de autenticação, escolha Anônimo. O token vai no cabeçalho, não no usuário e senha (próximo passo).

2. Enviar o token

O conector OData do Power BI não tem campo para token, então ele vai como cabeçalho no editor avançado. Em Transformar dados, abra o Editor Avançado da consulta e use:

let
    Fonte = OData.Feed(
        "https://service.agrosti.com.br/odata/v1/",
        null,
        [
            Headers = [#"Authorization" = "Bearer oag_SEU_TOKEN"],
            Implementation = "2.0"
        ]
    )
in
    Fonte

3. Escolher as coleções

O navegador lista as coleções que os escopos do seu token liberam. Comece pequeno: um fato e as dimensões dele. Um modelo com tudo carregado fica lento e não fica mais útil.

Para um painel de safra, por exemplo: Harvest, Subareas, Farms e Crops.

4. Relacionar

Os relacionamentos são por chave de texto, no formato fazenda|área|subárea. Todo fato traz farmKey, areaKey e subareaKey, e cada dimensão traz o id correspondente:

Relacione sempre por essas chaves de caminho. Elas carregam a hierarquia inteira, o que evita ambiguidade quando nomes de área ou de talhão se repetem entre fazendas.

5. Datas

Os campos de data chegam como data de verdade, não texto — então a hierarquia de tempo (ano, trimestre, mês) funciona direto. Se você for usar uma tabela de calendário própria, relacione-a ao campo date do fato.

Desempenho

• Filtre no servidor. Filtro aplicado no Power Query vira consulta no servidor; filtro aplicado depois baixa tudo antes. A referência de cada coleção marca quais campos aceitam filtro.
• Recorte por data ao importar. Uma safra costuma bastar, e a diferença é de segundos para minutos.
• PestScoutings exige janela de data. É a coleção de maior volume; sem filtro de data a API recusa com 400. É proposital: o recorte mantém a consulta rápida.
• Importação, não DirectQuery. A fonte é o sistema que a sua equipe usa o dia todo; consultar a cada interação de visual pesa na operação.