4D v16.3

Propriedades de Tabela

Página Inicial

 
4D v16.3
Propriedades de Tabela

Propriedades de Tabela  


 

 

É possível configurar várias propriedades para as tabelas utilizando Inspetor ou para algumas tabelas, usar o menu contextual das tabelas (clique com o botão direito).

Um trigger é um método que é executado automaticamente quando ocorrem certos eventos relacionados com a tabela. Estes eventos são:

  • Ao guardar um registro novo,
  • Ao guardar um registro existente,
  • Ao excluir um registro,
Os eventos triggers podem ser configurados em Inspetor ou através do menu contextual associado com a tabela (clique direito na área de título da tabela):

Marque cada evento para o qual deseja ativar o trigger.

É possível acessar diretamente ao trigger de uma tabela através da janela de estrutura clicando no botão Editar... do Inspetor ou selecionando Editar método... no sub-menu contextual. Para maiores informações sobre triggers, consulte a seção  Tipos de métodos..

Notes:

  • também é possível criar e visualizar os triggers a partir de Página Métodos do Explorador.
  • A barra de informação de Editor de estrutura indica os triggers ativados para cada tabela.

O trigger que introduza no editor de métodos não se executará quando os eventos selecionados são detectados.

É possível definir diferentes atributos para personalizar a aparência e o comportamento geral da tabela.

Esta opção permite fazer uma tabela invisível no modo Aplicação e para os plug-ins. É possível ativar esta opção para as tabelas utilitárias ou para as tabelas que não estão sendo utilizadas temporariamente.

Tornar uma tabela invisível lhe permite limitar as operações que um usuário pode realizar sobre a tabela e seus campos. Uma vez uma tabela é invisível, não aparece mais nos editores nem na maioria de caixas de diálogo que aparecem no ambiente Aplicação. Da mesma forma não podem ser utilizadas pelos plug-ins.

Os editores e caixas de diálogo no ambiente Aplicação incluem:

Em cada um destes editores, o usuário não pode ver ou escolher a tabela ou um de seus campos. Por exemplo, o usuário não pode incluir campos de uma tabela invisível em um relatório ou em uma etiqueta.

Nota:

Quando se utilizam estes editores, os usuários têm a opção de salvar no disco as características de pesquisas e ordenações, previamente criadas. Neste caso, as tabelas ou campos especificados como invisíveis podem ser utilizados posteriormente. Além do mais, os usuários podem escrever os nomes das tabelas e campos invisíveis na caixa de diálogo .

As tabelas invisíveis e seus campos são exibidos em itálico na janela do editor de estrutura.

É possível atribuir uma cor a cada tabela. O uso de cores ajuda a organizar a estrutura de um banco com muitas tabelas. Por exemplo, é possível utilizar uma cor para todas as tabelas relacionas com os clientes e outra cor para as tabelas relacionadas com o inventário.

Nota: Também é possível atribuir uma cor a cada campo (ver ) e a cada relação (ver Definição).

Para definir a cor de uma ou várias tabelas, efetue suas seleções e escolha uma cor utilizando:

  • o botão Cor na barra de ferramentas do editor,
  • o comando Cor no menu contextual  das tabelas (botão direito do mouse),
  • a opção Cor em Inspetor.

A opção Automático  pode ser usada para aplicar os padrões de cores automáticos a sua tabela.

Esta opção permite otimizar a eliminação de uma seleção de registros realizada com a ajuda do comando DELETE SELECTION.

Quando 4D elimina uma seleção, os marcadores dos registros também são apagados. Um marcador de registro é um cabeçalho associado ao registro que contém a informação relativa a esse registro. A eliminação dos marcadores e dos registros é mais lenta que a eliminação dos recursos. Em alguns casos, pode ser conveniente não eliminar automaticamente os marcadores dos registros.

Esta opção permite definir o tipo de eliminação que deseja usar. Para acelerar a eliminação de uma grande seleção usando o comando DELETE SELECTION, desmarque a opção Registros apagados definitivamente. Os marcadores de registros não serão eliminados. Esta opção não pode ser definida por programação.

Quando esta opção está marcada, 4D gera, durante a utilização da tabela, a informação necessária para a replicação dos registros da tabela (baseada particularmente na chave primária da tabela). A função de replicação dos registros permite sincronizar os dados de dois bancos de dados 4D para maior segurança.

Logo que essa opção estiver ativa, os mecanismos de replicação devem ser implementados usando os comandos específicos da linguagem SQL de 4D ou através do protocolo HTTP. Para mais informação sobre essa opção e sobre os mecanismos de replicação dos registros através do SQL, consulte a seção Replicação via SQL.

Para mais informações sobre a replicação através do HTTP, consulte URL 4DSYNC/.

Como padrão, esta opção não está selecionada.Para que ela esteja disponível, é necessário especificar uma chave primária para a tabela a ser replicada. Do contrário, a opção está em cinza. 4D permite definir a chave primária de uma tabela no editor de estrutura (ver a seguir).

Esta opção controla se a tabela se encontra exposta no contexto das solicitações 4D Mobile enviadas a base 4D. Por padrão, todas as tabelas se expõem em 4D Mobile.
Por razões de segurança, é possível que deseje somente expor certas tabelas de sua base  as chamadas 4D Mobile. Por exemplo, foi criada uma tabela [Usuários] que armazena os nomes de usuário e senhas, seria melhor não expor.

Se não deseja expor uma tabela (nem nenhum dos campos que contém), desative a opção Expor com o serviço 4D Mobile para a tabela.

Nota: também pode estabelecer esta opção no nível de cada campo da tabela, ver Armazenado em registro, arquivo de dados ou fora do arquivo de dados.

Esta opção pode ser utilizada no contexto da funcionalidade "4D Mobile". Para obter mais informação, consulte o manual [#title id="3388"/].

Por defecto, esta opción está seleccionada para todas las nuevas tablas creadas en 4D v14 y para todas las tablas en bases de datos convertidas.
Marque esta opción para que las operaciones realizadas en los datos de la tabla se incluyan en el archivo de registro de la base de datos

Marque esta opción para que las operaciones realizadas en los datos de la tabla se incluyan en el archivo de registro de la base de datos (cuando se genera). Esta opción generalmente debe ser seleccionada para la mayoría de las tablas. Sin embargo, por razones de optimización, puede deseleccionarla, por ejemplo para tablas temporales o tablas utilizadas para la importación de datos.

Nota: esta opción se pone gris cuando la tabla no tiene llave primaria.

Es importante tener en cuenta que esta opción sólo indica que los datos de la tabla deben registrarse en el historial si la database usa un archivo de historial, no activa el procedimiento de historial a nivel de la base de datos (ver Gestão do arquivo de histórico).

4D muestra un icono de advertencia a la derecha de la opción Incluir en archivo de historial cuando las condiciones necesarias se cumplen.

Mientras este icono se muestre, el historial no se activa. Puede colocar el puntero del ratón sobre el icono para ver el motivo de la alerta:

Pueden aparecer los siguientes mensajes:

MensajeCausaCorreción necesaria
Esperando para crear una llave primariaImposible registrar operaciones en el historial si la tabla no tiene una llave primaria (nueva regla en 4D v14)Crear una llave primaria en la tabla utilizando SQL o el menú contextual de la tabla
Esperando que los valores de la llave primaria se fijenLos valores de la llave primaria han sido verificados e incluyen anomalíasRetire todo duplicado o valores nulos en los registros para el campo (o utilice otra llave primaria)
Esperando para activar la opción usar archivo de historialLa opción global para activación del historial no está seleccionadaCompruebe la opción " Uso del archivo de historial' en la página Backup/Configuración de la configuración de la base de datos

A área Comentários de Inspetor permite armazenar informação adicional sobre a tabela. Estes comentários estão disponíveis para todos os desenvolvedores.

Note que cada campo e cada relação tem sua própria área de comentários.

SQL  

A área SQL de Inspetor inclui o menu “Esquema” e uma área de informação.

  • O menu “Esquema” lista todos os esquemas SQL definidos no banco. Pode utilizar este menu para definir o esquema ao qual pertence a tabela (também é possível modificar essa propriedade através dos comandos SQL). Cada banco tem ao menos um esquema, chamado  DEFAULT_SCHEMA. Como padrão, todas as tabelas pertencem a este esquema. Para mais informação sobre os esquemas SQL, consulte  Esquemas no Guia de referência SQL de 4D.
  • A área de informação indica se o nome da tabela respeita as regras de nomenclatura SQL (por exemplo, ao contrário de 4D, SQL não permite que um nome de campo contenha espaços).

Em 4D, é possível administrar a chave primária de uma tabela diretamente no editor da estrutura.

Em SQL, uma chave primária identifica as colunas (ou campos) utilizados para especificar de forma única os registros (linhas) de uma tabela.
A definição de uma chave primária é necessária para a função de replicação dos registros de uma tabela de 4D. Em SQL, a chave primária é definida utilizando a cláusula PRIMARY KEY seguida da lista de colunas (ver Chave primária no Guia de referência SQL de 4D).

É possível criar e eliminar as chaves primárias diretamente utilizando o menu contextual (botão direito do mouse) do editor de estrutura.

Para criar uma chave primária:

  1. Selecione o campo ou campos que compõe a chave primária da tabela.
  2. Dê um clique direito e selecione Criar chave primária no menu contextual:

    Os campos incluídos na chave primária aparecem subscritos no editor e sua descrição SQL mostra a palavra chave PRIMARY KEY.

O campo ou os campos que pertencem à chave primária não podem conter valores duplicados. Se os valores duplicados já existem nos registros da tabela, aparecerá uma caixa de diálogo de advertência para indicar que não é possível criar a chave por isso.

Nota: as colunas que pertencem à chave primária não aceitam valores NULL.

Para apagar a chave primária de uma tabela.

Clique com o botão direito sobre a tabela que contém a chave primária e escolha Eliminar a chave primária no menu contextual:

Aparece uma caixa de diálogo de confirmação. Clique em  Aceitar para eliminar a chave primária.

Campos de Chave primária devem ser lidados com cuidado para assegurar a integridade de dados. Em particular, campos de chave primária devem respeitar as regras abaixo:

  • não deve estar vazio,
  • deve ser único,
  • ao ser cirado, nunca (em princípio) deveria ser modificado, especialmente se:
    • as propriedades 4D replicação ou sincronização estiverem ativadas
    • propriedade 4D Mobile (ou similar) estiver ativada
    • a funçãoregistro do banco de dados estiver ativada (backup ou mirror lógico usando o arquivo de histórico)
    • chaves primárias forem usadas para propósitos de comunicação ou sincronização com sistemas externos.

Em geral, modificar os campos de chave primária deve ser evitado, mesmo se 4D permitir seu uso para casos específicos. Se precisar modificar o campo chave primária, é preferível criar um novo campo primário com atribuição automática.

Campos chave primária podem ser tipos inteiros longos ou formato UUID (tipo alfa). Na maioria dos casos, recomendamos o formato UUID com a opção Auto UUID ativada. Apesar do tipo inteiro longo ocupar menos espaço e ser um pouco mais rápido,  UUIDs tem muitas vantagens, por exemplo, facilitar a fusão de bancos de dados independentes, importar ou exportar dados, implementação de estratégias elaboradas de mirror/replicação ou sincronização com sistemas externos.

Para criar uma chave primária do editor Structure:

  1. asSelecione os campos que formam a chave primária da tabela.
  2. Dê um clique direito e escolha Create primary key no menu contextual (este comando só é exibido para campos cujo tipo é adequado para chaves primárias)
    [#picture id="106919" language="en" ]
    Não é possível ter mais que uma chave primária por tabela. Se uma chave primária já tiver sido especificada, um caixa de diálogo de alerta aparece indicando que a chave pimária existente será primeiro desativada.

A chave primária é criada imediatamente. Campos incluídos na chave primária são indefinidos no editor e sua descrição SQL exibe a keyword PRIMARY KEY.

Quando tiver criado uma chave primária em uma tabela que já contenha registros (usando um campo existente ou adiconando um campo), 4D verifica a conformidade de todos os valores presentes ou automaticamente realiza operações de atualização: 

  • Os campos que pertençam a uma chave primária não podem conter nenhum valor duplicado. Se existir um valo9r duplicado para a chave na tabela de registros, uma caixa de diálogo de aviso aparece para indicar que não é possível criar a chave por causa da duplicação.
  • Se o valor duplicado for um valor em branco ou nulo (caso de um campo chave adicionado) é possível verificar a opção correspondente de geração automática ( para campos Alpha em ou para campos Longint). Nesse caso, 4D examina todos os registros da tabela e automaticamente atribui um valor calculado para cada chave primária. Note que esse processo é sequencial e pode exigir uma grande quantidade de tempo se houver um número de registros significativo .

Nota: As colunas que pertencem à chave primária não aceitam valores NULL.

Para eliminar uma chave primária de uma tabela:

  1. Faça clique direito sobre a tabela que contém a chave primária e selecione Suprimir chave primária no menu contextual:
Aparecerá uma caixa de diálogo de confirmação. Faça clique em Aceitar para eliminar a chave primária.

A partir de 4D v14, toda nova tabela criada no banco de dados contém uma chave primária definida como padrão:

Esse campo, chamado  "ID" como padrão, é do tipo Longint,  e tem os seguintes atributos:

  • Único,
  • Rejeita que se digite valores NULL,
  • Autoincrementa,
  • Índice automático

Nota: Em Página Estrutura das Preferências do aplicativo 4D, pode modificar o nome e tipo das chaves primárias que são criadas como padrão.

Pode usar esse campo como existe, ou mudar seu nome ou propriedaades se assim o quiser (por exemplo se quiser usar um campo UUID). Pode também apagá-lo se quiser usar outros campos como chave primária.

Entretanto é fortemente recomendado manter pelo menos uma chave primária em cada tabela 4D.

Nota: Chaves primárias padrão não são adicionadas para tabelas que foram criadas usando o comando SQL CREATE TABLE , ou tabelas que foram importadas para o banco de dados.



Ver também 

Armazenado em registro, arquivo de dados ou fora do arquivo de dados

 
PROPRIEDADES 

Produto: 4D
Tema: Criar uma estrutura de banco de dados

 
HISTÓRIA 

 
PALAVRAS CHAVES 

primary key, replication

 
ARTICLE USAGE

Manual de Desenho 4D ( 4D v16)
Manual de Desenho 4D ( 4D v16.1)
Manual de Desenho 4D ( 4D v16.3)