O procedimento do sistema SYSCS_UTIL.SYSCS_EXPORT_QUERY
exporta os resultados de uma instru????o SELECT para um arquivo do sistema
operacional no formato delimitado.
Sintaxe
SYSCS_UTIL.SYSCS_EXPORT_QUERY(IN SELECTSTATEMENT VARCHAR(32672),
IN FILENAME VARCHAR(32672), IN COLUMNDELIMITER CHAR(1),
IN CHARACTERDELIMITER CHAR(1), IN CODESET VARCHAR(128))
Este procedimento n??o retorna resultado.
- SELECTSTATEMENT
- Um argumento de entrada do tipo VARCHAR(32672), que especifica a instru????o
SELECT (consulta) que retorna os dados a serem exportados.
Passar um valor nulo resulta em erro.
- FILENAME
- Um argumento de entrada do tipo VARCHAR(32672), que especifica o nome do
arquivo para onde os dados ser??o exportados.
Se n??o for especificado o caminho completo para o arquivo, o procedimento de
exporta????o utilizar?? o diret??rio corrente e a unidade padr??o como destino.
Se for especificado o nome de um arquivo que j?? existe, o procedimento de
exporta????o sobrescrever?? o conte??do do arquivo; a informa????o n??o ser?? anexada.
Passar um valor nulo resulta em erro.
- COLUMNDELIMITER
- Um argumento de entrada do tipo CHAR(1), que especifica o delimitador de
coluna.
O caractere especificado ?? utilizado no lugar da v??rgula para sinalizar o fim da
coluna.
Passar um valor nulo resulta na utiliza????o do valor padr??o;
o valor padr??o ?? a v??rgula (,).
- CHARACTERDELIMITER
- Um argumento de entrada do tipo CHAR(1), que especifica o delimitador de
caracteres.
O caractere especificado ?? utilizado no lugar das aspas para envolver a
cadeia de caracteres.
Passar um valor nulo resulta na utiliza????o do valor padr??o;
o valor padr??o ?? aspas (").
- CODESET
- Um argumento de entrada do tipo VARCHAR(128), que especifica o c??digo de
conjunto de caracteres dos dados no arquivo exportado.
O nome do c??digo de conjunto de caracteres deve ser igual ao de uma das
codifica????es de caracteres suportadas pelo Java.
Antes de escrever no arquivo, os dados s??o convertidos do c??digo de conjunto de
caracteres do banco de dados para o c??digo de conjunto de caracteres
especificado.
Passar um argumento nulo faz com que os dados sejam escritos no mesmo c??digo de
conjunto de caracteres da JVM em que est?? sendo executado.
Exemplo
O exemplo a seguir mostra como exportar as informa????es dos empregados do
departamento 20 da tabela EQUIPE do banco de dados SAMPLE para o arquivo
meu_arquivo.csv.
CALL SYSCS_UTIL.SYSCS_EXPORT_QUERY('SELECT * FROM EQUIPE WHERE NUM_DEP =20',
'c:/saida/meu_arquivo.csv', null, null, null);
Para obter mais informa????es sobre exporta????o deve ser consultado o
Guia das Ferramentas e Utilit??rios do Derby.