pg_sendquery
Prev | 4.4.Asynchronous Query Processing Commands | Next

## pg_sendquery

pg_sendquery — 非同期実行の為のsql命令を中央集中処理系に送る Send an SQL command to the server for asynchronous execution

## 構文 Synopsis

    pg_sendquery conn commandString ?param...?

## 説明 Description

`pg_sendquery` は命令を PostgreSQL 中央集中処理系に送り､命令の完了を待たず､結果の把持子の提供を待たず､直ぐに戻る｡命令文字列中の假引数位置占有子を置換える為に追加の引数が提供され得る｡ `pg_sendquery` sends a command to the PostgreSQL server and returns immediately, without waiting for the command to complete and without providing a result handle. Optional arguments can be supplied to replace parameter place-holders in the command string.

## 引数 Arguments

`conn`

  そこで命令を実行する接続部の把持子｡ The handle of the connection on which to execute the command.

`commandString`

  実行すべき SQL 命令｡ The SQL command to execute.

`param...`

  命令文字列の場所占有子に束縛する零乃至それ以上の個数の假引数｡第一引数は命令文字列内の $1 に､第二引数は $2 に､置換える､それ以降も同様にする｡ 　 Zero or more parameter values to bind to command string place-holders. The first argument will replace `$1` in the command string, the second argument will replace `$2`, etc.

## 返り値 Return Value

なし None.

もし不都合が生じるとTcl不都合が発せられる｡ A Tcl error will be thrown if an error occurs.

## 註意 Notes

命令が猶実行中か否か見るには pg_isbusy を使え｡結果を得るには､必要なら命令が完了するまで待ち､ pg_getresult を使え｡代りに､結果が用意された時に実行されるべき呼戻し命令を登録する為に pg_result_callback を使え(即ち､pg_getresult が抑止されない時)｡ Use pg_isbusy to see if the command is still being executed. Use pg_getresult to get the result, waiting for the command to complete if necessary. Alternatively, use pg_result_callback to register a callback command to be executed when a result is ready (that is, when pg_getresult will not block).

もし追加の引数が提供される場合､この命令は pg_sendquery_params の簡略形式であって､平文形式の引数を供給し､平文形式の結果を得る｡命令文字列は､假引数場所占有子 `$1`, `$2`､等々を含み､同じ個数の媒介変数引数を含まねばならない｡確認すべきは､ Tcl 変数置換を回避する為に SQL 命令文字列内の $1 の様な假引数場所占有子を波括弧や除外することを確認せねばならない｡この様な假引数の使用は､直接に命令文字列内に置換させるられる値の引用や除外の必要性を回避する｡ If optional arguments are supplied, this command becomes a simplified form of pg_sendquery_params, supporting only text-format arguments with a text-format result. The command string must include parameter place-holders `$1`, `$2`, etc. and an equal number of parameter arguments. Be sure to brace-quote or escape the parameter place-holders such as `$1` in the SQL command string to protect them from Tcl variable expansion. Use of these parameters avoids the need to quote and escape values which would otherwise have to be substituted directly into the command string.

媒介変数化された問合せに関する追加の引数を使うこの命令の形式は pgtclng-1.6.0で追加された｡ The form of this command using optional arguments for parameterized queries was added in pgtclng-1.6.0.

この命令は､追加の問合せ媒介変数引数無しの場合は PostgreSQL libpq function `PQsendQuery` を模擬し､追加の問合せ引数を伴う場合は､函数 `PQsendQueryParams` を模擬する｡ This command uses or emulates the PostgreSQL libpq function `PQsendQuery` if called without optional query parameter arguments, and the function `PQsendQueryParams` if called with optional query parameter arguments.

Prev | Up | Next
4.4.Asynchronous Query Processing Commands | Home | pg_sendquery_params