pg_copy_to

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

pg_copy_to — 配列にテーブルをコピーする

説明

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

pg_copy_to() は、テーブルを配列にコピーします。レコードを取得するために、内部では COPY TO SQL コマンドを発行します。

パラメータ

connection: PgSql\Connection クラスのインスタンス。
table_name: データを rows にコピーするテーブルの名前。
separator: rows の要素内で、各フィールドに対応する値を区切る文字。デフォルトは \t です。
null_as: rows の中で、SQL の NULL をどのように表現するか。デフォルトは \\N ("\\\\N") です。

戻り値

COPY されたデータが 1 行ごとにひとつの要素となっている配列を返します。失敗した場合に false を返します

変更履歴

バージョン	説明
8.1.0	`connection` は、PgSql\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、リソースを期待していました。

例

例1 pg_copy_to() の例


<?php
   $db = pg_connect("dbname=publisher") or die("Could not connect");
   
   $rows = pg_copy_to($db, $table_name);
   
   pg_query($db, "DELETE FROM $table_name");
   
   pg_copy_from($db, $table_name, $rows);
?>

参考

pg_copy_from() - 配列からテーブルに挿入する

関連キーワード: 　テーブル, 配列, コピー, copy, rows, PgSql, Connection, connection, string, COPY