DatabaseImport

Importa para uma tabela dados de um arquivo.

long  DatabaseImport(
   int           database,          // identificador de banco de dados recebido em DatabaseOpen
   const string  table,             // nome da tabela para inserir dados
   const string  filename,          // nome do arquivo para importar dados
   uint          flags,             // combinação de sinalizadores
   const string  separator,         // separador de dados 
   ulong         skip_rows,         // quantas primeiras linhas ignorar
   const string  skip_comments      // strings de símbolos que definem comentários
   );

Parâmetros

database

[in]  Identificador do banco de dados obtido em DatabaseOpen().

table

[in]  Nome da tabela à qual serão adicionados os dados do arquivo.

filename

[in]  Arquivo CSV ou arquivo ZIP para leitura de dados, o nome pode conter subpastas e é definido em relação à pasta MQL5\Files.

flags

[in]  Combinação de sinalizadores.

separator

[in]  Separador de dados em um arquivo CSV.

skip_rows

[in]  Número de linhas iniciais a serem ignoradas ao ler dados de um arquivo.

skip_comments

[in]   Linhas dos símbolos para designar strings como comentários. Se, no início da linha, for encontrado qualquer símbolo de skip_comments, tal linha é considerada um comentário e não é importada.

Valor retornado

Retorna o número de linhas importadas ou -1 em caso de erro. Para obter o código de erro, use GetLastError(), respostas possíveis:

  • ERR_INVALID_PARAMETER (4003)              —  o nome da tabela não está especificado (linha vazia ou NULL);
  • ERR_DATABASE_INTERNAL (5120)              — erro interno do banco de dados;
  • ERR_DATABASE_INVALID_HANDLE (5121)   - identificador de banco de dados inválido.

 

Observação

Se tabelas cujo nome é table não existirem, elas serão criadas automaticamente. Os nomes e o tipo de campos na tabela criada serão reconhecidos automaticamente com base nos dados contidos no arquivo.  

 

Veja também

DatabaseOpen, DatabasePrint