Descarregar um arquivo ou um Banco de Dados.
Para agilizar e facilitar a utilização dos recursos deste utilitário foi criada uma opção que permite que todos os arquivos do banco de dados sejam descarregados de uma única vez.
bddesc -b<banco> [-s<seguranca>] [-n<nivel>] [-O] [-S] [-L<selecao>][-{a | r}<arq_ban> [-c<chave]] [-g<arq_sai>] [-t]
| -b <banco> |
indica o nome do Banco de Dados. |
| -s <segurança> |
indica o código de segurança definido no esquema do Banco de Dados. Se omitido, será considerado o valor 1. |
| -n <nível> |
indica a palavra de nível do usuário. Se omitido, será assumido o valor "a" (DEFAULT). |
| -{a | r} <arq_ban> |
determina o nome do arquivo do Banco de Dados a ser descarregado . Caso se utilize a opção "a", a recarga deverá ser feita pelo utilitário BDADIC, sendo gravado um arquivo com a extensão ".d" com a descrição do arquivo do banco. Caso seja utilizada a opção "r", a recarga deverá ser feita pelo utilitário BDRECA. Se nenhuma opção for especificada, todo o banco de dados será descarregado para ser recarregado pelo utilitário BDRECA. |
| -g <arq_sai> |
indica o nome do arquivo de saída. Se omitido, os dados vão para a saída padrão. Esta opção pode ser substituída pelo direcionamento da saída padrão (>). |
| -c <chave> |
indica o nome da chave que ordenará a descarga do arquivo especificado pelas opções "-a" ou "-r". A descarga dos arquivos será na ordem da primeira chave. |
| -[O | o] |
determina que os arquivos não serão verificados na abertura do banco de dados. |
| -S |
determina a descarga de todos os arquivos do banco de dados. Incompatível com as opções "-a" e "-r". Com esta opção "setada" o utilitário BDDESC descarregará todos os arquivos do banco de dados utilizando a opção "-a", para que os arquivos possam ser recarregados pelo utilitário BDADIC. Os arquivos de saída terão a seguinte nomenclatura:
Estes arquivos também podem ser recarregados de uma única vez, bastando para isso, especificar a opção "-S" para o utilitário BDADIC. Apenas a opção "-c" acarreta em erro. As demais opções do utilitário ficam valendo para todos os arquivos descarregados |
| -t |
determina que dados binários serão convertidos para numéricos. Esta opção só pode ser especificada em conjunto com a opção "-a". |
| -L <seleção> | determina que só serão descarregados os registros que atenderem a seleção. <seleção> representa uma expressão relacional de pesquisa e tem a mesma sintaxe do comando SELECIONE do GERAL. |
| -q | Descarrega um arquivo em um banco OpenBase, de forma que os dados são gerados na forma de comandos SQL. |
Permite que se copie um arquivo do banco de dados ou todos os arquivos do banco de dados para um único arquivo de saída. Quando se pretende alterar a estrutura de um arquivo do banco de dados deve ser utilizado com a opção "-a", para que, na carga do arquivo, o utilitário BDADIC verifique a alteração e faça as conversões necessárias.
São permitidas as seguintes alterações:
Ao descarregar um Banco de Dados que utilize arquivo diário, o BDDESC grava um arquivo com data-hora do backup, mais o número da última transação. Este arquivo tem o nome igual ao arquivo de saída mais a extensão ".t".
A opção -L deve ser usada em conjunto da opção -a ou -r indicando o arquivo que será pesquisado para descarga dos registros. Não é válida a utilização de JOIN (BDJUNT). Os itens utilizados na seleção devem pertencer ao arquivo informado.
Por se tratar de uma expressão de seleção GERAL todos os operadores válidos para o GERAL são válidos também para BDDESC, inclusive os conectores lógicos E e OU.
Para selecionar campos tipo U cujo valor a ser pesquisado existem brancos, este valor deve ser colocado entre aspas. Neste caso estas aspas extras devem ser precedidas de contra-barra (\) para informar que estas estão dentro das aspas mais externas.
No caso de seleção de chaves com valor nulo, deve-se utilizar o sinal de exclamação entre aspas e estas aspas devem ser precedidas por contra-barras.
O exemplo a seguir mostra a descarga de somente um arquivo do banco de dados, que será carregado pelo utilitário BDADIC. Será criado um arquivo com o nome tab_func.d com a descrição do arquivo tab_func.adi.d
$ bddesc -bbdemp1 -s33 -atab_func -gtab_func.adi.d
O exemplo a seguir mostra a descarga do arquivo tab_nfis que será recarregado pelo utilitário BDRECA e seguindo a ordem da terceira chave do arquivo (ven_nfis).
$ bddesc -bbdemp1 -s 33 -r tab_nfis -c3 -gtab_nfis.rec
O exemplo a seguir mostra uma forma de se criar um BACKUP do banco de dados.
$ bdreca -b bdemp1 -s33 > /dev/rmt0
O exemplo a seguir descarrega os registros do arquivo DEPENDENTE cujo valor da chave RESPONSÁVEL (v3) é nulo e o NOME (U30) do dependente começa por JOSÉ DA SILVA além de todos os dependentes que tenham NÍVEL (n1) superior ou igual a 1.
# bddesc -bBANCO -a DEPENDENTE -gsaida -L"REPONSAVEL=\"!!\" E NOME
$= \"jose da silva\" OU NIVEL=1"
BDADIC, BDCDBF e BDRECA.