pg_exec

Name

pg_exec -- サーバへコマンド文字列を送信します。

Synopsis

pg_exec dbHandle queryString

入力

dbHandle

有効なデータベースハンドルを指定します。

queryString

有効な SQL 問い合わせを指定します。

出力

resultHandle

pgtcl がバックエンドからの応答を得ることができなかった場合は Tcl エラーが返されます。 さもなくば、問い合わせ結果オブジェクトが作成され、そのハンドルが返されます。 このハンドルを pg_result に渡して、問い合わせ結果を取り出すことができます。

説明

pg_exec は、問い合わせを PostgreSQL バックエンドに送信し、その結果を返します。 問い合わせ結果ハンドルは接続ハンドルから始まり、次いでピリオド、結果番号がつきます。

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