pg_exec

名前

pg_exec -- サーバにコマンドを送信します。

概要

pg_exec conn commandString

説明

pg_execPostgreSQLサーバにコマンドを送信し、結果を返します。 コマンド結果ハンドルは接続用ハンドルから始まり、ピリオド、結果番号が続いて付けられています。

Tcl エラーがなかったことが、コマンドが成功したことを示すわけではないことに注意して下さい! サーバから返されるエラーメッセージはpg_execでは、Tcl エラーが生成されるのではなく、失敗という状態の問い合わせ結果として処理されます。

引数

conn

コマンドを実行する接続のハンドルです。

commandString

実行するSQLコマンドです。

戻り値

結果ハンドルです。 pgtclがサーバからの応答を得ることができなかった場合はTclエラーが返されます。 これ以外では、コマンド結果オブジェクトが作成され、そのハンドルが返されます。 このハンドルをpg_resultに渡して、そのコマンドの結果を入手することができます。