Data Studio

Acesso e auditoria

O acesso começa com data.read. As operações de alteração dependem de permissões explícitas, atribuídas por perfil ou exceção individual:

Toda alteração estrutural, importação, exportação CSV e prévia de tabela registra ator, data, resultado, alvo e hashes de IP e agente da sessão. O histórico não armazena senhas, tokens, payloads de importação ou valores das tabelas.

Para operações de alto impacto, como conexão, bootstrap e tabelas físicas, o próximo reforço previsto é exigir autenticação adicional da sessão. Até essa ativação, conceda essas permissões somente a perfis administrativos confiáveis.

Fluxo recomendado

1. Confirme a conexão principal e teste alcance.
2. Execute a implantação inicial somente em ambiente novo.
3. Modele a entidade com slug, tabela e campos.
4. Revise tipos, obrigatoriedade, unicidade e chave primária.
5. Salve e confirme a sincronização física.
6. Use Importar dados para carregar JSON na entidade selecionada ou restaurar um pacote estrutural.
7. Use Tabelas físicas para prévia protegida, exportação e carga CSV com modo append ou replace.
8. Gere contratos antes de liberar uma integração.

Módulos

Importação por entidade

Selecione explicitamente a entidade antes de enviar dados. O payload de registros é uma lista de objetos cujas chaves correspondem aos campos modelados.

[{ "slug": "carta-fogo", "name": "Carta de Fogo", "rarity": "rare" }]

Edição por linha

Em Registros, selecione uma entidade e use Novo registro ou Editar na linha desejada. A interface pagina até 25 registros por vez e registra criação, alteração e remoção na auditoria do Data Studio.

Campos cujo nome indique senha, hash, token, segredo, chave de API ou credencial não são expostos nem aceitos pela API genérica de entidades. Para clientes, use Clientes para dados de conta, endereços e redefinição de senha; o Data Studio deve ser usado para entidades operacionais modeladas e tabelas explicitamente governadas.

Tabelas físicas e proteção

Em Tabelas físicas, use Ver registros para conferir até 25 linhas da tabela selecionada antes de exportar ou importar. A prévia mascara automaticamente campos que possam conter senha, token, hash, segredo ou dado cifrado.

• entidades modeladas: mantenha registros no workspace Registros, com campos e contratos conhecidos;
• clientes e endereços: use Clientes; esse módulo preserva validações, criptografia, sessões e trilha de auditoria;
• sessões, tokens e autenticação: apenas consulta operacional mascarada; não use CSV para alterar essas tabelas;
• CSV continua apropriado para carga de dados de tabelas operacionais não governadas pelo domínio de autenticação.

Cuidados

• não use nomes de tabela vindos de entrada sem normalização;
• mudanças destrutivas exigem backup e revisão manual;
• cargas CSV em tabelas críticas são bloqueadas para não contornar regras de negócio;
• pacote base descreve estrutura, não substitui backup completo;
• se banco e snapshot divergirem, reconstrua a projeção a partir do banco.
• não atribua data.tables.manage ou data.audit.read a perfis de operação geral sem necessidade comprovada.