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.
SintaxeSYSCS_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
.