Skip to content

prepared statementの訳語をプリペアド文に統一しました #3708

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
noborus wants to merge 1 commit into
base: doc_ja_18
Choose a base branch
from
Open

prepared statementの訳語をプリペアド文に統一しました #3708

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/src/sgml/config.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9843,7 +9843,7 @@ SELECT * FROM parent WHERE key = 2400;
not when it is prepared.
For more information see <xref linkend="sql-prepare"/>.
-->
準備された文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。
プリペアド文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。
カスタムプランは実行ごとに指定されたパラメータ値の集合で新たに作られます。
一方汎用プランはパラメータ値に依存せず、複数の実行にまたがって再利用できます。
したがって、汎用プランはプランニングに要する時間を節約できますが、理想的なプランがパラメータ値に強く依存している場合は、汎用プランは非効率かも知れません。
Expand Down
2 changes: 1 addition & 1 deletion doc/src/sgml/config2.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@
not when it is prepared.
For more information see <xref linkend="sql-prepare"/>.
-->
準備された文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。
プリペアド文（明示的に準備されたものあるいはPL/pgSQLのように暗黙的に生成されたもののどちらにおいても）は、カスタムあるいは汎用(generic)プランで実行することができます。
カスタムプランは実行ごとに指定されたパラメータ値の集合で新たに作られます。
一方汎用プランはパラメータ値に依存せず、複数の実行にまたがって再利用できます。
したがって、汎用プランはプランニングに要する時間を節約できますが、理想的なプランがパラメータ値に強く依存している場合は、汎用プランは非効率かも知れません。
Expand Down
2 changes: 1 addition & 1 deletion doc/src/sgml/datatype.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3753,7 +3753,7 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'
For example, <literal>CURRENT_DATE + 1</literal> is safer than
<literal>'tomorrow'::date</literal>.
-->
入力する文字列として<literal>now</literal>、<literal>today</literal>、<literal>tomorrow</literal>及び<literal>yesterday</literal>はインタラクティブなSQLコマンドの中で利用する時は良いですが、コマンドが保存され後に実行されるような時には驚く挙動になることがあります。例えば、準備された文、ビューや関数の定義です。
入力する文字列として<literal>now</literal>、<literal>today</literal>、<literal>tomorrow</literal>及び<literal>yesterday</literal>はインタラクティブなSQLコマンドの中で利用する時は良いですが、コマンドが保存され後に実行されるような時には驚く挙動になることがあります。例えば、プリペアド文、ビューや関数の定義です。
文字列は特定の時間の値に変換され、その値が古くなってからもしばらく使い続けられることがあります。
このような状況では、代わりにSQL関数を使用してください。
例えば、<literal>'tomorrow'::date</literal>よりも<literal>CURRENT_DATE + 1</literal>の方が安全です。
Expand Down
2 changes: 1 addition & 1 deletion doc/src/sgml/jit.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,7 @@
not the settings at execution time.
-->
これらのコストに基づく決定は実行時ではなく、プラン時に行われます。
このことは、準備された文が使われ、汎用プラン(<xref linkend="sql-prepare"/>参照)が用いられるときには、実行時ではなく、準備時に参照される設定パラメータの値が決定を左右することを意味します。
このことは、プリペアド文が使われ、汎用プラン(<xref linkend="sql-prepare"/>参照)が用いられるときには、実行時ではなく、準備時に参照される設定パラメータの値が決定を左右することを意味します。
</para>

<note>
Expand Down
46 changes: 23 additions & 23 deletions doc/src/sgml/libpq.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
-->
指定パラメータを持つ準備された文の作成要求を送信し、その完了を待ちます。
指定パラメータを持つプリペアド文の作成要求を送信し、その完了を待ちます。
<synopsis>
PGresult *PQprepare(PGconn *conn,
const char *stmtName,
Expand All @@ -5059,7 +5059,7 @@ PGresult *PQprepare(PGconn *conn,
commands to be executed repeatedly without being parsed and
planned each time; see <xref linkend="sql-prepare"/> for details.
-->
<xref linkend="libpq-PQprepare"/>は、後で<xref linkend="libpq-PQexecPrepared"/>を使用して実行する準備された文を作成します。
<xref linkend="libpq-PQprepare"/>は、後で<xref linkend="libpq-PQexecPrepared"/>を使用して実行するプリペアド文を作成します。
この機能を使用すると、コマンドを実行の度に解析して計画することなく、繰り返し実行することができます。
詳しくは<xref linkend="sql-prepare"/>を参照してください。
</para>
Expand Down Expand Up @@ -5088,7 +5088,7 @@ PGresult *PQprepare(PGconn *conn,
<xref linkend="libpq-PQdescribePrepared"/> for a means to find out
what data types were inferred.)
-->
この関数は<parameter>query</parameter>文字列から<parameter>stmtName</parameter>という名前の準備された文を作成します。
この関数は<parameter>query</parameter>文字列から<parameter>stmtName</parameter>という名前のプリペアド文を作成します。
<parameter>query</parameter>は単一のSQLコマンドでなければなりません。
<parameter>stmtName</parameter>を<literal>""</literal>にして、無名の文を作成することができます。
もし、無名の文が既に存在していた場合は自動的に置き換えられます。
Expand Down Expand Up @@ -5126,7 +5126,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること
be created by executing SQL <xref linkend="sql-prepare"/>
statements.
-->
<xref linkend="libpq-PQexecPrepared"/>で使用するための準備された文は、SQL <xref linkend="sql-prepare"/>文を実行して作成することもできます。
<xref linkend="libpq-PQexecPrepared"/>で使用するためのプリペアド文は、SQL <xref linkend="sql-prepare"/>文を実行して作成することもできます。
</para>

<para>
Expand All @@ -5140,7 +5140,7 @@ NULLという結果はメモリ不足や全くコマンドを送信すること
Sends a request to execute a prepared statement with given
parameters, and waits for the result.
-->
指定パラメータによる準備された文の実行要求を送信し、結果を待ちます。
指定パラメータによるプリペアド文の実行要求を送信し、結果を待ちます。
<synopsis>
PGresult *PQexecPrepared(PGconn *conn,
const char *stmtName,
Expand All @@ -5162,7 +5162,7 @@ PGresult *PQexecPrepared(PGconn *conn,
executed. The statement must have been prepared previously in
the current session.
-->
<xref linkend="libpq-PQexecPrepared"/>と<xref linkend="libpq-PQexecParams"/>は似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前に準備された文を指名することで指定されます。
<xref linkend="libpq-PQexecPrepared"/>と<xref linkend="libpq-PQexecParams"/>は似ていますが、前者では実行されるコマンドは、問い合わせ文字列を与えるのではなく、事前にプリペアド文を指名することで指定されます。
この機能により、繰り返し使用する予定のコマンドを実行する度にではなく、一度だけ解析、計画作成を行うことができます。
この文は現在のセッションで事前に準備されていなければなりません。
</para>
Expand All @@ -5174,9 +5174,9 @@ PGresult *PQexecPrepared(PGconn *conn,
<parameter>paramTypes[]</parameter> parameter is not present (it is not needed since
the prepared statement's parameter types were determined when it was created).
-->
パラメータは、問い合わせ文字列ではなく指定された準備された文の名前を与える点を除き、<xref linkend="libpq-PQexecParams"/>と同じです。
パラメータは、問い合わせ文字列ではなく指定されたプリペアド文の名前を与える点を除き、<xref linkend="libpq-PQexecParams"/>と同じです。
また、<parameter>paramTypes[]</parameter>パラメータは存在しません。
(準備された文のパラメータ型はその作成時点で決定されているため、これは不要です。)
(プリペアド文のパラメータ型はその作成時点で決定されているため、これは不要です。)
</para>
</listitem>
</varlistentry>
Expand All @@ -5190,7 +5190,7 @@ PGresult *PQexecPrepared(PGconn *conn,
Submits a request to obtain information about the specified
prepared statement, and waits for completion.
-->
指定した準備された文に関する情報入手要求を送り、入手完了まで待機します。
指定したプリペアド文に関する情報入手要求を送り、入手完了まで待機します。
<synopsis>
PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);
</synopsis>
Expand All @@ -5201,7 +5201,7 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);
<xref linkend="libpq-PQdescribePrepared"/> allows an application to obtain
information about a previously prepared statement.
-->
<xref linkend="libpq-PQdescribePrepared"/>により、アプリケーションは事前に準備された文に関する情報を入手できます。
<xref linkend="libpq-PQdescribePrepared"/>により、アプリケーションは事前にプリペアド文に関する情報を入手できます。
</para>

<para>
Expand All @@ -5219,9 +5219,9 @@ PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);
result columns (if any) of the statement.
-->
<parameter>stmtName</parameter>を<literal>""</literal>または<symbol>NULL</symbol>とすることで、無名の文を参照することができます。
これ以外では、存在する準備された文の名前でなければなりません。
これ以外では、存在するプリペアド文の名前でなければなりません。
成功すると、<literal>PGRES_COMMAND_OK</literal>というステータスの<structname>PGresult</structname>が返されます。
<xref linkend="libpq-PQnparams"/>および<xref linkend="libpq-PQparamtype"/>関数をこの<structname>PGresult</structname>に適用して、準備された文のパラメータに関する情報を得ることができます。
<xref linkend="libpq-PQnparams"/>および<xref linkend="libpq-PQparamtype"/>関数をこの<structname>PGresult</structname>に適用して、プリペアド文のパラメータに関する情報を得ることができます。
また、<xref linkend="libpq-PQnfields"/>、<xref linkend="libpq-PQfname"/>、<xref linkend="libpq-PQftype"/>関数などを使用して、文の結果列（もしあれば）に関する情報を提供できます。
</para>
</listitem>
Expand Down Expand Up @@ -5282,7 +5282,7 @@ PGresult *PQdescribePortal(PGconn *conn, const char *portalName);
Submits a request to close the specified prepared statement, and waits
for completion.
-->
指定した準備された文をクローズする要求を送信し、完了を待機します。
指定したプリペアド文をクローズする要求を送信し、完了を待機します。
<synopsis>
PGresult *PQclosePrepared(PGconn *conn, const char *stmtName);
</synopsis>
Expand All @@ -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.
-->
<xref linkend="libpq-PQclosePrepared"/>を使用すると、アプリケーションは以前に作られた準備された文を閉じることができます。
<xref linkend="libpq-PQclosePrepared"/>を使用すると、アプリケーションは以前に作られたプリペアド文を閉じることができます。
文を閉じると、サーバ上の関連するすべてのリソースが解放され、その名前を再利用できるようになります。
</para>

Expand Down Expand Up @@ -6685,7 +6685,7 @@ int PQgetlength(const PGresult *res,
<!--
Returns the number of parameters of a prepared statement.
-->
準備された文のパラメータ数を返します。
プリペアド文のパラメータ数を返します。
<synopsis>
int PQnparams(const PGresult *res);
</synopsis>
Expand Down Expand Up @@ -7594,7 +7594,7 @@ int PQsendQueryParams(PGconn *conn,
Sends a request to create a prepared statement with the given
parameters, without waiting for completion.
-->
指定パラメータを持つ準備された文の作成要求を送信します。
指定パラメータを持つプリペアド文の作成要求を送信します。
その完了を待ちません。
<synopsis>
int PQsendPrepare(PGconn *conn,
Expand All @@ -7614,7 +7614,7 @@ int PQsendPrepare(PGconn *conn,
-->
これは<xref linkend="libpq-PQprepare"/>の非同期版です。
要求の登録に成功した場合1が、失敗した場合0が返されます。
呼び出しの成功の後、サーバが準備された文の生成に成功したかを確認するためには<xref linkend="libpq-PQgetResult"/>を呼び出してください。
呼び出しの成功の後、サーバがプリペアド文の生成に成功したかを確認するためには<xref linkend="libpq-PQgetResult"/>を呼び出してください。
この関数のパラメータは<xref linkend="libpq-PQprepare"/>と同様に扱われます。
</para>
</listitem>
Expand All @@ -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).
-->
結果を待つことなく、指定したパラメータで準備された文の実行要求を送信します。
結果を待つことなく、指定したパラメータでプリペアド文の実行要求を送信します。
<synopsis>
int PQsendQueryPrepared(PGconn *conn,
const char *stmtName,
Expand All @@ -7647,7 +7647,7 @@ int PQsendQueryPrepared(PGconn *conn,
The function's parameters are handled identically to
<xref linkend="libpq-PQexecPrepared"/>.
-->
これは<xref linkend="libpq-PQsendQueryParams"/>と似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前に準備された文の名前で指定されます。
これは<xref linkend="libpq-PQsendQueryParams"/>と似ていますが、実行されるコマンドは問い合わせ文字列ではなく、事前にプリペアド文の名前で指定されます。
この関数のパラメータは<xref linkend="libpq-PQexecPrepared"/>と同様に扱われます。
</para>
</listitem>
Expand All @@ -7662,7 +7662,7 @@ int PQsendQueryPrepared(PGconn *conn,
Submits a request to obtain information about the specified
prepared statement, without waiting for completion.
-->
指定した準備された文に関する情報入手要求を送ります。
指定したプリペアド文に関する情報入手要求を送ります。
入手完了まで待機しません。
<synopsis>
int PQsendDescribePrepared(PGconn *conn, const char *stmtName);
Expand Down Expand Up @@ -7722,7 +7722,7 @@ int PQsendDescribePortal(PGconn *conn, const char *portalName);
Submits a request to close the specified prepared statement, without
waiting for completion.
-->
完了を待たずに、指定した準備された文を閉じる要求を送信します。
完了を待たずに、指定したプリペアド文を閉じる要求を送信します。
<synopsis>
int PQsendClosePrepared(PGconn *conn, const char *stmtName);
</synopsis>
Expand Down Expand Up @@ -8376,7 +8376,7 @@ int PQflush(PGconn *conn);
-->
1つの操作が前の操作の結果に依存することは問題ありません。
たとえば、1つの問い合わせが同じパイプラインの次の問い合わせが使用するテーブルを定義することができます。
同様に、アプリケーションは名前付きのプリペアドステートメントを作成し、同じパイプラインの後のステートメントで実行することができます。
同様に、アプリケーションは名前付きのプリペアド文を作成し、同じパイプラインの後のステートメントで実行することができます。
</para>
</sect3>

Expand Down Expand Up @@ -9932,7 +9932,7 @@ int PQrequestCancel(PGconn *conn);
このインタフェースは安全ではないため、使用しないでください。
<parameter>result_is_int</parameter>が<literal>0</literal>に設定されている場合、<function>PQfn</function>は、要求されたバイト数に対してデータに十分なスペースがあるかどうかにかかわらず、<parameter>result_buf</parameter>の末尾を超えてバッファを書き込むことができます。
さらに、これは廃止されました。
関数呼び出しを定義するためにプリペアドステートメントを設定することによって、同等のパフォーマンスおよびより多くの機能を得られるからです。
関数呼び出しを定義するためにプリペアド文を設定することによって、同等のパフォーマンスおよびより多くの機能を得られるからです。
そして、パラメータおよび結果のバイナリ伝送を伴うステートメントを実行すると、近道関数呼び出しの代わりになります。
</para>
</warning>
Expand Down
Loading
Loading