argra****@users*****
argra****@users*****
2012年 1月 14日 (土) 02:36:28 JST
Index: docs/modules/DBI-1.612/DBI.pod diff -u docs/modules/DBI-1.612/DBI.pod:1.3 docs/modules/DBI-1.612/DBI.pod:1.4 --- docs/modules/DBI-1.612/DBI.pod:1.3 Thu Jan 12 23:16:14 2012 +++ docs/modules/DBI-1.612/DBI.pod Sat Jan 14 02:36:26 2012 @@ -231,10 +231,9 @@ =end original -The significant user-visible changes in each release are documented -in the L<DBI::Changes> module so you can read them by executing -C<perldoc DBI::Changes>. -(TBT) +リリース毎のユーザーに見える重要な変更は L<DBI::Changes> モジュールに +文書化されているので、C<perldoc DBI::Changes> を実行することで +これを読むことができます。 =begin original @@ -260,9 +259,8 @@ =end original -Features added after DBI 1.21 (February 2002) are marked in the -text with the version number of the DBI release they first appeared in. -(TBT) +DBI 1.21 (2002 年 2 月) 以降に追加された機能については、最初に +追加された DBI リリースのバージョン番号を文章中に記しています。 =begin original @@ -274,12 +272,12 @@ =end original -Extensions to the DBI API often use the C<DBIx::*> namespace. -See L</Naming Conventions and Name Space>. DBI extension modules -can be found at L<http://search.cpan.org/search?mode=module&query=DBIx>. -And all modules related to the DBI can be found at -L<http://search.cpan.org/search?query=DBI&mode=all>. -(TBT) +DBI API のエクステンションはしばしば C<DBIx::*> 名前空間が使われます。 +L</Naming Conventions and Name Space> を参照してください。 +DBI エクステンションモジュールは +L<http://search.cpan.org/search?mode=module&query=DBIx> にあります。 +DBI 関連の全てのモジュールは +L<http://search.cpan.org/search?query=DBI&mode=all> にあります。 =cut @@ -1261,8 +1259,7 @@ =end original -B<Performance> -(TBT) +B<性能> =begin original @@ -1471,8 +1468,7 @@ =end original -The parse_dsn() method was added in DBI 1.43. -(TBT) +parse_dsn() メソッドは DBI 1.43 で追加されました。 =head3 C<connect> @@ -1555,8 +1551,7 @@ =end original -Examples of C<$data_source> values are: -(TBT) +C<$data_source> の値の例は: dbi:DriverName:database_name dbi:DriverName:database_name ＠ hostname:port @@ -1627,10 +1622,9 @@ =end original C<DBI_AUTOPROXY> は、通常 "C<dbi:Proxy:hostname=...;port=...>" となります。 -If $ENV{DBI_AUTOPROXY} doesn't begin with 'C<dbi:>' then "dbi:Proxy:" -will be prepended to it first. +$ENV{DBI_AUTOPROXY} が 'C<dbi:>' で始まっていない場合は、先頭に +"dbi:Proxy:" を追加します。 詳細については DBD::Proxyドキュメント をご覧ください。 -(TBT) =begin original @@ -1650,8 +1644,7 @@ しかしながら、これらの環境変数を普段使いすることは、セキュリティ上の理由から お勧めしません。 この機能は基本的にテストを簡単にすることを目的としています。 -See below for alternative way to specify the username and password. -(TBT) +ユーザー名とパスワードを指定するための代替案については後述します。 =begin original @@ -1674,8 +1667,8 @@ そのため C<DBI-E<gt>connect> はドライバインストールの障害のときには die して、接続の障害のときには C<undef> を返すだけです; そのときには C<$DBI::errstr> にエラーの情報が入っています。 -Use C<eval { ... }> if you need to catch the "C<install_driver>" error. -(TBT) +"C<install_driver>" エラーを捕捉する必要がある場合は C<eval { ... }> を +使ってください。 =begin original @@ -2333,8 +2326,8 @@ =end original -Returns an informal description of the string. For example: -(TBT) +文字列に関する略式の記述を返します。 +例えば: UTF8 off, ASCII, 42 characters 42 bytes UTF8 off, non-ASCII, 42 characters 42 bytes @@ -3217,8 +3210,7 @@ =end original -Support for warning and information states was added in DBI 1.41. -(TBT) +警告と情報状態の対応は DBI 1.41 で追加されました。 =head3 C<trace> @@ -3458,8 +3450,7 @@ =end original -For example, the return value when called with a DBD::Sybase $dbh could look like this: -(TBT) +例えば、DBD::Sybase $dbh で呼び出したときの返り値は以下のようになります: { syb_dynamic_supported => undef, @@ -3474,8 +3465,7 @@ =end original -and when called with a DBD::Sybase $sth they could look like this: -(TBT) +そして DBD::Sybase $sth で呼び出したときは以下のようになります: { syb_types => undef, @@ -3489,8 +3479,8 @@ =end original -The values should be undef. Meanings may be assigned to particular values in future. -(TBT) +値は undef であるべきです。 +将来特定の値に関する割り当てが行われます。 =head3 C<swap_inner_handle> @@ -3984,10 +3974,9 @@ =end original -データベースハンドルにとっては、この属性はdisconnectメソッドの明示的な呼び出しを -不可能にしません、破壊(DESTROY)から暗黙の呼び出しだけを不可能にします。 -that happens if the handle is still marked as C<Active>. -(TBT) +データベースハンドルにとっては、この属性は disconnect メソッドの +I<明示的な> 呼び出しを無効にせず、ハンドルに C<Active> とマークされている +ときに DESTROY から暗黙の呼び出しだけを無効にします。 =begin original @@ -4736,10 +4725,9 @@ ほとんどのドライバではここに使われる値が有効なステートメントハンドルによって 使われるメモリに対して直接的な影響を与えることに注意してください。 そのため、あまり気前よくならないようにしてください。 -If you can't be sure what value to use you could -execute an extra select statement to determine the longest value. -For example: -(TBT) +この値の使い方がはっきりとわからないなら、一番長い値を決定するために +追加の select 文を実行できます。 +例えば: $dbh->{LongReadLen} = $dbh->selectrow_array(qq{ SELECT MAX(OCTET_LENGTH(long_column_name)) @@ -5585,8 +5573,7 @@ =end original -The clone method can be used even if the database handle is disconnected. -(TBT) +clone メソッドは例えばデータベースハンドルの接続が切れていても使えます。 =begin original @@ -5939,7 +5926,7 @@ =end original -スカラ・コンテキストでは、selectrow_arrayは最初の行の最初のフィールドを返します。 +スカラコンテキストでは、selectrow_array は最初の行の最初のフィールドを返します。 対応する行がないかエラーが発生したたならば、undefが返されます。 また、スカラコンテキストでは、この C<undef> は最初にフィールドの値が NULL であったために返される C<undef> と区別することができないので、 selectrow_arrayをスカラ・コンテキストで呼び出すときには注意が必要です。 @@ -6124,8 +6111,7 @@ =end original -Or, to fetch into an array instead of an array ref: -(TBT) +または、フェッチ内容を配列リファレンスではなく配列に入れるには: @result = @{ $dbh->selectall_arrayref($sql, { Slice => {} }) }; @@ -6190,8 +6176,7 @@ =end original -If a row has the same key as an earlier row then it replaces the earlier row. -(TBT) +行が以前の行と同じキーの場合、以前の行は置き換えられます。 =begin original @@ -6446,8 +6431,7 @@ =end original -Here are some examples of C<prepare_cached>: -(TBT) +以下は C<prepare_cached> の例です: sub insert_hash { my ($table, $field_values) = @_; @@ -6751,10 +6735,10 @@ Active な文ハンドル(つまり、まだフェッチするデータがある SELECT 文 ハンドル)があるのにデータベースから切断すると警告を受けます。 -The warning may indicate -that a fetch loop terminated early, perhaps due to an uncaught error. -To avoid the warning call the C<finish> method on the active handles. -(TBT) +警告はフェッチループが早く終わってしまったことを示していて、おそらくは +捕捉していないエラーによるものです。 +警告を避けるには、アクティブハンドルに対して C<finish> メソッドを +呼び出します。 =head3 C<ping> @@ -6904,11 +6888,10 @@ 引数 $catalog, $schema, $table はデータベース／ドライバによって検索 パターンを受け取るかもしれません。 -例えば:$table = '%FOO%'; -Remember that the underscore character ('C<_>') is a search pattern -that means match any character, so 'FOO_%' is the same as 'FOO%' -and 'FOO_BAR%' will match names like 'FOO1BAR'. -(TBT) +例えば: $table = '%FOO%'; +下線文字 ('C<_>') は任意の文字を意味する検索パターンを意味するので、 +'FOO_%' は 'FOO%' と同じで、'FOO_BAR%' は 'FOO1BAR' のような名前に +マッチングするということに注意してください。 =begin original @@ -7214,8 +7197,7 @@ =end original -B<COLUMN_NAME>: The column identifier. -(TBT) +B<COLUMN_NAME>: 列識別子。 =begin original @@ -7223,8 +7205,7 @@ =end original -B<DATA_TYPE>: The concise data type code. -(TBT) +B<DATA_TYPE>: 簡潔なデータ型コード。 =begin original @@ -7232,8 +7213,7 @@ =end original -B<TYPE_NAME>: A data source dependent data type name. -(TBT) +B<TYPE_NAME>: データソース依存のデータ型名。 =begin original @@ -7258,8 +7238,7 @@ =end original -B<BUFFER_LENGTH>: The length in bytes of transferred data. -(TBT) +B<BUFFER_LENGTH>: 転送されたデータのバイト数。 =begin original @@ -7306,8 +7285,7 @@ =end original -B<REMARKS>: A description of the column. -(TBT) +B<REMARKS>: 列の説明。 =begin original @@ -7357,8 +7335,7 @@ =end original -B<SQL_DATA_TYPE>: The SQL data type. -(TBT) +B<SQL_DATA_TYPE>: SQL データ型。 =begin original @@ -7366,8 +7343,7 @@ =end original -B<SQL_DATETIME_SUB>: The subtype code for datetime and interval data types. -(TBT) +B<SQL_DATETIME_SUB>: 日付時刻と内部データ型のためのサブ型コード。 =begin original @@ -7386,8 +7362,7 @@ =end original -B<ORDINAL_POSITION>: The column sequence number (starting with 1). -(TBT) +B<ORDINAL_POSITION>: 列シーケンス番号 (1 から開始)。 =begin original @@ -7406,8 +7381,7 @@ =end original -SQL/CLI defines the following additional columns: -(TBT) +SQL/CLI は以下の追加の列を定義しています: CHAR_SET_CAT CHAR_SET_SCHEM @@ -7718,8 +7692,7 @@ =end original -For example: -(TBT) +例えば: $sth = $dbh->foreign_key_info( undef, $user, 'master'); $sth = $dbh->foreign_key_info( undef, undef, undef , undef, $user, 'detail'); @@ -7979,8 +7952,7 @@ =end original -B<Warning:> This method is experimental and may change. -(TBT) +B<警告:> このメソッドは実験的であり変更されるかもしれません。 $sth = $dbh->statistics_info( $catalog, $schema, $table, $unique_only, $quick ); @@ -8003,8 +7975,7 @@ =end original -The arguments don't accept search patterns (unlike L</table_info>). -(TBT) +引数は (L</table_info> と違って) 検索パターンは受け付けません。 =begin original @@ -8103,8 +8074,7 @@ =end original -B<TABLE_NAME>: The table identifier. -(TBT) +B<TABLE_NAME>: テーブル識別子。 =begin original @@ -8144,8 +8114,7 @@ =end original -B<INDEX_NAME>: The index identifier. -(TBT) +B<INDEX_NAME>: インデックス識別子。 =begin original @@ -8179,8 +8148,7 @@ =end original -B<ORDINAL_POSITION>: Column sequence number (starting with 1). -(TBT) +B<ORDINAL_POSITION>: 列シーケンス番号 (1 から開始)。 =begin original @@ -8188,8 +8156,7 @@ =end original -B<COLUMN_NAME>: The column identifier. -(TBT) +B<COLUMN_NAME>: 列識別子。 =begin original @@ -8282,8 +8249,7 @@ =end original -See L</table_info> for a description of the parameters. -(TBT) +パラメータの説明については L</table_info> を参照してください。 =begin original @@ -8891,9 +8857,7 @@ ほとんどのデータベースでは、少なくとも SQL 標準に従っているものなら、 quote は C<'Don"t'> を返します(外側のクォーテーションマークを含みます)。 -For others it -may return something like C<'Don\'t'> -(TBT) +その他の場合は C<'Don\'t'> のようなものを返します。 =begin original @@ -8950,8 +8914,7 @@ =end original -may return something like: -(TBT) +というものは以下のようなものを返します: CONCAT('one', CHAR(12), 'two', CHAR(0), 'three') @@ -9089,8 +9052,7 @@ =end original -Some things to keep in mind... -(TBT) +覚えておくべきことは… =begin original @@ -11271,7 +11233,7 @@ because it now refers to the same memory location as the corresponding column value. これはバインドされた変数を非常に効率よく使います。 -Binding a tied variable doesn't work, currently. +tie された変数へのバインディングは現在のところ動作しません。 (TBT) =begin original @@ -11424,8 +11386,7 @@ =end original -B<Other attributes for Column Binding> -(TBT) +B<列のバインディングのためのその他の属性> =begin original @@ -12009,8 +11970,7 @@ =end original -Returns the parent $dbh of the statement handle. -(TBT) +ステートメントハンドルの親 $dbh を返します。 =head3 C<Statement> (string, read-only) @@ -12122,8 +12082,7 @@ =end original -The C<ParamValues> attribute was added in DBI 1.28. -(TBT) +C<ParamValues> 属性は DBI 1.28 で追加されました。 =head3 C<ParamTypes> (hash ref, read-only) @@ -12198,8 +12157,7 @@ =end original -are returned in the expanded form, as if called like this: -(TBT) +は、以下のように呼び出されたかのように拡張形式で返されます: $sth->bind_param(1, { TYPE => SQL_INTEGER }); @@ -12298,8 +12256,7 @@ =end original -For example: -(TBT) +例えば: $sth = $dbh->prepare("INSERT INTO staff (id, name) values (?,?)"); $sth->execute_array({},[1,2], ['fred','dave']); @@ -13270,8 +13227,7 @@ =end original -Be sure to read all the signal handling sections of the L<perlipc> manual. -(TBT) +L<perlipc> マニュアルのシグナルハンドリングの章を全て読むようにしてください。 =begin original @@ -13387,8 +13343,7 @@ =end original -or specifying a C<RootClass> attribute: -(TBT) +または C<RootClass> 属性を指定して: $dbh = DBI->connect(..., { RootClass => 'MySubDBI' }); @@ -13739,10 +13694,18 @@ 現在のところ DBI は二つのトレースフラグのみを定義しています: +=begin original + ALL - turn on all DBI and driver flags (not recommended) SQL - trace SQL statements executed (not yet implemented in DBI but implemented in some DBDs) +=end original + + ALL - 全ての DBI とドライバのフラグを有効にする (勧めません) + SQL - 実行された SQL 文をトレースする + (まだ DBI には実装されていませんが一部の DBD で実装されています) + =begin original The L</parse_trace_flags> and L</parse_trace_flag> methods are used @@ -13881,8 +13844,7 @@ =end original -B<NOTE>: -(TBT) +B<注意>: =over 4 @@ -13930,8 +13892,7 @@ =end original -A simple example of using PerlIO layers is to use a scalar as the output: -(TBT) +PerlIO 層を使った簡単な例はスカラを出力として使います: my $scalar = ''; open( my $fh, "+>:scalar", \$scalar ); @@ -13943,7 +13904,7 @@ =end original -Now all trace output is simply appended to $scalar. +ここで全てのトレース出力は単純に $scalar に追加されます。 (TBT) =begin original @@ -14101,8 +14062,8 @@ =end original -You can add tracing to your own application code using the L</trace_msg> method. -(TBT) +L</trace_msg> メソッドを使って自身のアプリケーションにトレースを +追加できます。 =begin original @@ -14545,8 +14506,7 @@ =end original -and search for something like C<"SQLColumns returns">. -(TBT) +そして C<"SQLColumns returns"> のような形で検索してください。 =begin original @@ -14647,8 +14607,7 @@ =end original -Details of many other books related to perl can be found at L<http://books.perl.org> -(TBT) +その他の perl に関する多くの本の詳細は L<http://books.perl.org> にあります。 =head2 Perl Modules @@ -14994,8 +14953,7 @@ =end original -A couple of specific DBI features have been sponsored by enlightened companies: -(TBT) +二つの DBI 機能は啓発的な企業によりスポンサーされました: =begin original @@ -15003,8 +14961,8 @@ =end original -The development of the swap_inner_handle() method was sponsored by BizRate.com (L<http://BizRate.com>) -(TBT) +swap_inner_handle() メソッドの開発は BizRate.com +(L<http://BizRate.com>) のスポンサーによるものです。 =begin original @@ -15013,9 +14971,8 @@ =end original -The development of DBD::Gofer and related modules was sponsored by -Shopzilla.com (L<http://Shopzilla.com>), where I currently work. -(TBT) +DBD::Gofer および関連するモジュールの開発は私が現在働いている +Shopzilla.com (L<http://Shopzilla.com>) のスポンサーによるものです。 =head1 CONTRIBUTING @@ -15152,8 +15109,8 @@ =end original -Read the patch file, as a sanity check, and then email it to dbi-d****@perl*****. -(TBT) +サニティチェックとしてパッチファイルを読んでから、dbi-d****@perl***** に +メールを送ってください。 =head2 How to create a patch without Subversion @@ -15165,8 +15122,7 @@ =end original -Unpack a fresh copy of the distribution: -(TBT) +最新版のディストリビューションを展開します: tar xfz DBI-1.40.tar.gz @@ -15176,8 +15132,7 @@ =end original -Rename the newly created top level directory: -(TBT) +新しく作ったトップレベルディレクトリに名前を変えます: mv DBI-1.40 DBI-1.40.your_foo @@ -15187,8 +15142,7 @@ =end original -Edit the contents of DBI-1.40.your_foo/* till it does what you want. -(TBT) +必要なだけ DBI-1.40.your_foo/* の内容を変更します。 =begin original @@ -15196,8 +15150,7 @@ =end original -Test your changes and then remove all temporary files: -(TBT) +変更をテストして、全ての一時ファイルを削除します: make test && make distclean @@ -15207,8 +15160,7 @@ =end original -Go back to the directory you originally unpacked the distribution: -(TBT) +最初にディストリビューションを展開したディレクトリに戻ります: cd .. @@ -15218,8 +15170,7 @@ =end original -Unpack I<another> copy of the original distribution you started with: -(TBT) +元のディストリビューションを I<もう一度> 展開します: tar xfz DBI-1.40.tar.gz @@ -15230,9 +15181,8 @@ =end original -Then create a patch file by performing a recursive C<diff> on the two -top level directories: -(TBT) +二つのトップレベルディレクトリに対して再帰的に C<diff> を実行することで +パッチファイルを作成します: diff -r -u DBI-1.40 DBI-1.40.your_foo > DBI-1.40.your_foo.patch @@ -15307,9 +15257,8 @@ =end original -(If you offer professional DBI related training services, -please send me your details so I can add them here.) -(TBT) +(もしあなたがプロフェッショナルな DBI 関係のトレーニングサービスを +提供しているなら、詳細をメールしてもらえればここに追加します。) =head1 OTHER RELATED WORK AND PERL MODULES
