diff options
Diffstat (limited to 'documentation/manual-pages/ja/man1/join.1')
| -rw-r--r-- | documentation/manual-pages/ja/man1/join.1 | 222 |
1 files changed, 222 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man1/join.1 b/documentation/manual-pages/ja/man1/join.1 new file mode 100644 index 0000000000..0d5f526280 --- /dev/null +++ b/documentation/manual-pages/ja/man1/join.1 @@ -0,0 +1,222 @@ +.\" Copyright (c) 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Institute of Electrical and Electronics Engineers, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)join.1 8.3 (Berkeley) 4/28/95 +.\" %FreeBSD: src/usr.bin/join/join.1,v 1.15 2004/07/05 13:20:03 tjr Exp % +.\" $FreeBSD$ +.\" +.Dd July 5, 2004 +.Dt JOIN 1 +.Os +.Sh 名称 +.Nm join +.Nd リレーショナルデータベースの操作 +.Sh 書式 +.Nm +.Oo +.Fl a Ar file_number | Fl v Ar file_number +.Oc +.Op Fl e Ar string +.Op Fl o Ar list +.Bk -words +.Ek +.Op Fl t Ar char +.Op Fl \&1 Ar field +.Op Fl \&2 Ar field +.Ar file1 +.Ar file2 +.Sh 解説 +.Nm +ユーティリティは、指定されたファイルに対し +.Dq equality join +と呼ばれる、 +各ファイルの同一の部分を結合する操作を施して結果を標準出力に出力します。 +.Pp +比較は、それぞれのファイルの +.Dq join field +と呼ばれるフィールドで +行ないます。デフォルトでは、各行の最初のフィールドが使用されます。 +.Ar file1 +と +.Ar file2 +の中で、 +.Dq join field +が一致した行が組みとなり、1 行で出力されます。 +join field と、 +.Ar file1 +のうちの残りのフィールド、その後、 +.Ar file2 +のうちの残りのフィールドが 1 行になって出力されます。 +.Pp +フィールドの区切は、デフォルトではタブか空白文字です。複数のタブや空白 +が繋っていても、1 つの区切とみなされ、読み込み時にこれらは無視されます。 +出力時の各フィールドの区切は、デフォルトでは空白 1 文字です。 +.Pp +ファイルとフィールドの番号に関し、多くのオプションがあります。これらの +番号は常に、1 から始まります。すなわち、コマンドラインの最初のファイル +はファイル番号 1 番であり、各行の最初のフィールドは、フィールド番号 1 +番となります。 +.Bl -tag -width indent +.It Fl a Ar file_number +デフォルトの出力に加えて、 +.Ar file_number +で指定したファイルに関して、同一フィールドがなかった行を表示します。 +.It Fl e Ar string +出力時に、空のフィールドがあれば +.Ar string +で指定した文字列に置き換えます。 +.It Fl o Ar list +.Nm +の処理して出力すべき行に関し、デフォルトの順序でなく、 +.Ar list +で指定した順序で各ファイルの各フィールドを出力 +するようにします。 +.Ar list +の各要素は、 +.Ql file_number.field +または +.Ql 0 +.Pq ゼロ +で表わし、要素間は、コンマ +.Pq Ql \&, +か空白で区切ります +(空白で区切る場合は、シェルが要素を別々のパラメータに分解しないよう +クォーティングするか、複数の +.Fl o +オプションを使用します)。 +.It Fl t Ar char +入力および出力に使用するフィールドの区切として +.Ar char +で指定した文字を使用するようにします。 +1行の中で出現したすべての +.Ar char +が有効です。 +.It Fl v Ar file_number +.Ar file_number +で指定したファイル番号のファイルに関して、 +join 処理で同一フィールドが見つからなかった行だけを表示する +ようにします。 +.Fl v Ar 1 +と +.Fl v Ar 2 +を同時に指定してもかまいません。 +.It Fl 1 Ar field +ファイル 1 の +.Dq join field +を +.Ar field +で指定した番号のフィールドとします。 +.It Fl 2 Ar field +ファイル 2 の +.Dq join field +を +.Ar field +で指定した番号のフィールドとします。 +.El +.Pp +デフォルトのフィールド区切り文字が使われる場合、 +結合の対象となるファイルは、結合すべきフィールドをキーとして +.Xr sort 1 +に +.Fl b +オプションを付けたものでソートされていなければなりません。 +そうしないと、 +.Nm +はマッチするフィールドを一部しか表示しないことが +あります。 +.Fl t +オプションでフィールド区切り文字が指定されている場合、 +.Fl b +オプション無しの +.Xr sort 1 +でソートされていなければなりません。 +.Pp +.Ar file1 +または +.Ar file2 +のうちの片方が +.Dq - +であった場合には、標準入力が使われます。 +.Sh 診断 +.Ex -std +.Sh 互換性 +さらに、古いバージョンの +.Nm +との互換のため、次のオプションも使用できます。 +.Bl -tag -width indent +.It Fl a +デフォルトの出力に加え、file1 と file2 の各々で、同一フィールド +がない行を表示します。 +.It Fl j1 Ar field +ファイル1の ``join field'' を +.Ar field +で指定した番号のフィールドとします。 +.It Fl j2 Ar field +ファイル2の ``join field'' を +.Ar field +で指定した番号のフィールドとします。 +.It Fl j Ar field +file1 と file2 の ``join field'' を +.Ar field +で指定した番号のフィールドとします。 +.It Fl o Ar list ... +歴史的な +.Nm +の実装では +.Fl o +オプションに複数の引数を許可していました。 +これらの引数は、現在の +.Fl o +オプションで説明したものと同じ +.Dq file_number.field_number +という形式でした。 +しかし、この方法では +.Ql 1.2 +と名付けられたファイルが存在すると、明らかに困難を生じます。 +.El +.Pp +これらのオプションは、修正をしたくないような非常に古いシェルスクリプト +のためだけに用意されています。 +これらのオプションは、使うべきではありません。 +.Sh 規格 +.Nm +コマンドは +.St -p1003.1-2001 +互換です。 +.Sh 関連項目 +.Xr awk 1 , +.Xr comm 1 , +.Xr paste 1 , +.Xr sort 1 , +.Xr uniq 1 |