diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 54847b941d1..18e21cff885 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -9843,7 +9843,7 @@ SELECT * FROM parent WHERE key = 2400; not when it is prepared. For more information see . --> -準備された文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。 +プリペアド文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。 カスタムプランは実行ごとに指定されたパラメータ値の集合で新たに作られます。 一方汎用プランはパラメータ値に依存せず、複数の実行にまたがって再利用できます。 したがって、汎用プランはプランニングに要する時間を節約できますが、理想的なプランがパラメータ値に強く依存している場合は、汎用プランは非効率かも知れません。 diff --git a/doc/src/sgml/config2.sgml b/doc/src/sgml/config2.sgml index 280c1823d08..63937b1adf7 100644 --- a/doc/src/sgml/config2.sgml +++ b/doc/src/sgml/config2.sgml @@ -91,7 +91,7 @@ not when it is prepared. For more information see . --> -準備された文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。 +プリペアド文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。 カスタムプランは実行ごとに指定されたパラメータ値の集合で新たに作られます。 一方汎用プランはパラメータ値に依存せず、複数の実行にまたがって再利用できます。 したがって、汎用プランはプランニングに要する時間を節約できますが、理想的なプランがパラメータ値に強く依存している場合は、汎用プランは非効率かも知れません。 diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index 2f59d6611b7..29fff7a0134 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -3753,7 +3753,7 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' For example, CURRENT_DATE + 1 is safer than 'tomorrow'::date. --> -入力する文字列としてnow、today、tomorrow及びyesterdayはインタラクティブなSQLコマンドの中で利用する時は良いですが、コマンドが保存され後に実行されるような時には驚く挙動になることがあります。例えば、準備された文、ビューや関数の定義です。 +入力する文字列としてnow、today、tomorrow及びyesterdayはインタラクティブなSQLコマンドの中で利用する時は良いですが、コマンドが保存され後に実行されるような時には驚く挙動になることがあります。例えば、プリペアド文、ビューや関数の定義です。 文字列は特定の時間の値に変換され、その値が古くなってからもしばらく使い続けられることがあります。 このような状況では、代わりにSQL関数を使用してください。 例えば、'tomorrow'::dateよりもCURRENT_DATE + 1の方が安全です。 diff --git a/doc/src/sgml/jit.sgml b/doc/src/sgml/jit.sgml index 4b197d31876..5c4c42a26af 100644 --- a/doc/src/sgml/jit.sgml +++ b/doc/src/sgml/jit.sgml @@ -204,7 +204,7 @@ not the settings at execution time. --> これらのコストに基づく決定は実行時ではなく、プラン時に行われます。 -このことは、準備された文が使われ、汎用プラン(参照)が用いられるときには、実行時ではなく、準備時に参照される設定パラメータの値が決定を左右することを意味します。 +このことは、プリペアド文が使われ、汎用プラン(参照)が用いられるときには、実行時ではなく、準備時に参照される設定パラメータの値が決定を左右することを意味します。 diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index fafb08bed32..50b777a7fc3 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -5042,7 +5042,7 @@ SELECT * FROM mytable WHERE x = $1::bigint; Submits a request to create a prepared statement with the given parameters, and waits for completion. --> -指定パラメータを持つ準備された文の作成要求を送信し、その完了を待ちます。 +指定パラメータを持つプリペアド文の作成要求を送信し、その完了を待ちます。 PGresult *PQprepare(PGconn *conn, const char *stmtName, @@ -5059,7 +5059,7 @@ PGresult *PQprepare(PGconn *conn, commands to be executed repeatedly without being parsed and planned each time; see for details. --> -は、後でを使用して実行する準備された文を作成します。 +は、後でを使用して実行するプリペアド文を作成します。 この機能を使用すると、コマンドを実行の度に解析して計画することなく、繰り返し実行することができます。 詳しくはを参照してください。 @@ -5088,7 +5088,7 @@ PGresult *PQprepare(PGconn *conn, for a means to find out what data types were inferred.) --> -この関数はquery文字列からstmtNameという名前の準備された文を作成します。 +この関数はquery文字列からstmtNameという名前のプリペアド文を作成します。 queryは単一のSQLコマンドでなければなりません。 stmtNameを""にして、無名の文を作成することができます。 もし、無名の文が既に存在していた場合は自動的に置き換えられます。 @@ -5126,7 +5126,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること be created by executing SQL statements. --> -で使用するための準備された文は、SQL 文を実行して作成することもできます。 +で使用するためのプリペアド文は、SQL 文を実行して作成することもできます。 @@ -5140,7 +5140,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること Sends a request to execute a prepared statement with given parameters, and waits for the result. --> -指定パラメータによる準備された文の実行要求を送信し、結果を待ちます。 +指定パラメータによるプリペアド文の実行要求を送信し、結果を待ちます。 PGresult *PQexecPrepared(PGconn *conn, const char *stmtName, @@ -5162,7 +5162,7 @@ PGresult *PQexecPrepared(PGconn *conn, executed. The statement must have been prepared previously in the current session. --> -とは似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前に準備された文を指名することで指定されます。 +とは似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前にプリペアド文を指名することで指定されます。 この機能により、繰り返し使用する予定のコマンドを実行する度にではなく、一度だけ解析、計画作成を行うことができます。 この文は現在のセッションで事前に準備されていなければなりません。 @@ -5174,9 +5174,9 @@ PGresult *PQexecPrepared(PGconn *conn, paramTypes[] parameter is not present (it is not needed since the prepared statement's parameter types were determined when it was created). --> -パラメータは、問い合わせ文字列ではなく指定された準備された文の名前を与える点を除き、と同じです。 +パラメータは、問い合わせ文字列ではなく指定されたプリペアド文の名前を与える点を除き、と同じです。 また、paramTypes[]パラメータは存在しません。 -(準備された文のパラメータ型はその作成時点で決定されているため、これは不要です。) +(プリペアド文のパラメータ型はその作成時点で決定されているため、これは不要です。) @@ -5190,7 +5190,7 @@ PGresult *PQexecPrepared(PGconn *conn, Submits a request to obtain information about the specified prepared statement, and waits for completion. --> -指定した準備された文に関する情報入手要求を送り、入手完了まで待機します。 +指定したプリペアド文に関する情報入手要求を送り、入手完了まで待機します。 PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); @@ -5201,7 +5201,7 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); allows an application to obtain information about a previously prepared statement. --> -により、アプリケーションは事前に準備された文に関する情報を入手できます。 +により、アプリケーションは事前にプリペアド文に関する情報を入手できます。 @@ -5219,9 +5219,9 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); result columns (if any) of the statement. --> stmtNameを""またはNULLとすることで、無名の文を参照することができます。 -これ以外では、存在する準備された文の名前でなければなりません。 +これ以外では、存在するプリペアド文の名前でなければなりません。 成功すると、PGRES_COMMAND_OKというステータスのPGresultが返されます。 -および関数をこのPGresultに適用して、準備された文のパラメータに関する情報を得ることができます。 +および関数をこのPGresultに適用して、プリペアド文のパラメータに関する情報を得ることができます。 また、、、関数などを使用して、文の結果列（もしあれば）に関する情報を提供できます。 @@ -5282,7 +5282,7 @@ PGresult *PQdescribePortal(PGconn *conn, const char *portalName); Submits a request to close the specified prepared statement, and waits for completion. --> -指定した準備された文をクローズする要求を送信し、完了を待機します。 +指定したプリペアド文をクローズする要求を送信し、完了を待機します。 PGresult *PQclosePrepared(PGconn *conn, const char *stmtName); @@ -5295,7 +5295,7 @@ PGresult *PQclosePrepared(PGconn *conn, const char *stmtName); of its associated resources on the server and allows its name to be reused. --> -を使用すると、アプリケーションは以前に作られた準備された文を閉じることができます。 +を使用すると、アプリケーションは以前に作られたプリペアド文を閉じることができます。 文を閉じると、サーバ上の関連するすべてのリソースが解放され、その名前を再利用できるようになります。 @@ -6685,7 +6685,7 @@ int PQgetlength(const PGresult *res, -準備された文のパラメータ数を返します。 +プリペアド文のパラメータ数を返します。 int PQnparams(const PGresult *res); @@ -7594,7 +7594,7 @@ int PQsendQueryParams(PGconn *conn, Sends a request to create a prepared statement with the given parameters, without waiting for completion. --> -指定パラメータを持つ準備された文の作成要求を送信します。 +指定パラメータを持つプリペアド文の作成要求を送信します。 その完了を待ちません。 int PQsendPrepare(PGconn *conn, @@ -7614,7 +7614,7 @@ int PQsendPrepare(PGconn *conn, --> これはの非同期版です。 要求の登録に成功した場合1が、失敗した場合0が返されます。 -呼び出しの成功の後、サーバが準備された文の生成に成功したかを確認するためにはを呼び出してください。 +呼び出しの成功の後、サーバがプリペアド文の生成に成功したかを確認するためにはを呼び出してください。 この関数のパラメータはと同様に扱われます。 @@ -7629,7 +7629,7 @@ int PQsendPrepare(PGconn *conn, Sends a request to execute a prepared statement with given parameters, without waiting for the result(s). --> -結果を待つことなく、指定したパラメータで準備された文の実行要求を送信します。 +結果を待つことなく、指定したパラメータでプリペアド文の実行要求を送信します。 int PQsendQueryPrepared(PGconn *conn, const char *stmtName, @@ -7647,7 +7647,7 @@ int PQsendQueryPrepared(PGconn *conn, The function's parameters are handled identically to . --> -これはと似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前に準備された文の名前で指定されます。 +これはと似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前にプリペアド文の名前で指定されます。 この関数のパラメータはと同様に扱われます。 @@ -7662,7 +7662,7 @@ int PQsendQueryPrepared(PGconn *conn, Submits a request to obtain information about the specified prepared statement, without waiting for completion. --> -指定した準備された文に関する情報入手要求を送ります。 +指定したプリペアド文に関する情報入手要求を送ります。 入手完了まで待機しません。 int PQsendDescribePrepared(PGconn *conn, const char *stmtName); @@ -7722,7 +7722,7 @@ int PQsendDescribePortal(PGconn *conn, const char *portalName); Submits a request to close the specified prepared statement, without waiting for completion. --> -完了を待たずに、指定した準備された文を閉じる要求を送信します。 +完了を待たずに、指定したプリペアド文を閉じる要求を送信します。 int PQsendClosePrepared(PGconn *conn, const char *stmtName); @@ -8376,7 +8376,7 @@ int PQflush(PGconn *conn); --> 1つの操作が前の操作の結果に依存することは問題ありません。 たとえば、1つの問い合わせが同じパイプラインの次の問い合わせが使用するテーブルを定義することができます。 -同様に、アプリケーションは名前付きのプリペアドステートメントを作成し、同じパイプラインの後のステートメントで実行することができます。 +同様に、アプリケーションは名前付きのプリペアド文を作成し、同じパイプラインの後のステートメントで実行することができます。 @@ -9932,7 +9932,7 @@ int PQrequestCancel(PGconn *conn); このインタフェースは安全ではないため、使用しないでください。 result_is_intが0に設定されている場合、PQfnは、要求されたバイト数に対してデータに十分なスペースがあるかどうかにかかわらず、result_bufの末尾を超えてバッファを書き込むことができます。 さらに、これは廃止されました。 -関数呼び出しを定義するためにプリペアドステートメントを設定することによって、同等のパフォーマンスおよびより多くの機能を得られるからです。 +関数呼び出しを定義するためにプリペアド文を設定することによって、同等のパフォーマンスおよびより多くの機能を得られるからです。 そして、パラメータおよび結果のバイナリ伝送を伴うステートメントを実行すると、近道関数呼び出しの代わりになります。 diff --git a/doc/src/sgml/libpq1.sgml b/doc/src/sgml/libpq1.sgml index 6fcfbf0fd1c..f55a3ce118f 100644 --- a/doc/src/sgml/libpq1.sgml +++ b/doc/src/sgml/libpq1.sgml @@ -350,7 +350,7 @@ SELECT * FROM mytable WHERE x = $1::bigint; Submits a request to create a prepared statement with the given parameters, and waits for completion. --> -指定パラメータを持つ準備された文の作成要求を送信し、その完了を待ちます。 +指定パラメータを持つプリペアド文の作成要求を送信し、その完了を待ちます。 PGresult *PQprepare(PGconn *conn, const char *stmtName, @@ -367,7 +367,7 @@ PGresult *PQprepare(PGconn *conn, commands to be executed repeatedly without being parsed and planned each time; see for details. --> -は、後でを使用して実行する準備された文を作成します。 +は、後でを使用して実行するプリペアド文を作成します。 この機能を使用すると、コマンドを実行の度に解析して計画することなく、繰り返し実行することができます。 詳しくはを参照してください。 @@ -396,7 +396,7 @@ PGresult *PQprepare(PGconn *conn, for a means to find out what data types were inferred.) --> -この関数はquery文字列からstmtNameという名前の準備された文を作成します。 +この関数はquery文字列からstmtNameという名前のプリペアド文を作成します。 queryは単一のSQLコマンドでなければなりません。 stmtNameを""にして、無名の文を作成することができます。 もし、無名の文が既に存在していた場合は自動的に置き換えられます。 @@ -434,7 +434,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること be created by executing SQL statements. --> -で使用するための準備された文は、SQL 文を実行して作成することもできます。 +で使用するためのプリペアド文は、SQL 文を実行して作成することもできます。 @@ -448,7 +448,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること Sends a request to execute a prepared statement with given parameters, and waits for the result. --> -指定パラメータによる準備された文の実行要求を送信し、結果を待ちます。 +指定パラメータによるプリペアド文の実行要求を送信し、結果を待ちます。 PGresult *PQexecPrepared(PGconn *conn, const char *stmtName, @@ -470,7 +470,7 @@ PGresult *PQexecPrepared(PGconn *conn, executed. The statement must have been prepared previously in the current session. --> -とは似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前に準備された文を指名することで指定されます。 +とは似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前にプリペアド文を指名することで指定されます。 この機能により、繰り返し使用する予定のコマンドを実行する度にではなく、一度だけ解析、計画作成を行うことができます。 この文は現在のセッションで事前に準備されていなければなりません。 @@ -482,9 +482,9 @@ PGresult *PQexecPrepared(PGconn *conn, paramTypes[] parameter is not present (it is not needed since the prepared statement's parameter types were determined when it was created). --> -パラメータは、問い合わせ文字列ではなく指定された準備された文の名前を与える点を除き、と同じです。 +パラメータは、問い合わせ文字列ではなく指定されたプリペアド文の名前を与える点を除き、と同じです。 また、paramTypes[]パラメータは存在しません。 -(準備された文のパラメータ型はその作成時点で決定されているため、これは不要です。) +(プリペアド文のパラメータ型はその作成時点で決定されているため、これは不要です。) @@ -498,7 +498,7 @@ PGresult *PQexecPrepared(PGconn *conn, Submits a request to obtain information about the specified prepared statement, and waits for completion. --> -指定した準備された文に関する情報入手要求を送り、入手完了まで待機します。 +指定したプリペアド文に関する情報入手要求を送り、入手完了まで待機します。 PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); @@ -509,7 +509,7 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); allows an application to obtain information about a previously prepared statement. --> -により、アプリケーションは事前に準備された文に関する情報を入手できます。 +により、アプリケーションは事前にプリペアド文に関する情報を入手できます。 @@ -527,9 +527,9 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); result columns (if any) of the statement. --> stmtNameを""またはNULLとすることで、無名の文を参照することができます。 -これ以外では、存在する準備された文の名前でなければなりません。 +これ以外では、存在するプリペアド文の名前でなければなりません。 成功すると、PGRES_COMMAND_OKというステータスのPGresultが返されます。 -および関数をこのPGresultに適用して、準備された文のパラメータに関する情報を得ることができます。 +および関数をこのPGresultに適用して、プリペアド文のパラメータに関する情報を得ることができます。 また、、、関数などを使用して、文の結果列（もしあれば）に関する情報を提供できます。 @@ -590,7 +590,7 @@ PGresult *PQdescribePortal(PGconn *conn, const char *portalName); Submits a request to close the specified prepared statement, and waits for completion. --> -指定した準備された文をクローズする要求を送信し、完了を待機します。 +指定したプリペアド文をクローズする要求を送信し、完了を待機します。 PGresult *PQclosePrepared(PGconn *conn, const char *stmtName); @@ -603,7 +603,7 @@ PGresult *PQclosePrepared(PGconn *conn, const char *stmtName); of its associated resources on the server and allows its name to be reused. --> -を使用すると、アプリケーションは以前に作られた準備された文を閉じることができます。 +を使用すると、アプリケーションは以前に作られたプリペアド文を閉じることができます。 文を閉じると、サーバ上の関連するすべてのリソースが解放され、その名前を再利用できるようになります。 @@ -1993,7 +1993,7 @@ int PQgetlength(const PGresult *res, -準備された文のパラメータ数を返します。 +プリペアド文のパラメータ数を返します。 int PQnparams(const PGresult *res); @@ -2902,7 +2902,7 @@ int PQsendQueryParams(PGconn *conn, Sends a request to create a prepared statement with the given parameters, without waiting for completion. --> -指定パラメータを持つ準備された文の作成要求を送信します。 +指定パラメータを持つプリペアド文の作成要求を送信します。 その完了を待ちません。 int PQsendPrepare(PGconn *conn, @@ -2922,7 +2922,7 @@ int PQsendPrepare(PGconn *conn, --> これはの非同期版です。 要求の登録に成功した場合1が、失敗した場合0が返されます。 -呼び出しの成功の後、サーバが準備された文の生成に成功したかを確認するためにはを呼び出してください。 +呼び出しの成功の後、サーバがプリペアド文の生成に成功したかを確認するためにはを呼び出してください。 この関数のパラメータはと同様に扱われます。 @@ -2937,7 +2937,7 @@ int PQsendPrepare(PGconn *conn, Sends a request to execute a prepared statement with given parameters, without waiting for the result(s). --> -結果を待つことなく、指定したパラメータで準備された文の実行要求を送信します。 +結果を待つことなく、指定したパラメータでプリペアド文の実行要求を送信します。 int PQsendQueryPrepared(PGconn *conn, const char *stmtName, @@ -2955,7 +2955,7 @@ int PQsendQueryPrepared(PGconn *conn, The function's parameters are handled identically to . --> -これはと似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前に準備された文の名前で指定されます。 +これはと似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前にプリペアド文の名前で指定されます。 この関数のパラメータはと同様に扱われます。 @@ -2970,7 +2970,7 @@ int PQsendQueryPrepared(PGconn *conn, Submits a request to obtain information about the specified prepared statement, without waiting for completion. --> -指定した準備された文に関する情報入手要求を送ります。 +指定したプリペアド文に関する情報入手要求を送ります。 入手完了まで待機しません。 int PQsendDescribePrepared(PGconn *conn, const char *stmtName); @@ -3030,7 +3030,7 @@ int PQsendDescribePortal(PGconn *conn, const char *portalName); Submits a request to close the specified prepared statement, without waiting for completion. --> -完了を待たずに、指定した準備された文を閉じる要求を送信します。 +完了を待たずに、指定したプリペアド文を閉じる要求を送信します。 int PQsendClosePrepared(PGconn *conn, const char *stmtName); @@ -3684,7 +3684,7 @@ int PQflush(PGconn *conn); --> 1つの操作が前の操作の結果に依存することは問題ありません。 たとえば、1つの問い合わせが同じパイプラインの次の問い合わせが使用するテーブルを定義することができます。 -同様に、アプリケーションは名前付きのプリペアドステートメントを作成し、同じパイプラインの後のステートメントで実行することができます。 +同様に、アプリケーションは名前付きのプリペアド文を作成し、同じパイプラインの後のステートメントで実行することができます。 diff --git a/doc/src/sgml/libpq2.sgml b/doc/src/sgml/libpq2.sgml index fcc48e9f94d..962cf239a50 100644 --- a/doc/src/sgml/libpq2.sgml +++ b/doc/src/sgml/libpq2.sgml @@ -1009,7 +1009,7 @@ int PQrequestCancel(PGconn *conn); 《機械翻訳》このインタフェースは安全ではないため、使用しないでください。 result_is_intが0に設定されている場合、PQfnは、要求されたバイト数に対してデータに十分なスペースがあるかどうかにかかわらず、result_bufの末尾を超えてバッファを書き込むことができます。 さらに、これは廃止されました。 -関数呼び出しを定義するためにプリペアドステートメントを設定することによって、同様のパフォーマンスおよびより大きな機能を達成できます。 +関数呼び出しを定義するためにプリペアド文を設定することによって、同様のパフォーマンスおよびより大きな機能を達成できます。 次に、パラメータおよび結果のバイナリ伝送を伴うステートメントを実行すると、fast-パス関数呼び出しの代わりになります。 diff --git a/doc/src/sgml/parallel.sgml b/doc/src/sgml/parallel.sgml index 6d981c0f2f3..a4ba92d276c 100644 --- a/doc/src/sgml/parallel.sgml +++ b/doc/src/sgml/parallel.sgml @@ -823,7 +823,7 @@ btree以外のインデックススキャンのような他のスキャンタイ this last reason. --> 関数あるいは集約は、データベースに書き込むか、（エラー回復のためにサブトランザクションを使う場合以外で）トランザクションの状態を変更するか、シーケンスにアクセスするか、あるいは、恒久的な設定変更を行う場合、PARALLEL UNSAFEとマークされなければなりません。 -同様に関数は、一時テーブル、クライアントの接続状態、カーソル、準備された文、システムがワーカーの間で同期できないその他のバックエンドローカルな状態にアクセスする場合、PARALLEL RESTRICTEDとマークされなければなりません。 +同様に関数は、一時テーブル、クライアントの接続状態、カーソル、プリペアド文、システムがワーカーの間で同期できないその他のバックエンドローカルな状態にアクセスする場合、PARALLEL RESTRICTEDとマークされなければなりません。 たとえば、setseedとrandomは、最後の理由により、パラレル制限です。 diff --git a/doc/src/sgml/perform.sgml b/doc/src/sgml/perform.sgml index eaf159fe6c5..203bbf0eb57 100644 --- a/doc/src/sgml/perform.sgml +++ b/doc/src/sgml/perform.sgml @@ -2678,7 +2678,7 @@ SELECT * FROM x, y, a, b, c WHERE something AND somethingelse; COPYを使用できない場合、準備されたINSERT文をPREPAREを使用して作成し、必要な回数だけEXECUTEを実行する方が良いでしょう。 これにより、繰り返し行われるINSERTの解析と計画作成分のオーバーヘッドを省くことになります。 この機能のための方法はインタフェースによって異なります。 -このインタフェースの文書の準備された文を参照してください。 +このインタフェースの文書のプリペアド文を参照してください。 diff --git a/doc/src/sgml/pgoverexplain.sgml b/doc/src/sgml/pgoverexplain.sgml index c9ce5339536..257fba46750 100644 --- a/doc/src/sgml/pgoverexplain.sgml +++ b/doc/src/sgml/pgoverexplain.sgml @@ -191,7 +191,7 @@ LOAD 'pg_overexplain'; --> Executor Parameter Types。 各エグゼキュータパラメータの型OID（たとえば、ネステッドループが選択されて内側のインデックススキャンに値を渡すためにパラメータが使用される場合）。 -ユーザがプリペアドステートメントに提供するパラメータは含まれません。 +ユーザがプリペアド文に提供するパラメータは含まれません。 diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml index b89eb051801..0ca7ef116e3 100644 --- a/doc/src/sgml/plpgsql.sgml +++ b/doc/src/sgml/plpgsql.sgml @@ -1402,8 +1402,8 @@ PREPARE statement_name(integer, integer) AS SELECT $1 they are useful to know when trying to diagnose a problem. More information appears in . --> -と同等なプリペアドステートメントが作成されます。 -そしてIF文を実行する度にPL/pgSQLの最新の変数値をパラメータ値として供給して、このプリペアドステートメントに対してEXECUTEを行います。 +と同等なプリペアド文が作成されます。 +そしてIF文を実行する度にPL/pgSQLの最新の変数値をパラメータ値として供給して、このプリペアド文に対してEXECUTEを行います。 通常この詳細は、PL/pgSQLユーザにとって重要ではありませんが、この知識は問題点の解析に有用です。 それ以外の情報は、に記述されています。 @@ -7202,8 +7202,8 @@ $$ LANGUAGE plpgsql; errors will be detected during the initial parsing pass, but anything deeper will not be detected until execution.) --> -各式やSQLコマンドが初めてその関数で実行される時に、PL/pgSQLインタプリタはSPIマネージャのSPI_prepare関数を使用して、プリペアドステートメントを作成するためにコマンドを解析します。 -その後にその式やコマンドが行われる時には、そのプリペアドステートメントを再利用します。 +各式やSQLコマンドが初めてその関数で実行される時に、PL/pgSQLインタプリタはSPIマネージャのSPI_prepare関数を使用して、プリペアド文を作成するためにコマンドを解析します。 +その後にその式やコマンドが行われる時には、そのプリペアド文を再利用します。 こうして、めったに分岐されない条件付きコードパスを持つ関数では、現在のセッションで実行されないそれらのコマンドの解析によるオーバーヘッドを背負いこむことはありません。 欠点は特定の式や問い合わせのエラーが、関数の該当部分が実行されるまで検出されないことです。 （典型的な構文エラーは、最初の解釈において検出されますが、それより深いエラーは、実行の時まで検出されません。） @@ -7226,12 +7226,12 @@ $$ LANGUAGE plpgsql; linkend="sql-prepare"/> for more information about the behavior of prepared statements. --> -PL/pgSQLは（正確にはSPIマネージャは）さらに特定のプリペアドステートメントに関する実行計画のキャッシュを試行できます。 -キャッシュした実行計画が使用されなかった場合、プリペアドステートメントが呼び出される度に新しい実行計画が作成され、選択した実行計画を最適にするために、最新のパラメータ値（すなわちPL/pgSQLの変数値）が使用されます。 -プリペアドステートメントがパラメータを持たないか何回も使用される場合、SPIマネージャは特定のパラメータ値に依存しない一般的な実行計画の作成を考え、再使用のためにキャッシュします。 +PL/pgSQLは（正確にはSPIマネージャは）さらに特定のプリペアド文に関する実行計画のキャッシュを試行できます。 +キャッシュした実行計画が使用されなかった場合、プリペアド文が呼び出される度に新しい実行計画が作成され、選択した実行計画を最適にするために、最新のパラメータ値（すなわちPL/pgSQLの変数値）が使用されます。 +プリペアド文がパラメータを持たないか何回も使用される場合、SPIマネージャは特定のパラメータ値に依存しない一般的な実行計画の作成を考え、再使用のためにキャッシュします。 典型的には、これは参照したPL/pgSQLの変数値が、実行計画にさほど影響しない場合にだけ起こります。 それならば、毎回の実行計画の作成の方が優れています。 -プリペアドステートメントに関する詳細はを参照してください。 +プリペアド文に関する詳細はを参照してください。 @@ -7247,7 +7247,7 @@ $$ LANGUAGE plpgsql; statement — at the price of performing new parse analysis and constructing a new execution plan on every execution. --> -このようにPL/pgSQLはプリペアドステートメントおよび時には実行計画を保存しますので、PL/pgSQL関数内に直接現れるSQLコマンドは実行の度に同じテーブルとフィールドを参照しなければなりません。 +このようにPL/pgSQLはプリペアド文および時には実行計画を保存しますので、PL/pgSQL関数内に直接現れるSQLコマンドは実行の度に同じテーブルとフィールドを参照しなければなりません。 つまり、SQLコマンドにて、テーブルやフィールドの名前としてパラメータを使用することができません。 実行の度に新しく実行計画を作成して解析する無駄を覚悟で、PL/pgSQLのEXECUTE文を使った動的問い合わせを構成することで、この制限を回避できます。 @@ -7279,7 +7279,7 @@ $$ LANGUAGE plpgsql; successfully with a column named key even if it happens to have different types in different tables. --> -同一の関数が2つ以上のテーブルのトリガとして使用される場合、PL/pgSQLはテーブルごとのプリペアドステートメントをキャッシュします。 +同一の関数が2つ以上のテーブルのトリガとして使用される場合、PL/pgSQLはテーブルごとのプリペアド文をキャッシュします。 すなわち、各々のトリガ関数とテーブルの組ごとにキャッシュするのであり、トリガ関数ごとではありません。 このため、データ型の変更に伴う問題の一部を軽減します。 例えば、別のテーブルにある異なったデータ型であっても、keyと命名した列に対してトリガ関数は有効に作動します。 @@ -7292,7 +7292,7 @@ $$ LANGUAGE plpgsql; been invoked for, so that data type differences do not cause unexpected failures. --> -同様に、多様型の引数を持った関数は、実際に呼び出す引数の型の組み合わせごとに別々のプリペアドステートメントをキャッシュします。 +同様に、多様型の引数を持った関数は、実際に呼び出す引数の型の組み合わせごとに別々のプリペアド文をキャッシュします。 そのため、データ型の差異が原因で予期しない失敗が起こることはありません。 @@ -7302,7 +7302,7 @@ $$ LANGUAGE plpgsql; interpretation of time-sensitive values. For example there is a difference between what these two functions do: --> -プリペアドステートメントのキャッシュにより、時間に依存する値の解釈の結果に違いが現れることがあります。 +プリペアド文のキャッシュにより、時間に依存する値の解釈の結果に違いが現れることがあります。 例えば、以下の2つの関数の結果は異なります。 diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index bcf9866c3be..753cfada495 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -799,7 +799,7 @@ pgbench options d - prepared: プリペアドステートメントを伴う拡張問い合わせプロトコルを使用します。 + prepared: プリペアド文を伴う拡張問い合わせプロトコルを使用します。 diff --git a/doc/src/sgml/release-18.sgml b/doc/src/sgml/release-18.sgml index 86b86793296..27bde70e1b3 100644 --- a/doc/src/sgml/release-18.sgml +++ b/doc/src/sgml/release-18.sgml @@ -4247,7 +4247,7 @@ Branch: REL_14_STABLE [ae45c7296] 2026-01-06 17:31:20 +1300 set up as a prepared statement, re-executions would misbehave too. --> この誤りにより、問い合わせに対して起動されたイベントトリガは、複数のpublishオプションが指定されていたとしても、最初のオプションしか認識しないという目に見える影響がありました。 -このような問い合わせがプリペアドステートメントとして設定されていた場合、再実行時も不正な動作が発生していました。 +このような問い合わせがプリペアド文として設定されていた場合、再実行時も不正な動作が発生していました。 @@ -10493,7 +10493,7 @@ Branch: master Release: REL_18_BR [fc39b286a] 2025-06-24 13:12:46 +0900 Allow psql to parse, bind, and close named prepared statements (Anthonin Bonnefoy, Michael Paquier) --> -psqlで名前付きプリペアドステートメントのパース、バインド、クローズができるようになりました。 +psqlで名前付きプリペアド文のパース、バインド、クローズができるようになりました。 (Anthonin Bonnefoy, Michael Paquier) § § diff --git a/doc/src/sgml/spi.sgml b/doc/src/sgml/spi.sgml index d34658a1793..bd7e5b6a202 100644 --- a/doc/src/sgml/spi.sgml +++ b/doc/src/sgml/spi.sgml @@ -1419,9 +1419,9 @@ SPIPlanPtr SPI_prepare(const char * command, int SPI_execute_plan. --> -SPI_prepareは指定したコマンド用の準備済み文を作成し、それを返します。 +SPI_prepareは指定したコマンド用のプリペアド文を作成し、それを返します。 しかし、そのコマンドは実行しません。 -その準備済み文はSPI_execute_planを使って後で繰り返し実行できます。 +そのプリペアド文はSPI_execute_planを使って後で繰り返し実行できます。 @@ -1438,8 +1438,8 @@ SPIPlanPtr SPI_prepare(const char * command, int 同じ、あるいは類似のコマンドが繰り返し実行される場合、一度だけ解析を計画作成を行うことには一般に利点があります。 また、コマンドの実行計画を再利用することにはさらに利点があるかも知れません。 -SPI_prepareはコマンド文字列を、解析結果をカプセル化した準備済み文に変換します。 -実行の度に独自計画を生成するのが役に立たないと分かった場合には、準備済み文は実行計画をキャッシュする場所も提供します。 +SPI_prepareはコマンド文字列を、解析結果をカプセル化したプリペアド文に変換します。 +実行の度に独自計画を生成するのが役に立たないと分かった場合には、プリペアド文は実行計画をキャッシュする場所も提供します。 @@ -1534,7 +1534,7 @@ SPIPlanPtr SPI_prepare(const char * command, int argtypes is NULL. --> SPI_prepareはSPIPlanへの非NULLのポインタを返します。 -ここでSPIPlanは準備済み文を表すopaque構造体です。 +ここでSPIPlanはプリペアド文を表すopaque構造体です。 エラーの場合、NULLが返され、SPI_executeで使用されるエラーコードと同じコードの1つがSPI_resultに設定されます。 しかし、commandがNULLの場合や、nargsが0未満の場合、nargsが0より大きくかつargtypesがNULLの場合は、SPI_ERROR_ARGUMENTに設定されます。 @@ -1564,7 +1564,7 @@ SPIPlanPtr SPI_prepare(const char * command, int パラメータが定義されていなければ、SPI_execute_planが最初に使用された時に一般的な計画が作成され、以降の実行すべてでも利用されます。 パラメータがあれば、始めの何回かのSPI_execute_planの使用で、与えられたパラメータの値に固有の独自計画が作成されます。 -同じ準備済み文が十分に使用された後、SPI_execute_planは一般的な計画を作成し、独自計画よりもそれほど高価でなければ、毎回再計画する代わりに一般的な計画を使い始めるようになります。 +同じプリペアド文が十分に使用された後、SPI_execute_planは一般的な計画を作成し、独自計画よりもそれほど高価でなければ、毎回再計画する代わりに一般的な計画を使い始めるようになります。 このデフォルトの動作が不適切であれば、SPI_prepare_cursorにCURSOR_OPT_GENERIC_PLANまたはCURSOR_OPT_CUSTOM_PLANフラグを設定することで、それぞれ一般的な計画か独自計画を強制的に利用するよう変更できます。 @@ -1806,7 +1806,7 @@ SPIPlanPtr SPI_prepare_extended(const char * command, the parsing of external parameter references, as well as other facets of query parsing and planning. --> -SPI_prepare_extendedは指定したコマンド用の準備済み文を作成し、それを返します。しかし、そのコマンドは実行しません。 +SPI_prepare_extendedは指定したコマンド用のプリペアド文を作成し、それを返します。しかし、そのコマンドは実行しません。 この関数は、呼び出し元が、問い合わせの解析や計画のその他の面だけでなく、外部のパラメータ参照の解析も制御するオプションを指定できる追加機能のあるSPI_prepareと等価です。 @@ -1966,7 +1966,7 @@ SPIPlanPtr SPI_prepare_params(const char * command, with the addition that the caller can specify parser hook functions to control the parsing of external parameter references. --> -SPI_prepare_paramsは指定したコマンドの準備済み文を作成し返します。 +SPI_prepare_paramsは指定したコマンドのプリペアド文を作成し返します。 しかしそのコマンドを実行しません。 この関数はSPI_prepare_cursorと同じですが、呼び出し元が外部パラメータ参照の解析を制御するパーサフック関数を指定できる点が追加されています。 @@ -2110,7 +2110,7 @@ int SPI_getargcount(SPIPlanPtr plan) -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2193,7 +2193,7 @@ Oid SPI_getargtypeid(SPIPlanPtr plan, int argI -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2279,7 +2279,7 @@ bool SPI_is_cursor_plan(SPIPlanPtr plan) UPDATE is allowed only if it contains a RETURNING clause. --> -SPI_prepareで準備済み文がSPI_cursor_openへの引数として渡すことができる場合、SPI_is_cursor_planはtrueを返します。 +SPI_prepareでプリペアド文がSPI_cursor_openへの引数として渡すことができる場合、SPI_is_cursor_planはtrueを返します。 渡すことができない場合はfalseを返します。 この基準は、planが単一のコマンドであり、かつ、そのコマンドが呼び出し元にタプルを返すことです。 例えば、INTO句を含んでいないSELECTは可能です。 @@ -2301,7 +2301,7 @@ bool SPI_is_cursor_plan(SPIPlanPtr plan) -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2389,7 +2389,7 @@ int SPI_execute_plan(SPIPlanPtr plan, Datum * -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2605,7 +2605,7 @@ int SPI_execute_plan_extended(SPIPlanPtr plan, -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2840,7 +2840,7 @@ int SPI_execute_plan_with_paramlist(SPIPlanPtr plan, -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -2964,7 +2964,7 @@ int SPI_execp(SPIPlanPtr plan, Datum * values< -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -3152,7 +3152,7 @@ C関数の呼び出し元にポータルの名前を返すことで、結果と -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -3547,7 +3547,7 @@ Portal SPI_cursor_open_with_paramlist(const char *name, -（SPI_prepareで返される）準備済み文 +（SPI_prepareで返される）プリペアド文 @@ -4473,7 +4473,7 @@ void SPI_cursor_close(Portal portal) - 準備済み文を保持する + プリペアド文を保持する @@ -4497,7 +4497,7 @@ int SPI_keepplan(SPIPlanPtr plan) invocations of your C function in the current session. --> SPI_keepplanは渡された（SPI_prepareで準備された）文をSPI_finishとトランザクションマネージャで解放されないメモリ内に保存します。 -これは、現在のセッションにおける、その後のC関数の呼び出しで準備済み文を再利用できる機能を提供します。 +これは、現在のセッションにおける、その後のC関数の呼び出しでプリペアド文を再利用できる機能を提供します。 @@ -4515,7 +4515,7 @@ int SPI_keepplan(SPIPlanPtr plan) -保存する準備済み文 +保存するプリペアド文 @@ -4572,7 +4572,7 @@ int SPI_keepplan(SPIPlanPtr plan) - 準備済み文を保存する + プリペアド文を保存する @@ -4598,7 +4598,7 @@ SPIPlanPtr SPI_saveplan(SPIPlanPtr plan) --> SPI_saveplanは渡された（SPI_prepareで準備された）文をSPI_finishとトランザクションマネージャで解放されないメモリ内にコピーします。 そして、コピーした文のポインタを返します。 -これは、現在のセッションにおける、その後のC関数の呼び出しで準備済み文を再利用できる機能を提供します。 +これは、現在のセッションにおける、その後のC関数の呼び出しでプリペアド文を再利用できる機能を提供します。 @@ -4616,7 +4616,7 @@ SPIPlanPtr SPI_saveplan(SPIPlanPtr plan) -保存する準備済み文 +保存するプリペアド文 @@ -4688,7 +4688,7 @@ SPIPlanPtr SPI_saveplan(SPIPlanPtr plan) function, since it accomplishes largely the same result without needing to physically copy the prepared statement's data structures. --> -準備済み文のデータ構造を物理的にコピーする必要なく、ほとんど同じ結果をもたらしますので、たいていの場合、この関数よりもSPI_keepplanの方が好ましいです。 +プリペアド文のデータ構造を物理的にコピーする必要なく、ほとんど同じ結果をもたらしますので、たいていの場合、この関数よりもSPI_keepplanの方が好ましいです。 @@ -6995,7 +6995,7 @@ void SPI_freetuptable(SPITupleTable * tuptable) - 以前に保存した準備済み文を解放する + 以前に保存したプリペアド文を解放する @@ -7016,7 +7016,7 @@ int SPI_freeplan(SPIPlanPtr plan) previously returned by SPI_prepare or saved by SPI_keepplan or SPI_saveplan. --> -SPI_freeplanは、以前にSPI_prepareから返された、あるいはSPI_keepplanやSPI_saveplanで保存された準備済み文を解放します。 +SPI_freeplanは、以前にSPI_prepareから返された、あるいはSPI_keepplanやSPI_saveplanで保存されたプリペアド文を解放します。 diff --git a/doc/src/sgml/system-views.sgml b/doc/src/sgml/system-views.sgml index 30365e506b5..f9f5559c557 100644 --- a/doc/src/sgml/system-views.sgml +++ b/doc/src/sgml/system-views.sgml @@ -203,7 +203,7 @@ - 準備済みの文 + プリペアド文 @@ -3239,8 +3239,8 @@ trueの場合は、マテリアライズドビューが現在データ投入さ session. See for more information about prepared statements. --> -pg_prepared_statementsビューは現在のセッションで利用可能な準備済み文をすべて表示します。 -準備済み文についての詳細はを参照してください。 +pg_prepared_statementsビューは現在のセッションで利用可能なプリペアド文をすべて表示します。 +プリペアド文についての詳細はを参照してください。 @@ -3250,8 +3250,8 @@ trueの場合は、マテリアライズドビューが現在データ投入さ prepared statement is created and removed when a prepared statement is released (for example, via the DEALLOCATE command). --> -pg_prepared_statementsには、1つの準備済み文に対して一行が存在します。 -新しい準備済み文が作成されると行が追加され、準備済み文が解放される（例えばDEALLOCATEを使用）と行が削除されます。 +pg_prepared_statementsには、1つのプリペアド文に対して一行が存在します。 +新しいプリペアド文が作成されると行が追加され、プリペアド文が解放される（例えばDEALLOCATEを使用）と行が削除されます。 @@ -3286,7 +3286,7 @@ trueの場合は、マテリアライズドビューが現在データ投入さ -準備済み文の識別子 +プリペアド文の識別子 @@ -3303,9 +3303,9 @@ trueの場合は、マテリアライズドビューが現在データ投入さ frontend/backend protocol, this is the text of the prepared statement itself. --> -この準備済み文を作成するためにクライアントが送付した問い合わせ文字列。 -SQL経由で作成された準備済み文では、これはクライアントが送信したPREPARE文です。 -フロントエンド/バックエンドプロトコル経由で作成された準備済み文では、これは準備済み文自身のテキストです。 +このプリペアド文を作成するためにクライアントが送付した問い合わせ文字列。 +SQL経由で作成されたプリペアド文では、これはクライアントが送信したPREPARE文です。 +フロントエンド/バックエンドプロトコル経由で作成されたプリペアド文では、これはプリペアド文自身のテキストです。 @@ -3317,7 +3317,7 @@ SQL経由で作成された準備済み文では、これはクライアント -準備済み文が作成された時間 +プリペアド文が作成された時間 @@ -3332,7 +3332,7 @@ SQL経由で作成された準備済み文では、これはクライアント to an element of this array can be obtained by casting the regtype value to oid. --> -regtype配列形式の準備済み文が想定しているパラメータ型。 +regtype配列形式のプリペアド文が想定しているパラメータ型。 配列要素に対応するOIDは、regtypeからoidへのキャストを行うことで取り出すことができます。 @@ -3350,9 +3350,9 @@ SQL経由で作成された準備済み文では、これはクライアント If the prepared statement does not provide a result (e.g., a DML statement), then this field will be null. --> -regtype配列形式の準備済み文が返す列の型。 +regtype配列形式のプリペアド文が返す列の型。 配列要素に対応するOIDは、regtypeからoidへのキャストを行うことで取り出すことができます。 -準備済み文が結果を提供しない場合（例えばDML文）は、このフィールドはNULLになります。 +プリペアド文が結果を提供しない場合（例えばDML文）は、このフィールドはNULLになります。 @@ -3367,7 +3367,7 @@ SQL経由で作成された準備済み文では、これはクライアント false if the statement was prepared via the frontend/backend protocol --> -trueの場合は、準備済み文がPREPARE SQLコマンド経由で作成された。 +trueの場合は、プリペアド文がPREPARE SQLコマンド経由で作成された。 falseの場合は、フロントエンド/バックエンドプロトコル経由で文が準備された