array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdo-pgsql.copyfromfile.php', 1 => 'Pdo\\Pgsql::copyFromFile', 2 => 'Copia dados do arquivo para a tabela', ), 'up' => array ( 0 => 'class.pdo-pgsql.php', 1 => 'Pdo\\Pgsql', ), 'prev' => array ( 0 => 'pdo-pgsql.copyfromarray.php', 1 => 'Pdo\\Pgsql::copyFromArray', ), 'next' => array ( 0 => 'pdo-pgsql.copytoarray.php', 1 => 'Pdo\\Pgsql::copyToArray', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Pdo\Pgsql::copyFromFile

(PHP 8 >= 8.4.0)

Pdo\Pgsql::copyFromFile — Copia dados do arquivo para a tabela

Descrição

public function Pdo\Pgsql::copyFromFile(
    string $tableName,
    string $filename,
    string $separator = "\t",
    string $nullAs = "\\\\N",
    ?string $fields = null
): bool

Copia dados do arquivo especificado por filename na tabela tableName usando separator como delimitador de campos e lista de campos no parâmetro fields.

Parâmetros

tableName
String contendo o nome da tabela.
filename
Nome do arquivo que contém os dados a serem importados.
separator
Delimitador usado para separar campos em uma entrada do array rows.
nullAs
Como interpretar valores SQL NULL.
fields
Lista de campos a serem inseridos.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Se filename não puder ser aberto para leitura, a falha é reportada através da manipulação do erro da conexão (consulte PDO::ATTR_ERRMODE); com PDO::ERRMODE_EXCEPTION, uma PDOException é lançada.

Exemplos

Exemplo #1 Exemplo de Pdo\Pgsql::copyFromFile()

O arquivo tem um registro por linha com campos conectados por separator (uma tabulação por padrão). 

<?php
$db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$db->exec('CREATE TABLE fruits (id int, name text, qty int)');

file_put_contents('/tmp/fruits.tsv', "1\tapple\t10\n2\tbanana\t20\n");
$db->copyFromFile('fruits', '/tmp/fruits.tsv');

echo $db->query('SELECT count(*) FROM fruits')->fetchColumn(), "\n";
?>

O exemplo acima produzirá:

2

Veja Também