pgpool2.git / summary / log / commit / refs
commit 3691d809743bf7e6e2001b591698154044f016cf
Author: Tatsuo Ishii <ishii@postgresql.org>
Date: Wed Oct 19 08:49:05 2016 +0000
Translate intro.sgml into Japanese.
Fix typo in English intro.sgml.
doc.ja/src/sgml/intro.sgml | 82 +++++++++++++++++++++++++++++++++++++++---
doc.ja/src/sgml/stylesheet.xsl | 3 ++
doc/src/sgml/intro.sgml | 4 +--
3 files changed, 82 insertions(+), 7 deletions(-)
diff --git a/doc.ja/src/sgml/intro.sgml b/doc.ja/src/sgml/intro.sgml
index c071cd503..5a0f8cb4f 100644
--- a/doc.ja/src/sgml/intro.sgml
+++ b/doc.ja/src/sgml/intro.sgml
@@ -22,47 +22,68 @@
</para>
<para>
+<!--
To make the large amount of information about
<productname>Pgpool-II</productname> manageable, this book has been
organized in several parts. Each part is targeted at a different
class of users, or at users in different stages of their
<productname>Pgpool-II</productname> experience:
+-->
+<productname>Pgpool-II</productname>に関する膨大な情報を管理しやすくするために、本書はいくつかの部分に分かれています。
+それぞれの部分のユーザの層の違い、あるいは<productname>Pgpool-II</productname>の経験の違いに合せて構成されてます。
<itemizedlist>
<listitem>
<para>
+<!--
<xref linkend="tutorial"> is an informal introduction for new users.
+-->
+<xref linkend="tutorial">は入門者のための導入情報です。
</para>
</listitem>
<listitem>
<para>
+<!--
<xref linkend="admin"> describes the installation and
administration of the server. Everyone who runs a
- <productname>PostgreSQL</productname> server, be it for private
+ <productname>Pgpool-II</productname> server, be it for private
use or for others, should read this part.
+-->
+<xref linkend="admin">では、サーバのインストールと管理について記述しています。
+個人目的であれ、他の人のために動かすのであれ、<productname>Pgpool-II</productname>サーバを動かす人はこの章を読んでください。
</para>
</listitem>
<listitem>
<para>
+<!--
<xref linkend="examples"> explains several configuration examples
so that users can choose the starting point of their actual systems.
+-->
+<xref linkend="examples">では、実際のシステムで使う際のスタートポイントとしてユーザが選択できるように。何種類かの構成例を説明しています。
</para>
</listitem>
<listitem>
<para>
+<!--
<xref linkend="reference"> contains reference information about
SQL commands, client and server programs. This part supports
the other parts with structured information sorted by command or
program.
+-->
+<xref linkend="reference">には、SQLコマンド、クライアント、サーバプログラムが含まれます。
+コマンドあるいはプログラムでソートされた構造的な情報となっており、本書の他の部分をサポートするように考慮されています。
</para>
</listitem>
<listitem>
<para>
+<!--
<xref linkend="appendixes"> is an appendix information such as release notes.
+-->
+<xref linkend="appendixes">はリリースノートのような追加情報です。
</para>
</listitem>
@@ -79,34 +100,52 @@
</para>
<sect1 id="intro-whatis">
+<!--
<title> What is <productname>Pgpool-II</productname>?</title>
+-->
+ <title><productname>Pgpool-II</productname>とは？</title>
<para>
+<!--
<productname>Pgpool-II</productname> is a proxy software that sits
between <productname>PostgreSQL</productname> servers and a
<productname>PostgreSQL</productname> database client. It provides
the following features:
+-->
+<productname>Pgpool-II</productname>は、<productname>PostgreSQL</productname>サーバと<productname>PostgreSQL</productname>データベースクライアントの間に位置するプロキシソフトウェアです。
+以下のような機能を提供します。
<variablelist>
<varlistentry>
+<!--
<term>Connection Pooling</term>
+-->
+ <term>コネクションプーリング</term>
<listitem>
<para>
+<!--
<productname>Pgpool-II</productname> maintains established
connections to the <productname>PostgreSQL</productname>
servers, and reuses them whenever a new connection with the
same properties (i.e. user name, database, protocol version)
comes in. It reduces the connection overhead, and improves
system's overall throughput.
+-->
+<productname>Pgpool-II</productname>は、<productname>PostgreSQL</productname>サーバへの確立された接続を維持し、プロパティ（つまりユーザ名、データベース、プロトコルバージョン）が同じ新規のコネクションが到着する度に再利用します。
+コネクションオーバヘッドを軽減することによって、システム全体のスループットを改善します。
</para>
</listitem>
</varlistentry>
<varlistentry>
+<!--
<term>Load Balancing</term>
+-->
+ <term>負荷分散</term>
<listitem>
<para>
+<!--
If a database is replicated (because running in either
replication mode or master/slave mode), performing a SELECT
query on any server will return the same result. <productname>Pgpool-II</productname>
@@ -118,26 +157,37 @@
PostgreSQL servers. Load balancing works best in a scenario
where there are a lot of users executing many read-only
queries at the same time.
+-->
+（レプリケーションモードあるいはマスタースレーブモードで動作しているので）データベースがレプリケーションされている場合は、どのサーバにSELECTを発行しても同じ結果が得られます。
+<productname>Pgpool-II</productname>は、個々のPostgreSQLサーバの負荷を軽減するために、レプリケーションを利用します。
+SELECTクエリをサーバに分散させ、システム全体のスループットを改善します。
+理想的には、PostgreSQLサーバの数に比例して検索性能が向上します。
+多数のユーザが検索のみのクエリを同時に発行するようなシナリオで、負荷分散は最大の効果を発揮します。
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Automated fail over</term>
+ <term>自動フェイルオーバ</term>
<listitem>
<para>
+<!--
If one of database servers goes down or becomes unrechable,
<productname>Pgpool-II</productname> will detaches it and continues operations using rest
of database servers. There are some sophiscated features which
- help the automated fail over including timeout and retres.
+ help the automated fail over including timeout and retries.
+-->
+データベースサーバのどれかがダウンしたり、到達できなくなったときは、<productname>Pgpool-II</productname>はそのサーバを切り離し、残ったサーバで運用を継続します。
+自動フェイルオーバの助けになるような、タイムアウト、リトライといった洗練された機能もあります。
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Replication</term>
+ <term>レプリケーション</term>
<listitem>
<para>
+<!--
<productname>Pgpool-II</productname> can manage
multiple <productname>PostgreSQL</productname>
servers. Activating the replication feature makes it possible
@@ -148,14 +198,21 @@
built-in replication (native replication). However user can
use external replication features including streaming
replication of <productname>PostgreSQL</productname>.
+-->
+<productname>Pgpool-II</productname>は複数の<productname>PostgreSQL</productname>サーバを管理することができます。
+レプリケーション機能を有効にすることにより、2つあるいはそれ以上の<productname>PostgreSQL</productname>クラスタのリアルタイムバックアップを作成できます。
+これによって、クラスタの一つがダウンしても、中断なしにサービスを継続できます。
+<productname>Pgpool-II</productname>には、組み込みレプリケーション（ネィティブレプリケーション）機能があります。
+しかし、<productname>PostgreSQL</productname>のストリーミングレプリケーションのような、外部のレプリケーション機能を使うこともできます。
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Limiting Exceeding Connections</term>
+ <term>限度を超えた接続の制限</term>
<listitem>
<para>
+<!--
There is a limit on the maximum number of concurrent
connections with <productname>PostgreSQL</productname>, and
new connections are rejected when this number is
@@ -166,6 +223,11 @@
limit on the maximum number of connections, but extra
connections will be queued instead of returning an error
immediately.
+-->
+<productname>PostgreSQL</productname>への最大同時接続数には制限があり、その制限に達すると新しいコネクションは拒否されます。
+最大接続数を大きくすると、リソースの消費が増え、システム全体の性能に悪影響があります。
+<productname>Pgpool-II</productname>にも最大接続数の制限があります。
+しかし、制限を超えた接続要求はすぐにエラーが返るのではなく、待ち行列に入ります。
</para>
</listitem>
</varlistentry>
@@ -175,6 +237,7 @@
</para>
<para>
+<!--
<productname>Pgpool-II</productname> speaks PostgreSQL's backend
and frontend protocol, and relays messages between a backend and a
frontend. Therefore, a database application (frontend) thinks
@@ -185,11 +248,20 @@
<productname>Pgpool-II</productname> is transparent to both the server and the client, an
existing database application can be used with <productname>Pgpool-II</productname> almost
without a change to its source code.
+-->
+<productname>Pgpool-II</productname>は、PostgreSQLのバックエンドフロントエンドプロトコルを理解し、バックエンドとフロントエンドの間でメッセージを転送します。
+つまり、データベースアプリケーション（フロントエンド）には<productname>Pgpool-II</productname>が実際の<productname>PostgreSQL</productname>サーバであるように見えます。
+サーバ（バックエンド）には、<productname>Pgpool-II</productname>がフロントエンドであるように見えます。
+<productname>Pgpool-II</productname>は、サーバとクライアントに対して透過なので、既存のデータベースアプリケーションは、ソースコードに変更を加えることなく<productname>Pgpool-II</productname>を利用できます。
</para>
<para>
+<!--
There are some restrictions to using SQL via <productname>Pgpool-II</productname>.
See <link linkend="restrictions">Restrictions</link> for more details.
+-->
+<productname>Pgpool-II</productname>でSQLを使うにあたっては、制限事項があります。
+詳細は<link linkend="restrictions">制限事項</link>をご覧ください。
</para>
</sect1>
diff --git a/doc.ja/src/sgml/stylesheet.xsl b/doc.ja/src/sgml/stylesheet.xsl
index 7967b361d..faa7d2457 100644
--- a/doc.ja/src/sgml/stylesheet.xsl
+++ b/doc.ja/src/sgml/stylesheet.xsl
@@ -16,8 +16,10 @@
<xsl:param name="generate.legalnotice.link" select="1"></xsl:param>
<xsl:param name="link.mailto.url">pgsql-docs@postgresql.org</xsl:param>
<xsl:param name="chunk.first.sections" select="1"/>
+<!-- <xsl:param name="chunker.output.indent" select="'yes'"/> -->
<xsl:param name="chunk.quietly" select="1"></xsl:param>
<xsl:param name="toc.max.depth">2</xsl:param>
+<xsl:param name="generate.section.toc.level">1</xsl:param>
<xsl:param name="website.stylesheet" select="0"/>
@@ -35,6 +37,7 @@
<xsl:call-template name="inline.monoseq"/>
</xsl:template>
+<xsl:include href="stylesheet-custom.xsl" />
<!-- table of contents configuration -->
diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml
index 63286fec2..f103df841 100644
--- a/doc/src/sgml/intro.sgml
+++ b/doc/src/sgml/intro.sgml
@@ -31,7 +31,7 @@
<para>
<xref linkend="admin"> describes the installation and
administration of the server. Everyone who runs a
- <productname>PostgreSQL</productname> server, be it for private
+ <productname>Pgpool-II</productname> server, be it for private
use or for others, should read this part.
</para>
</listitem>
@@ -121,7 +121,7 @@
If one of database servers goes down or becomes unrechable,
<productname>Pgpool-II</productname> will detaches it and continues operations using rest
of database servers. There are some sophiscated features which
- help the automated fail over including timeout and retres.
+ help the automated fail over including timeout and retries.
</para>
</listitem>
</varlistentry>
[parent: 690bebcb506a]