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

Example #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

  • pg_copy_from() - Insere registros em uma tabela a partir de um array