Dicionário de dados do Protheus: o mapa das tabelas SX

O Protheus não guarda “a tabela de clientes” e pronto. Antes de existir a SA1, existe uma linha na SX2 dizendo que ela existe, centenas de linhas na SX3 dizendo quais campos ela tem (no dicionário padrão, a SA1 passa de 250), linhas na SIX com os índices, na SX7 com os gatilhos, e assim por diante. Esse conjunto é o dicionário de dados. A tela de cadastro, a validação de um campo e o F3 que abre uma lista são montados a partir dele.

Este artigo é o mapa. Cada linha abaixo tem um artigo da série que aprofunda o assunto.

Duas observações que evitam confusão:

• Na SIX, a maioria das colunas não tem prefixo: INDICE, ORDEM, CHAVE, DESCRICAO, DESCSPA, DESCENG, PROPRI, F3, NICKNAME, SHOWPESQ — só IX_VIRTUAL e IX_VIRCUST têm. Nas outras tabelas, a coluna começa pelo nome da tabela sem o S (X2_, X3_, X7_, XA_…).
• A SX5 e a SX6 têm coluna de filial (X5_FILIAL, X6_FIL): o que elas guardam é conteúdo que pode variar por filial, não só estrutura. Para a SX5, veja também a página dela no catálogo de tabelas.

A SX3 é o centro. Cada seta abaixo é uma coluna que aponta de uma tabela para outra:

Exemplos reais de cada ligação:

• X3_ARQUIVO: B1_COD pertence à SB1.
• X3_F3: C5_CLIENTE abre a consulta SA1; A1_EST usa 12, a tabela de estados da SX5.
• X3_FOLDER: B1_BITMAP fica na pasta 5 do SB1.
• X3_GRPSXG: B1_COD pertence ao grupo 030; C5_CLIENTE, ao 001.
• X3_TRIGGER: no dicionário padrão, todo campo que tem gatilho na SX7 está marcado com S nessa coluna.
• X1_F3: é assim que uma pergunta de relatório ganha lupa.

Conferindo pelo SQL

Quando o dicionário está no banco, cada tabela SX é uma tabela física com o mesmo sufixo de empresa das tabelas de dados: SX3010, SX2010, SIX010. Os exemplos usam 010; o sufixo muda conforme a empresa do seu ambiente.

Todos os campos de uma tabela, na ordem do dicionário (X3_ORDEM):

SELECT X3_CAMPO, X3_TIPO, X3_TAMANHO, X3_DECIMAL, X3_TITULO,
       X3_CONTEXT, X3_F3, X3_FOLDER, X3_GRPSXG
  FROM SX3010
 WHERE X3_ARQUIVO = 'SB1'
   AND D_E_L_E_T_ = ' '
 ORDER BY X3_ORDEM

A tabela, o modo de acesso e a chave única:

SELECT X2_CHAVE, X2_NOME, X2_MODO, X2_MODOUN, X2_MODOEMP, X2_UNICO
  FROM SX2010
 WHERE X2_CHAVE = 'SB1'
   AND D_E_L_E_T_ = ' '

Os índices:

SELECT ORDEM, CHAVE, DESCRICAO, NICKNAME, SHOWPESQ
  FROM SIX010
 WHERE INDICE = 'SB1'
   AND D_E_L_E_T_ = ' '
 ORDER BY ORDEM

E um parâmetro MV_*, para ver tipo, descrição e conteúdo:

SELECT X6_FIL, X6_VAR, X6_TIPO, X6_DESCRIC, X6_CONTEUD
  FROM SX6010
 WHERE X6_VAR = 'MV_ULMES'
   AND D_E_L_E_T_ = ' '

Onde isso aparece no dia a dia

• Campo que não aparece na tela: a resposta está na SX3 (uso, pasta, contexto) — não na tabela de dados.
• “O F3 abre a lista errada”: confira o X3_F3 do campo e a consulta na SXB.
• “Não consigo aumentar esse campo”: veja se ele tem X3_GRPSXG. Se tiver, o tamanho se muda pelo grupo, na SXG.
• “Esse valor vem de onde?”: gatilho na SX7, inicializador em X3_RELACAO ou parâmetro na SX6.

Se precisar levantar o dicionário de uma customização inteira antes de uma atualização de versão, fale com a gente.