# SYSCS_UTIL.SYSCS_EXPORT_QUERY

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.

Tópico pai: Procedimentos do sistema nativos
Referências relacionadas
SYSCS_UTIL.SYSCS_COMPRESS_TABLE
SYSCS_UTIL.SYSCS_INPLACE_COMPRESS_TABLE
SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS
SYSCS_UTIL.SYSCS_SET_STATISTICS_TIMING
SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY
SYSCS_UTIL.SYSCS_FREEZE_DATABASE
SYSCS_UTIL.SYSCS_UNFREEZE_DATABASE
SYSCS_UTIL.SYSCS_CHECKPOINT_DATABASE
SYSCS_UTIL.SYSCS_BACKUP_DATABASE
SYSCS_UTIL.SYSCS_EXPORT_TABLE
SYSCS_UTIL.SYSCS_IMPORT_TABLE
SYSCS_UTIL.SYSCS_IMPORT_DATA