# SYSCS_UTIL.SYSCS_IMPORT_DATA

O procedimento do sistema `SYSCS_UTIL.SYSCS_IMPORT_DATA` importa dados para um subconjunto de colunas da tabela. O subconjunto de colunas é escolhido especificando as colunas para inserção. Este procedimento também é utilizado para importar um subconjunto de colunas de dados do arquivo especificando os índices das colunas.

#### Sintaxe

    SYSCS_UTIL.SYSCS_IMPORT_DATA (IN SCHEMANAME VARCHAR(128),
    IN TABLENAME VARCHAR(128), IN INSERTCOLUMNS VARCHAR(32672),
    IN COLUMNINDEXES VARCHAR(32672), IN FILENAME VARCHAR(32672),
    IN COLUMNDELIMITER CHAR(1), IN CHARACTERDELIMITER CHAR(1),
    IN CODESET VARCHAR(128), IN REPLACE SMALLINT)

Este procedimento não retorna resultado.

SCHEMANAME
  Um argumento de entrada do tipo VARCHAR(128), que especifica o nome do esquema da tabela. Passar um valor nulo resulta na utilização do nome de esquema padrão
TABLENAME
  Um argumento de entrada do tipo VARCHAR(128), que especifica o nome da tabela para onde os dados serão importados. Não pode ser uma tabela do sistema ou uma tabela temporária declarada. Passar um valor nulo resulta em erro.
INSERTCOLUMNS
  Um argumento de entrada do tipo VARCHAR (32762), que especifica os nomes das colunas (separados por vírgula) da tabela para onde os dados serão importados. Passar um valor nulo resulta em erro.
COLUMNINDEXES
  Um argumento de entrada do tipo VARCHAR (32762), que especifica os índices (numerados a partir de 1 e separados por vírgulas) dos campos de dado da entrada a serem importados. Passar um valor nulo faz com que sejam utilizados todos os campos de dado de entrada presentes no arquivo.
FILENAME
  Um argumento de entrada do tipo VARCHAR(32672), que especifica o nome do arquivo que contém os dados a serem importados. Se não for especificado o caminho, será utilizado o diretório de trabalho corrente. 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 de entrada. O nome do código de conjunto de caracteres deve ser igual ao de uma das codificações de caracteres suportadas pelo Java. Os dados são convertidos do código de conjunto de caracteres especificado para o código de conjunto de caracteres do banco de dados (UTF-8). Passar um valor nulo faz interpretar os dados do arquivo no mesmo código de conjunto de caracteres da JVM em que está sendo executado.
REPLACE
  Um argumento de entrada do tipo SMALLINT. Um valor diferente de zero faz com que execute no modo de substituição, enquanto um valor igual a zero faz com que execute no modo de inserção. O modo de substituição exclui todos os dados existentes da tabela truncando o objeto de dados, e insere os dados importados. A definição da tabela e as definições dos índices não são alteradas. O modo de inserção adiciona os dados importados à tabela, sem alterar os dados existentes na tabela. Passar um valor nulo resulta em erro.

Se o nome do esquema, da tabela ou da coluna foi criado usando um identificador não delimitado, o nome deverá ser passado para o procedimento de importação usando todas as letras em maiúsculo. Se o nome do esquema, da tabela ou da coluna foi criado usando um identificador delimitado, o nome deverá ser passado para o procedimento de importação com letras maiúsculas e minúsculas, conforme utilizado na criação.

#### Exemplo

O exemplo a seguir importa alguns dos campos de dados do arquivo de dados delimitado chamado `meu_arquivo.csv` para a tabela EQUIPE:

    CALL SYSCS_UTIL.SYSCS_IMPORT_DATA
    (NULL, 'EQUIPE', null, '1,3,4', 'meu_arquivo.csv', null, null, null,0)

Para obter mais informações sobre importaçã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_EXPORT_QUERY
SYSCS_UTIL.SYSCS_IMPORT_TABLE