MASTERSAF DW

MANUAL DE BOAS PRÁTICAS

MASTERSAF DW MANUAL DE BOAS PRÁTICAS

SUMÁRIO

INTRODUÇÃO ................................................................................................................................................... 3
PROCEDIMENTOS PARA BANCO DE DADOS ................................................................................................ 3
TABELAS TEMPORÁRIAS DE ENTRADA (SAFX) ........................................................................................ 3
QUAIS SÃO AS TABELAS ENVOLVIDAS?................................................................................................. 3
QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS? ..................................................... 3
QUE PROCEDIMENTO DEVE SER SEGUIDO? .........................................................................................4
QUEM DEVE REALIZAR O PROCEDIMENTO? .........................................................................................4
TABELAS TEMPORÁRIAS DE PROCESSAMENTO (DATAMART - DWT) ...................................................4
QUAIS SÃO AS TABELAS ENVOLVIDAS?.................................................................................................4
QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DESSAS TABELAS? ..............................................4
QUE PROCEDIMENTO DEVE SER SEGUIDO? .........................................................................................5
QUEM DEVE REALIZAR O PROCEDIMENTO? .........................................................................................5
QUAIS SÃO OS PRÓXIMOS PASSOS?......................................................................................................5
TABELAS TEMPORÁRIAS DE SAÍDA (GERAÇÃO DE MEIOS MAGNÉTICOS)............................................6
QUAIS SÃO AS TABELAS ENVOLVIDAS?.................................................................................................6
QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS? ..................................................... 7
QUE PROCEDIMENTO DEVE SER SEGUIDO? ......................................................................................... 7
QUEM DEVE REALIZAR O PROCEDIMENTO? ........................................................................................ 11
TABELAS TEMPORÁRIAS DE GERAÇÃO IN86 .......................................................................................... 11
QUAIS SÃO AS TABELAS ENVOLVIDAS?................................................................................................ 11
QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS? .................................................... 11
QUE PROCEDIMENTO DEVE SER SEGUIDO? ........................................................................................ 11
QUEM DEVE REALIZAR O PROCEDIMENTO? ....................................................................................... 12
TABELAS DE LOG DE PROCESSAMENTO................................................................................................. 12
QUAIS SÃO AS TABELAS ENVOLVIDAS?............................................................................................... 12
QUAIS OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS?............................................................ 12
QUE PROCEDIMENTO DEVE SER ADOTADO?...................................................................................... 13
QUEM DEVE REALIZAR O PROCEDIMENTO? ....................................................................................... 13
INFORMAÇÕES IMPORTANTES ................................................................................................................ 14
SUPORTE TÉCNICO ........................................................................................................................................ 15

Versão 27 2
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

INTRODUÇÃO

Este manual visa fornecer ao usuário um roteiro simplificado com informações sobre a limpeza das
principais tabelas consideradas temporárias para geração dos processos do aplicativo MASTERSAF DW.

PROCEDIMENTOS PARA BANCO DE DADOS

TABELAS TEMPORÁRIAS DE ENTRADA (SAFX)

Sinopse: Inicialmente não abordaremos todas as tabelas temporárias de entrada, pois isso envolveria
um estudo detalhado dessas tabelas, mas sim apenas aquelas mais utilizadas.

QUAIS SÃO AS TABELAS ENVOLVIDAS?

• Todas as SAFX*.

QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS?

1. O administrador do aplicativo MASTERSAF DW deve verificar com o responsável pela operação

se todos os movimentos das tabelas citadas foram importados para o aplicativo MASTERSAF
DW.

2. O comando a ser executado limpará todos os documentos de todas as empresas da referida

tabela nomeada pelo DBA. Esse procedimento deve ser informado ao usuário responsável.

3. Aprovação por escrito do usuário responsável pela operação do aplicativo MASTERSAF DW.

4. Todos os usuários do aplicativo MASTERSAF DW devem estar desabilitados no módulo

PowerLock ( ). Exceto o administrador do sistema e o usuário que fará a limpeza no banco.

5. O DBA deve se certificar de que, no momento da limpeza das tabelas, nenhum processo está

Versão 27 3
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

sendo executado nas tabelas em questão, e que nenhum usuário está logado no aplicativo
MASTERSAF DW.

QUE PROCEDIMENTO DEVE SER SEGUIDO?

• Deve-se executar o comando “Truncate table”.

QUEM DEVE REALIZAR O PROCEDIMENTO?

• O DBA ou um profissional qualificado da área de TI do cliente.

TABELAS TEMPORÁRIAS DE PROCESSAMENTO (DATAMART

- DWT)

Sinopse: Como no item anterior, não se abordará todas as tabelas temporárias de processamento,
porquanto envolveria um estudo mais aprofundado, mas sim apenas as mais utilizadas.

QUAIS SÃO AS TABELAS ENVOLVIDAS?

• DWT_ITENS_SERV
• DWT_ITENS_MERC
• DWT_DOCTO_FISCAL

QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DESSAS TABELAS?

1. Avaliar se o cliente está gerando alguma obrigação mensal ou anual.

2. Avaliar se o cliente está atendendo uma intimação.

3. Se os itens 1 e 2 resultarem negativos, então é possível iniciar a limpeza das tabelas.

4. Todos os usuários do aplicativo MASTERSAF DW devem estar desabilitados no módulo

PowerLock ( ). Exceto o administrador do sistema e o usuário que fará a limpeza no banco.

Versão 27 4
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

5. O DBA deve se certificar de que, no momento da limpeza das tabelas, nenhum processo está
sendo executado nas tabelas em questão, e que nenhum usuário está logado no aplicativo
MASTERSAF DW.

QUE PROCEDIMENTO DEVE SER SEGUIDO?

• Deve-se executar o comando “Truncate table”.

QUEM DEVE REALIZAR O PROCEDIMENTO?

• O DBA e/ou um profissional qualificado da área de TI do cliente.

Obs.: Para realizar o truncate correto o DBA deve executar os seguintes comandos:

alter table dwt_itens_merc disable constraint FK_SAF_0637;

alter table dwt_itens_serv disable constraint FK_SAF_0638;

truncate table dwt_itens_merc;

truncate table dwt_itens_serv;
truncate table dwt_docto_fiscal;

alter table dwt_itens_merc enable constraint FK_SAF_0637;

alter table dwt_itens_serv enable constraint FK_SAF_0638;

QUAIS SÃO OS PRÓXIMOS PASSOS?

1. Por meio do módulo MASTERSAF DW o usuário responsável pela operação deve “equalizar”
apenas os meses que a área usuária estiver trabalhando. Em condições normais, deve-se
“equalizar” apenas o mês corrente e o mês anterior (se for o caso).

2. Em razão da entrega de intimação alguns clientes mantêm muitos meses equalizados, o que
pode ocasionar problemas de performance na aplicação. Portanto recomendamos equalizar
apenas o período que estiver gerando os arquivos da intimação ou obrigação.
Depois se deve fazer a limpeza no mesmo módulo da equalização e, em seguida, passe para o
próximo período.

Versão 27 5
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

3. Depois de executar o DATAMART de um estabelecimento deve-se executar a coletas das

estatísticas (analyze) das tabelas.

4. Recomenda-se que as coletas de estatísticas sejam executadas semanalmente com sample de no

mínimo 30%.

5. Os usuários devem estar desabilitados durante a execução do truncate table.

TABELAS TEMPORÁRIAS DE SAÍDA (GERAÇÃO DE MEIOS

MAGNÉTICOS)

Sinopse: Nesse momento não vamos atuar em todo o conjunto que envolve as tabelas temporárias de
saída. Essas tabelas são utilizadas para guardar as informações que irão gerar os arquivos do tipo “txt”
de diversas obrigações fiscais.

Todos os processos do aplicativo MASTERSAF DW gerados em FRAMEWORK gravam os arquivos nessas

Tabelas:

QUAIS SÃO AS TABELAS ENVOLVIDAS?

• LIB_PROC_PARAM
• LIB_PROC_CAB
• LIB_PROC_SAIDA
• LIB_PROC_SAIDA_COMPL
• LIB_PROC_LOG
• LIB_PROC_REL_PORT63_RPF
• DWT_REL_CONF_PISCOF
• DWT_REL_CONF_PISCOF_MSG
• ACT_CAD_BEM
• ACT_CAD_ITEM
• ACT_CAD_NAT_OP
• ACT_CAD_OBRA
• ACT_CAD_PARTIC
• ACT_CAD_OBS

Versão 27 6
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

• COTEPE_LAYOUT_REGS
• COTEPE_RES_CFO_TMP
• COTEPE_RES_UF_TEMP
• EFD_CAD_BEM
• EFD_CAD_BEM_CIAP
• EFD_CAD_BEM_MED
• EFD_CAD_CCUSTO
• EFD_CAD_CONTA
• EFD_CAD_MED
• EFD_CAD_NAT_OP
• EFD_CAD_OBS
• EFD_CAD_PARTIC
• EFD_CAD_PROD_MED
• EFD_CAD_PROD_SERV
• EFD_EXP_SERVICO
• Por fim, a tabela:
LIB_PROCESSO.

QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS?

1. Que todos os usuários já tenham gravados as mídias (arquivo txt) dos processos gerados.

2. Que todos os usuários do aplicativo MASTERSAF DW estejam desabilitados no módulo PowerLock

( ), exceto o administrador do sistema e o usuário que fará a limpeza no banco.

3. O DBA deve se certificar de que nenhum processo está sendo executado nas tabelas temporárias
de saída no momento da limpeza.

QUE PROCEDIMENTO DEVE SER SEGUIDO?

1. Deve-se executar o comando “Truncate table”.

Obs.: Para realizar o truncate correto o DBA deve executar os seguintes comandos:

alter table LIB_PROC_CAB disable constraint FK_LIB_PROC_CAB;

alter table LIB_PROC_LOG disable constraint FK_LIB_PROC_LOG;

Versão 27 7
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

alter table LIB_PROC_SAIDA disable constraint FK_LIB_PROC_SAIDA;

alter table LIB_PROC_SAIDA_COMPL disable constraint FK_LIB_PROC_SAIDA_COMPL;
alter table LIB_PROC_REL_PORT63_RPF disable constraint FK_LIB_PROC_REL_PORT63_RPF;
alter table DWT_REL_CONF_PISCOF disable constraint FK_DWT_REL_CONF_PISCOF;
alter table DWT_REL_CONF_PISCOF_MSG disable constraint FK_DWT_REL_CONF_PC_MSG;
alter table ACT_CAD_BEM disable constraint FK_ACT_BEM_PROCESSO;
alter table ACT_CAD_ITEM disable constraint FK_ACT_ITEM_PROCESSO;
alter table ACT_CAD_NAT_OP disable constraint FK_ACT_NATOP_PROCESSO;
alter table ACT_CAD_OBRA disable constraint FK_ACT_OBRA_PROCESSO;
alter table ACT_CAD_PARTIC disable constraint FK_ACT_PART_PROCESSO;
alter table ACT_CAD_OBS disable constraint FK_ACT_OBS_PROCESSO;
alter table COTEPE_LAYOUT_REGS disable constraint FK_COTEPE_PROCESSO;
alter table COTEPE_RES_CFO_TMP disable constraint FK_COTEPE_RESCFO_PROCESSO;
alter table COTEPE_RES_UF_TEMP disable constraint FK_COTEPE_RESUF_PROCESSO;
alter table EFD_CAD_BEM disable constraint FK_EFD_CAD_BEM;
alter table EFD_CAD_BEM_CIAP disable constraint FK_EFD_CAD_BEM_CIAP;
alter table EFD_CAD_BEM_MED disable constraint FK_EFD_CAD_BEM_MED;
alter table EFD_CAD_CCUSTO disable constraint FK_EFD_CAD_CCUSTO;
alter table EFD_CAD_CONTA disable constraint FK_EFD_CAD_CONTA;
alter table EFD_CAD_MED disable constraint FK_EFD_CAD_MED;
alter table EFD_CAD_NAT_OP disable constraint FK_EFD_CAD_NAT_OP;
alter table EFD_CAD_OBS disable constraint FK_EFD_CAD_OBS;
alter table EFD_CAD_PARTIC disable constraint FK_EFD_CAD_PARTIC;
alter table EFD_CAD_PROD_MED disable constraint FK_EFD_CAD_PROD_MED;
alter table EFD_CAD_PROD_SERV disable constraint FK_EFD_CAD_PROD_SERV;
alter table EFD_EXP_SERVICO disable constraint FK_EFD_EXP_SERVICO;

truncate table LIB_PROC_CAB;

truncate table LIB_PROC_LOG;
truncate table LIB_PROC_SAIDA;
truncate table LIB_PROC_PARAM;
truncate table LIB_PROC_SAIDA_COMPL;
truncate table LIB_PROC_REL_PORT63_RPF;
truncate table DWT_REL_CONF_PISCOF;
truncate table DWT_REL_CONF_PISCOF_MSG;

Versão 27 8
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

truncate table ACT_CAD_BEM;

truncate table ACT_CAD_ITEM;
truncate table ACT_CAD_NAT_OP;
truncate table ACT_CAD_OBRA;
truncate table ACT_CAD_PARTIC;
truncate table ACT_CAD_OBS;
truncate table COTEPE_LAYOUT_REGS;
truncate table COTEPE_RES_CFO_TMP;
truncate table COTEPE_RES_UF_TEMP;
truncate table EFD_CAD_BEM;
truncate table EFD_CAD_BEM_CIAP;
truncate table EFD_CAD_BEM_MED;
truncate table EFD_CAD_CCUSTO;
truncate table EFD_CAD_CONTA;
truncate table EFD_CAD_MED;
truncate table EFD_CAD_NAT_OP;
truncate table EFD_CAD_OBS;
truncate table EFD_CAD_PARTIC;
truncate table EFD_CAD_PROD_MED;
truncate table EFD_CAD_PROD_SERV;
truncate table EFD_EXP_SERVICO;
truncate table LIB_PROCESSO;

alter table LIB_PROC_CAB enable constraint FK_LIB_PROC_CAB;

alter table LIB_PROC_LOG enable constraint FK_LIB_PROC_LOG;
alter table LIB_PROC_SAIDA enable constraint FK_LIB_PROC_SAIDA;
alter table LIB_PROC_SAIDA_COMPL enable constraint FK_LIB_PROC_SAIDA_COMPL;
alter table LIB_PROC_REL_PORT63_RPF enable constraint FK_LIB_PROC_REL_PORT63_RPF;
alter table DWT_REL_CONF_PISCOF enable constraint FK_DWT_REL_CONF_PISCOF;
alter table DWT_REL_CONF_PISCOF_MSG enable constraint FK_DWT_REL_CONF_PC_MSG;
alter table ACT_CAD_BEM enable constraint FK_ACT_BEM_PROCESSO;
alter table ACT_CAD_ITEM enable constraint FK_ACT_ITEM_PROCESSO;
alter table ACT_CAD_NAT_OP enable constraint FK_ACT_NATOP_PROCESSO;
alter table ACT_CAD_OBRA enable constraint FK_ACT_OBRA_PROCESSO;
alter table ACT_CAD_PARTIC enable constraint FK_ACT_PART_PROCESSO;

Versão 27 9
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

alter table ACT_CAD_OBS enable constraint FK_ACT_OBS_PROCESSO;

alter table COTEPE_LAYOUT_REGS enable constraint FK_COTEPE_PROCESSO;
alter table COTEPE_RES_CFO_TMP enable constraint FK_COTEPE_RESCFO_PROCESSO;
alter table COTEPE_RES_UF_TEMP enable constraint FK_COTEPE_RESUF_PROCESSO;
alter table EFD_CAD_BEM enable constraint FK_EFD_CAD_BEM;
alter table EFD_CAD_BEM_CIAP enable constraint FK_EFD_CAD_BEM_CIAP;
alter table EFD_CAD_BEM_MED enable constraint FK_EFD_CAD_BEM_MED;
alter table EFD_CAD_CCUSTO enable constraint FK_EFD_CAD_CCUSTO;
alter table EFD_CAD_CONTA enable constraint FK_EFD_CAD_CONTA;
alter table EFD_CAD_MED enable constraint FK_EFD_CAD_MED;
alter table EFD_CAD_NAT_OP enable constraint FK_EFD_CAD_NAT_OP;
alter table EFD_CAD_OBS enable constraint FK_EFD_CAD_OBS;
alter table EFD_CAD_PARTIC enable constraint FK_EFD_CAD_PARTIC;
alter table EFD_CAD_PROD_MED enable constraint FK_EFD_CAD_PROD_MED;
alter table EFD_CAD_PROD_SERV enable constraint FK_EFD_CAD_PROD_SERV;
alter table EFD_EXP_SERVICO enable constraint FK_EFD_EXP_SERVICO;

2. Depois de realizar o truncate e executar algum processamento nessas tabelas, deve-se fazer a
coleta das estatísticas (DBMS_STATS). Recomendamos fortemente o uso do template abaixo
para obter os dados desta coleta. A mesma deve ser realizada de preferência semanalmente e, a
coleta automática do Oracle deve ser desabilitada.

Exemplo:

begin
dbms_stats.gather_system_stats('START');
sys.dbms_stats.delete_schema_stats('SYS');
sys.dbms_stats.gather_schema_stats('SYS');
dbms_stats.GATHER_FIXED_OBJECTS_STATS;
DBMS_STATS.GATHER_DICTIONARY_STATS;
DBMS_STATS.GATHER_SCHEMA_STATS(OWNNAME => 'MSAF'
,ESTIMATE_PERCENT => 30
,METHOD_OPT => 'FOR ALL INDEXED COLUMNS SIZE SKEWONLY'
,DEGREE => 6
,GRANULARITY => 'ALL'

Versão 27 10
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

,CASCADE => TRUE);

dbms_stats.gather_system_stats('STOP');
End;
/

QUEM DEVE REALIZAR O PROCEDIMENTO?

• O DBA ou um profissional qualificado da área de TI do cliente.

TABELAS TEMPORÁRIAS DE GERAÇÃO IN86

QUAIS SÃO AS TABELAS ENVOLVIDAS?

• INT_SAIDA_GER.
• INT_SAIDA.

QUAIS SÃO OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS?

1. Que todos os usuários já tenham gravados as mídias (arquivo txt) dos processos gerados.

2. Que todos os usuários do aplicativo MASTERSAF DW estejam desabilitados no módulo

PowerLock ( ), exceto o administrador do sistema e o usuário que realizará a limpeza no banco.

3. Outro ponto fundamental é que o DBA se certifique de que nenhum processo está sendo
executado nas tabelas em questão no momento da limpeza.

QUE PROCEDIMENTO DEVE SER SEGUIDO?

1. Deve-se executar o comando “Truncate table”.

Obs.: Para realizar o truncate correto o DBA deve executar os seguintes comandos:

truncate table INT_SAIDA_GER;

Versão 27 11
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

truncate table INT_SAIDA;

2. Depois de realizar o truncate e executar algum procedimento nessa tabela, deve-se fazer a coleta
das estatísticas (analyze).

QUEM DEVE REALIZAR O PROCEDIMENTO?

• O DBA ou um profissional qualificado da área de TI do cliente.

TABELAS DE LOG DE PROCESSAMENTO

QUAIS SÃO AS TABELAS ENVOLVIDAS?

• LOG_PROCESSO.
• LOG_DET_PROC.
• DET_PROC_GERACAO.
• DET_PROC_IMP.
• DET_PROC_IMP_C.
• IBT_HISTORICO
• LOG_PROCESSO_PARAM_JS.

QUAIS OS PRÉ-REQUISITOS PARA LIMPEZA DAS TABELAS?

1. Que todos os usuários já tenham analisados os logs de geração e importação.

2. Que todos os usuários do aplicativo MASTERSAF DW estejam desabilitados no módulo

PowerLock ( ), exceto o administrador do sistema e o usuário que realizará a limpeza no

banco.
3. Que o DBA se certifique de que nenhum processo está sendo executado nas tabelas em questão
no momento da limpeza.

Versão 27 12
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

QUE PROCEDIMENTO DEVE SER ADOTADO?

1. Deve-se executar o comando “Truncate table”.

Obs.: Para realizar o truncate correto o DBA deve executar os seguintes comandos:

alter table LOG_PROCESSO_PARAM_JS disable constraint FK_LOG_PROC_PARAM_JS;

truncate table LOG_DET_PROC;
truncate table LOG_PROCESSO;
truncate table DET_PROC_GERACAO;

truncate table DET_PROC_IMP;

truncate table DET_PROC_IMP_C;
truncate table IBT_HISTORICO;
truncate table LOG_PROCESSO_PARAM_JS;
alter table LOG_PROCESSO_PARAM_JS enable constraint FK_LOG_PROC_PARAM_JS;

2. Depois de realizar o truncate e executar algum procedimento em tabela, devem-se iniciar as

coletas das estatísticas (analyze).

QUEM DEVE REALIZAR O PROCEDIMENTO?

• O DBA ou um profissional qualificado da área de TI do cliente.

ATENÇÃO: O sucesso dessa operação está condicionado ao fato de que o responsável pela operação no
aplicativo MASTERSAF DW notifique as áreas que, após a limpeza, não serão preservados registros em
nenhuma das tabelas de log.

Versão 27 13
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

INFORMAÇÕES IMPORTANTES

• Em clientes com grande volume de dados podem ocorrer sérios problemas de performance no
ambiente produtivo. Portanto deve-se avaliar com todos os envolvidos a necessidade da limpeza
das tabelas mencionadas neste documento.

• Em relação a clientes que possuem várias empresas na mesma instância, o sucesso dessa
operação está condicionado ao fato de que o responsável pela operação no aplicativo
MASTERSAF DW notifique as áreas que, após a limpeza, não serão preservados registros em
nenhuma das tabelas envolvidas.

• Para maiores informações, favor consultar o Manual de Infraestrutura disponibilizado na Base de

Conhecimento.

Versão 27 14
Atualizado em: 27/06/2017
MASTERSAF DW MANUAL DE BOAS PRÁTICAS

SUPORTE TÉCNICO

Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe
de Suporte Técnico MASTERSAF pelo Telefone:

 (11) 2159-0600 opção 1 (Atendimento das Soluções Fiscais).

Nosso horário de atendimento é de segunda à sexta-feira de 9h as 18h.

Versão 27 15
Atualizado em: 27/06/2017