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
.