Extração de dados
Esta função permite extrair os dados de uma ou várias tabelas de um dossier X3, em criando os ficheiros contendo a descrição da tabela e os dados guardados, num sub-directório do dossier (SVG por defeito). Trata-se de uma extração física (um pouco comparável a uma exportação oracle, a este perto que o ficheiro tem um formato que não foi ligado a uma base de dados e pode ser utilizado para transferências entre bases). Para cada tabela XXX da base, quatro a seis ficheiros são criados :
- um ficheiro XXX.dat, que contém os dados sob a forma de um ficheiro constituido de registos em comprimento fixo.
- um ficheiro XXX.srf, que contém a descrição da estrutura do ficheiro (sob formato "ascii")
- um ficheiro XXX.fde, que contém a descrição da estrutura do ficheiro (sob forma compilada utilizável diretamente pelo motor sage : este ficheiro existe igualmente no diretório FIL do dossier ).
- um ficheiro XXX.seq, que contém o próximo número de sequência associado à tabela. Esta informação é importante na medida onde cada tabela está associada a um número de sequência que permite criar os números únicos (isso corresponde à função sage uniqid([abv]), onde abv é abreviação da tabela correspondente)
- um ficheiro XXX.blb, que contem os dados ligados aos "blobs" (imagens) ou aos "clobs" (textos) guardados na tabela se existir uma .
- um ficheiro XXX.cfg, que contém as informações de configuração da tabela na base de dados. Este ficheiro é opcional, a sua presença depende em particular das opções de extração tomadas. Para mais informações sobre a estrutura dos ficheiros de configuração, é aconselhado de consultar oanexo técnico correspondente.
Advertência legal
Este tipo de função é uma função de desenvolvimento cuja utilização está interdito no quadro de uma exploração normal.
As consequências legais de utilização de utilitários de desenvolvimento sobre bases de dados contendo os dados cuja lei interdita a alteração são da inteira responsabilidade do cliente. Para mais informações, consulte oanexo correspondente.
Gestão do ecrã
Ecrã de registo
Apresentação
Na entrada na função, chega-se num ecrã de registo onde se definem os dados a extrair e os paràmetros desta extração.
O facto de validar desencadeia a função. Um ficheiro rasto está criado e visualizado para permitir de conhecer o resultado (e os erros eventuais à extração).
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Bloco número 1
| Indiquez le code du dossier de travail, tel que défini dans la table des dossiers. |
| Se o dossier cujo se extrai as tabelas possui um dossier de histórico, pode-se escolher de extrair os dados da tabela histórica (em assinalando a check box) ou a tabela do dossier de exploração (em não a assinalando). |
| Define o nome da tabela a extrair, ou um modelo caracterizando o nome das tabelas a extrair. Se se deseja por exemplo extrair todas as tabelas presentes no directório SVG, é suficiente escrever * neste campo. |
|
|
Bloco número 2
| Quando esta check box está assinalada, o ficheiro de extenção cfg apresenta no directório FIL esta cópia no directório de extração. Este ficheiro contém directivas de configuração tais que o tamanho das extensões. A sua estrutura está descrita num anexo. |
| Quando esta check box está assinalada, o ficheiro de extensão srf, que contém os elementos de dimensionamento da tabela, está criado tendo em conta o tamanho corrente da tabela, e não do tamanho previsto a termo para a tabela (tal que ela está definida pelas variáveis e fórmulas de dimensionamento em gestão de dossier). |
Fechar
Utilização prática
Limites técnicos
Esta função está ligada ao motor sage e não às bases de dados standard. Em consequência, ela não deve mais ser utilizada no quadro de um procedimento habitual de salvaguarda, cujo possui as garantias de segurança nem de performance. Uma salvaguarda com os utilitários standard da base é fortemente recomendada antes toda a utilizador deste tipo de função.
Por entre as limitações deste tipo de função, convém notar que, se ele está lançado sobre várias tabelas de base, ela pode conduzir a uma imagem da base que não está globalmente coerência se as atualizações tiveram ligar durante a exportação (contrariamente aos utilitários standard associados às bases de dados). Se deseja se servir desta função para extrair uma tal imagem coerente, falta assegurar que ninguém de outro está conectado sobre o dossier durante a extração.
Casos práticos de utilização
Se deseja extrair uma tabela para fazer uma salvaguarda temporária afim de poder a reintegrar a idêntico em caso de problema (por exemplo, após uma tentativa infeliz de manutenção antes a qual uma salvaguarda de precaução tenha sido realizada), falta imperativamente assinalar a check box Cópia ficheiros de configuração, e desassinalar a check box Tamanho real no srf. Trata-se em ocorrência do valor por defeito proposto.
Se deseja por outro lado extrair os dados de toda a uma base afim de permitir de os remontar num outro evento, por exemplo com fins de análise, falta desassinalar a check boxCópia de ficheiros de configuração para não ter constrangiementos impossíveis a respeitar no momento da reintegração. Pode ser interessante neste momento de assinalar a check box Tamanho real na srf. Isto tem por consequências de criar um ficheiro de extensão srf dimensionado ao tamanho do dossier Pode-se assim recarregar as tabelas de um dossier em minimizando o local físico necessário na base. Esta opção está fortemente recomendada se se pretende servir de uma tal extração para remontar o dossier com fins de análise ou todo e simplesmente de recuperação de um dossier de desenvolvimento.
Tarefa batch
Esta função pode ser lançada em batch. A tarefa standard DOSSVG está prevista p/esse efeito.
Mensagens de erro
Para além das mensagens genéricas, as seguintes mensagens de erro podem aparecer durante o reg. :
Dossier XXX
Erro de acesso sobre a tabela AUTLIS
Ficheiro inexistente:
Esta mensagem de erro significa que o dossier escolhido não foi criado, ou não existe mais (em todo estado de causa, a tabela dos utilizadores não foi encontrada neste dossier).
Outras mensagens de erro
No momento da extração, um ficheiro rasto foi criado. Erros podem surgir durante a operação ela mesmo : elas se apresentam sob a forma de uma linha de erro (a vermelho) no rasto, seguido eventualmente de informações complementares.