array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-copy-to.php', 1 => 'pg_copy_to', 2 => 'Copia uma tabela para um array', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-copy-from.php', 1 => 'pg_copy_from', ), 'next' => array ( 0 => 'function.pg-dbname.php', 1 => 'pg_dbname', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pgsql/functions/pg-copy-to.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_copy_to

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_copy_to — Copia uma tabela para um array

Descrição

pg_copy_to(
    PgSql\Connection $connection,
    string $table_name,
    string $separator = "\t",
    string $null_as = "\\\\N"
): array|false

pg_copy_to() copia uma tabela para um array. Ele emite o comando SQL COPY TO internamente para recuperar registros.

Parâmetros

connection

Uma instância de PgSql\Connection.

table_name

Nome da tabela da qual copiar os dados em rows.

separator

O token que separa os valores de cada campo em cada elemento de rows. O padrão é \t.

null_as

Como os valores SQL NULL são representados nas rows. O padrão é \\N ("\\\\N").

Valor Retornado

Um array com um elemento para cada linha de dados COPY, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro connection agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de pg_copy_to()

<?php
$db = pg_connect("dbname=publisher") or die("Não foi possível conectar");

$rows = pg_copy_to($db, $table_name);

pg_query($db, "DELETE FROM $table_name");

pg_copy_from($db, $table_name, $rows);
?>

Veja Também