Nome: (Deve descrever o nome por extenso de forma a descrever cada sigla utilizada para formar o nome da tabela.)

Esquema: (Nome do esquema proprietário da tabela.)

Descrição: (Deve descrever claramente o ente ou objeto que será armazenado em cada uma das linhas da tabela e que é caracterizado pelo seu conjunto de atributos/colunas. Deve conter os seguintes elementos adicionais:
(1) significado do(s) elemento(s) motivador(es) da criação da tabela;
(2) papel da tabela no sistema – se for necessário, fazer contextualização de outros conceitos/tabelas e
(3) mencionar se a tabela mantém hierarquias, históricos e se possui dependências.)

Sistema proprietário: (Sistema que cria e mantém a tabela.)

Área gestora do sistema: (Área responsável pelo sistema.)

Área gestora da informação: (Área responsável pela informação.)

Sistemas Usuários: (Sistemas que utilizam a tabela.)

Classificação da informação: (Descrição do nível de confidencialidade dos dados armazenados pela tabela, indicando a necessidade, a prioridade e o grau de proteção aplicáveis.)

Data marts usuários: (Data Marts que disponibilizam dados extraídos da tabela.)

Exemplo 1: preenchimento da documentação da tabela JUDICIARIO.PROCESSO.

Nome: Tabela de processo.

Esquema: JUDICIARIO

Descrição: Cada registro da tabela armazena dados relativos a um processo jurídico de competência do CNJ.

Os processos armazenados nesta tabela têm origem no CNJ ou são oriundos de instâncias inferiores. Esta tabela mantém informações históricas, contendo todos os processos que foram registrados no CNJ ao longo de sua existência.

Esta tabela é uma especialização da tabela OBJETO_INCIDENTE. Portanto, um processo é também um objeto armazenado naquela tabela, sendo identificado unicamente por um número sequencial comum armazenado no campo seq_objeto_incidente, que constitui a chave primária de ambas tabelas.

Sistema proprietário: -

Área gestora do sistema: SSPJ

Área gestora da informação: (Informar aqui a área responsável pela informação.)

Sistemas usuários: PROCESSAMENTO_INICIAL, AUDIO_VIDEO, BRS, CMS, CORP, DECISAO, EGAB, EJUD, EJUDCRIMINAL, EJUDREGSIMP, ECNJ, ECNJ_DIGITALIZACAO, ECNJ_PUBLICACAO, ECNJ_SESSOES, EXTRATO, IMAGEM, INFORMATIVO, INTEIROTEOR, INTERNET, INVENTARIO, JUDICIARIO, JULGAMENTO, LEXML, MAP, MDG, MTT, RPA, RTJ, SAAG, SPP, SPUB, CNJWD, SUNOPSIS, TVJUSTICA, WS_ACOMPANHAMENTO, WS_EPET, WS_INTEGRACAO, WS_PROCESSO_ELETRONICO.

Classificação da informação: Pública. Registros individuais podem ser classificados como 'ocultos', em 'segredo de justiça' ou 'sigilosos' - condição especificada pelo valor armazenado na coluna TIP_CONFIDENCIALIDADE.

Data marts usuários: DMJUD

Exemplo 2: preenchimento da documentação da tabela CNJ.FUNCIONARIO.

Nome: Tabela de funcionario.

Esquema: CNJ

Descrição: Armazena informações de servidores (concursados), estagiários e terceirizados que se encontram lotados no CNJ.

Os terceirizados e os estagiários são inseridos pela aplicação de manutenção de funcionários disponível na intranet e o servidores por triggers.

A tabela tem caráter histórico, pois deve manter todos os funcionários que já passaram pelo tribunal, inclusive reincidência destes, caso tenham mudado de órgão empregador, ou tenham sido exonerados e recontratados. Possui dependência direta da tabela CNJ.ORGAO_EMP, relacionamento essencial para composição da chave primária da tabela, que é formada pelo número de matrícula do funcionário em conjunto com o código do órgão empregador deste.

Sistema proprietário: Intranet – manutenção de funcionários.

Área gestora do sistema: SADM

Área gestora da informação:SRH

Sistemas usuários: SCE - Sistema de controle de estagiários, SGPT - Sistema de gerência de ponto, SIAJ, Global, SGRH – Gestão.

Em modelos multidimensionais, vejamos:

• A documentação de tabelas deve ser segmentada utilizando-se marcadores (tags) em estilo XML.

<COMENTARIO>
</COMENTARIO>
 
<ORIGEM>
</ORIGEM>

• A documentação das tabelas de dimensão deve especificar seu tipo:
  • Dimensão "normal" – novas linhas criadas, sem deleção;
  • SCD tipo 1 – dimensão de alteração lenta (slowly changing dimension) sem preservação de histórico;
  • SCD tipo 2 – dimensão de alteração lenta com preservação ilimitada de histórico, novas linhas criadas e coluna de status;
  • SCD tipo 3 – dimensão de alteração lenta com retenção de histórico limitada.