Observatório de dados/BI/Exemplo/1.1/Dados

Reproduzindo aqui os dados de https://github.com/specialisterne-br/observatorio-dados

CSV

O conteúdo de um arquivo CSV deve antes de mais nada respeitar o padrão MIME text/plain codificando caracteres com UTF-8. Sobre esse primeiro nível de padronização, são então expressos os campos da tabela.

Padrão

O conteúdo de um arquivo CSV deve antes de mais nada respeitar o padrão MIME text/plain codificando caracteres com UTF-8. Sobre esse primeiro nível de padronização, são então expressos os campos da tabela. O arquivo exemplo01-bom.csv está neste formato, reproduzido abaixo:

C,T
28,82
32,87
7,90
16,98
4,101
1,104
...,...

Os campos são separados por vírgulas e a primeira linha é o cabeçalho.

Variantes

Devido à ambiguidade com virgula decimal nos números, as variantes mais utilizadas no Brasil são relativas aos separadores ";" ou tab. Devido à dominância de sistemas MS-Windows e à Microsoft não respeitar normas internacionais, é comum também o uso de caracteres em formato ISO-8859-1 ou Windows-1252. Abaixo o exemplo com separador ";"

C;T
28;82
32;87
7;90
16;98
4;101
1;104
...;...

Não-recomendados

Além das variantes de formato, há ainda a possibilidade de se expressar o dado tabular com outra estrutura. Por exemplo em múltiplas colunas, como em exemplo01-ruim.csv, reproduzido abaixo:

C,T,C,T,C,T,C,T,C,T
1,104,9,122,17,129,25,144,33,183
2,108,10,142,18,138,26,151,34,138
3,138,11,106,19,122,27,146,35,115
4,101,12,201,20,161,28,82,36,179
5,163,13,169,21,167,29,137,37,142
6,141,14,120,22,189,30,132,38,111
7,90,15,210,23,132,31,172,39,140
8,154,16,98,24,127,32,87,40,136

Esse tipo de estruturação não é permitida: cada coluna deve aparecer uma só vez. As colunas "C" e "T" acima apareceram 5 vezes.

JSON Tabular Data

JSON Tabular Data MUST be an array where each item in the array MUST be:

EITHER: an array where each entry in the array is the value for that cell in the table OR: an object where each key corresponds to the header for that row and the value corresponds to the cell value for that row for that header

Row Arrays

[
 ["C","T"],
 [28,82],[32,87], [7,90], [16,98], [4,101],[1,104],[11,106],
 [2,108],[38,111],[35,115],[14,120],[9,122],[19,122],[24,127],
 [17,129],[23,132],[30,132],[40,136],[29,137],[3,138],
 [18,138],[34,138],[39,140],[6,141],[10,142],[37,142],
 [25,144],[27,146],[26,151],[8,154],[20,161],[5,163],[21,167],
 [13,169],[31,172],[36,179],[33,183],[22,189],[12,201],[15,210]
]

Row Objects

[
 {"C":28,"T":82},{"C":32,"T":87},{"C":7,"T":90},{"C":16,"T":98},{"C":4,"T":101},{"C":1,"T":104},{"C":11,"T":106},
 {"C":2,"T":108},{"C":38,"T":111},{"C":35,"T":115},{"C":14,"T":120},{"C":9,"T":122},{"C":19,"T":122},{"C":24,"T":127},
 {"C":17,"T":129},{"C":23,"T":132},{"C":30,"T":132},{"C":40,"T":136},{"C":29,"T":137},{"C":3,"T":138},
 {"C":18,"T":138},{"C":34,"T":138},{"C":39,"T":140},{"C":6,"T":141},{"C":10,"T":142},{"C":37,"T":142},
 {"C":25,"T":144},{"C":27,"T":146},{"C":26,"T":151},{"C":8,"T":154},{"C":20,"T":161},{"C":5,"T":163},{"C":21,"T":167},
 {"C":13,"T":169},{"C":31,"T":172},{"C":36,"T":179},{"C":33,"T":183},{"C":22,"T":189},{"C":12,"T":201},{"C":15,"T":210}
]

Variantes não-recomendadas

Justamente por haver um grande número de combinações possíveis, mesmo variantes que aparentam ser eficientes devem ser evitadas, a título de padronização. Não daremos nomes a elas, rotulando apenas como "vnt1", "vnt2", etc.

vnt1

{
 "C":[28,32,7,16,4,1,11,2,38,35,14,9,19,24,17,23,30,40,29,3,18,34,39,6,10,37,25,27,26,8,20,5,21,13,31,36,33,22,12,15]
,"T":[82,87,90,98,101,104,106,108,111,115,120,122,122,127,129,132,132,136,137,138,138,138,140,141,142,142,144,146,151,154,161,163,167,169,172,179,183,189,201,210]
}

vnt2

{
 "header":["C","T"],
 "body": [
   [28,82],[32,87], [7,90], [16,98], [4,101],[1,104],[11,106],
   [2,108],[38,111],[35,115],[14,120],[9,122],[19,122],[24,127],
   [17,129],[23,132],[30,132],[40,136],[29,137],[3,138],
   [18,138],[34,138],[39,140],[6,141],[10,142],[37,142],
   [25,144],[27,146],[26,151],[8,154],[20,161],[5,163],[21,167],
   [13,169],[31,172],[36,179],[33,183],[22,189],[12,201],[15,210]
  ]
}

vnt3 ...