Adicionar recurso e documentar seus metadados⚓︎
Após criar o conjunto, você será redirecionado para a página (Home /Organizations / (sua organização) / (seu conjunto de dados) / Edit / Add New Resource).
Selecione o arquivo em sua máquina e clique no botão 'Carregar' (Load):
tela add new resource
O nome do arquivo deve ser em letras minúsculas, sem espaços, separado por traços '-', sem caracteres especiais, acentos ou letras maiúsculas (nome legível por máquina). Após clicar em load (carregar), o CKAN irá preencher o campo 'nome' automaticamente como o nome do arquivo que for carregado por você.
Além disso, o CKAN vai inferir as colunas do arquivo tabular e carregar as informações sobre os metadados de cada uma, para que você preencha:
tela inferência metadados
Note que o nome do cabeçalho de cada coluna aparece, tal qual está registrado no arquivo carregado. Os nomes das colunas (ou cabeçalhos/headers devem ser preferencialmente legíveis por máquina). Também há uma visualização prévia dos valores de cada coluna, ao clicar em Preview item, abaixo do nome:
tela preview item
Cada caixa pertence a uma coluna, que deve ter, pelo menos Título (Title), Descrição (Description), Tipo (Type) e Formato (Format). Clique em Editar metadado (Edit Metadata) para editar os metadados de cada coluna:
tela inferência metadados coluna
O título e a descrição devem ser legíveis por pessoas, então comportam acentos, espaços, maiúsculas, caracteres especiais.
O tipo e o formato dos valores de cada coluna são inferidos automaticamente pelo CKAN, mas você pode alterá-los, se julgar que um outro representa melhor o dado de determinada coluna.
Mais detalhes sobre as especificações de tipos e formatos de coluna nas Especificações da Frictionless Data('dados sem fricção').
Você pode ampliar a qualidade da documentação dos teus dados, adicionando propriedades:
- requerido (required), se for obrigatório ter dados na coluna (não pode haver campo 'NULL');
- valores únicos (unique), se todos os valores da coluna forem únicos;
- chaves primária (Primary Key) e/ou estrangeira (Foreign Key), para indicar variáveis (coluna) que conectam tabelas (modelo entidade-relacionamento/M.E.R.)
- extras (clicar no botão '+ Add Metadata'):
- max/min (valores mínimo e máximo, se numeral)
- pattern (expressão regular, com sintaxe definida no XML Schema regular expression syntax)
- enum (lista exaustiva que indica todos os possíveis valores de uma coluna)
tela Add Metadata
Mais informações sobre a aplicabilidade de cada metadado restritivo (constraints) em [Frictionless Table Schema Fields Constraints](https://specs.frictionlessdata.io/table-schema/#constraints.
Para qualquer arquivo (recurso ou Resource Data) incluído, também são necessários título (Title) e descrição (Description). Além disso, o formato (Format), tipo (type) e encoding também são obrigatórios, mas já vêm inferidos pelo CKAN.
tela metadados recurso
Você também pode adicionar mais metadados do recurso, clicando no botão '+Add Metadata'
tela add metadata
Se o conjunto contiver somente um recurso, clique no botão 'Validate', para checar o resultado na porção superior da página. Aparecendo o texto em verde 'Successfully saved resource', pode clicar no botão 'Publish', no canto inferior da página (o botão 'PUBLISH' fica esmaecido, e somente se torna acessível, num tom azul-escuro, após você clicar em 'Validate').
OBS.IMPORTANTE! o texto que aparece após clicar no botão 'Validate' não corresponde ao resultado da checagem se os dados estão de acordo com os metadados informados, mas somente que o processo aconteceu. O resultado fica numa 'badge' (ou etiqueta) de validação na página inicial de cada conjunto, com os dizeres DATAPACKAGE VALID (válido) ou DATAPACKAGE INVALID (inválido).
Adicionar mais recursos e editar metadados⚓︎
Para adicionar mais um recurso, clique no botão '+ Add Resource' no final da página:
tela add resource
Se você já tiver publicado um conjunto apenas com o primeiro recurso, pode voltar a adicionar mais recursos, após clicar no conjunto, e no botão Gerenciar (Manage). Então, na tela abaixo, clicar em '+Add new resource':
tela add new resource pos publish
Incluir um relacionamento (chaves primária 'primary Key'e estrangeira 'foreign Key')⚓︎
Serve para representar o relacionamento entre colunas com mesmos valores (instâncias) de duas tabelas (recursos) que dizem respeito a um mesmo fenômeno. A visualização das referências entre as colunas que se relacionam podem ser notadas nas setas deste conjunto-teste. As chaves são incluídas nas caixas de adição de metadados, como as telas a seguir mostram:
primary Key
foreign Key
Created: April 28, 2023 21:25:52