 |
| レンタルサーバーのご案内 |
| サブドメイン型のご案内 |
| レンタルサーバーの機能一覧 |
| ドメイン取得のご案内 |
| Whois保護のご案内 |
| サービス購入手続のご案内 |
| サービスの料金一覧 |
 |
| ホスウィートタウンについて |
| ドメインについて |
| レンタルサーバーについて |
| 料金手続について |
 |
 |
マニュアル |
https://+上記サイトは、
企業証明および128bitSSL
暗号化により安全に通信が
できます。
XXIII. DB++ 関数
| 警告 |
|
この拡張モジュールは、 実験的 なものです。この拡張モジュールの動作・ 関数名・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 このモジュールは自己責任で使用してください。 |
導入
db++ は、ドイツの企業 Concept asa により作成された高性能でかつメモリ使用量とディスク使用量が 小さいことを特徴とするリレーショナルデータベースシステムです。 db++ では、SQL は補助的なインターフェイス原語として提供されており、 元来の SQL データベースであるわけではありませんが、SQL よりも 関係代数にはるかに強く影響された固有の AQL クエリ言語が提供されています。
Concept asa は、常にオープンソース言語のサポートに関心を持って 来ており、db++ は Perl、Tcl コールのインターフェイスを何年も前から有し、 Tcl を内部的なストアドプロシージャ言語として使用しています。
要件
この拡張モジュールは外部クライアントライブラリに依存しており、 この拡張モジュールを使用したいシステム上に db++ クライアントが インストールされている必要があります。
Concept asa が、 Linux および他のいくつかの Unix 版の db++ デモ版 および ドキュメント を 提供しています。また、Windows 版の db++ もありますが、 この拡張モジュールでは(まだ)サポートしていません。
インストール手順
この拡張モジュールをビルドするためには、db++ クライアントライブラリおよび
ヘッダファイルがシステムにインストールされていることが必要です (db++
のインストールアーカイブには、これらがデフォルトで含まれています)。
この拡張モジュールをビルドするためには、configure
の際にオプション --with-dbplus
を設定する必要があります。
configure
は、クライアントライブラリおよびヘッダファイルを デフォルトのパス /usr/dbplus、 /usr/local/dbplus および /opt/dblus から探します。もし db++
を別の場所にインストールしている場合、 以下のようにしてインストール場所を configure オプションに 指定する必要があります。
--with-dbplus=/your/installation/path
実行時設定
設定ディレクティブは定義されていません。
リソース型
dbplus_relation
多くの db++ 関数は、dbplus_relation リソースを 操作または返します。
dbplus_relation
は、保存された関係または クエリの結果として生成された関係へのハンドルです。
定義済み定数
以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。
db++ エラーコード
表 1. DB++ エラーコード
| PHP 定数 | db++ 定数 | 意味 |
|---|---|---|
| DBPLUS_ERR_NOERR (integer) | ERR_NOERR | Null エラー条件 |
| DBPLUS_ERR_DUPLICATE (integer) | ERR_DUPLICATE | 重複するタプルを挿入した |
| DBPLUS_ERR_EOSCAN (integer) | ERR_EOSCAN | rget()からスキャン終了 |
| DBPLUS_ERR_EMPTY (integer) | ERR_EMPTY | 関係が空(サーバ) |
| DBPLUS_ERR_CLOSE (integer) | ERR_CLOSE | サーバをクローズできない |
| DBPLUS_ERR_WLOCKED (integer) | ERR_WLOCKED | レコードは書き込みロックされている |
| DBPLUS_ERR_LOCKED (integer) | ERR_LOCKED | 関係は既にロックされている |
| DBPLUS_ERR_NOLOCK (integer) | ERR_NOLOCK | 関係をロックできない |
| DBPLUS_ERR_READ (integer) | ERR_READ | 関係の読み込みエラー |
| DBPLUS_ERR_WRITE (integer) | ERR_WRITE | 関係の書き込みエラー |
| DBPLUS_ERR_CREATE (integer) | ERR_CREATE | create() システムコールが失敗 |
| DBPLUS_ERR_LSEEK (integer) | ERR_LSEEK | lseek() システムコールが失敗 |
| DBPLUS_ERR_LENGTH (integer) | ERR_LENGTH | 最大長を越えるタプル |
| DBPLUS_ERR_OPEN (integer) | ERR_OPEN | open() システムコールが失敗 |
| DBPLUS_ERR_WOPEN (integer) | ERR_WOPEN | 関係は既に書き込みオープンされている |
| DBPLUS_ERR_MAGIC (integer) | ERR_MAGIC | ファイルは関係でない |
| DBPLUS_ERR_VERSION (integer) | ERR_VERSION | ファイルは非常に古い関係である |
| DBPLUS_ERR_PGSIZE (integer) | ERR_PGSIZE | 関係は異なったページサイズを使用している |
| DBPLUS_ERR_CRC (integer) | ERR_CRC | 不正な CRC がスーパーページにある |
| DBPLUS_ERR_PIPE (integer) | ERR_PIPE | パイプ上の関係は lseek() を要求している |
| DBPLUS_ERR_NIDX (integer) | ERR_NIDX | セカンダリインデックスが多すぎる |
| DBPLUS_ERR_MALLOC (integer) | ERR_MALLOC | malloc() コールが失敗した |
| DBPLUS_ERR_NUSERS (integer) | ERR_NUSERS | 最大ユーザ数エラー |
| DBPLUS_ERR_PREEXIT (integer) | ERR_PREEXIT | 無効な使用法により発生 |
| DBPLUS_ERR_ONTRAP (integer) | ERR_ONTRAP | シグナルにより発生 |
| DBPLUS_ERR_PREPROC (integer) | ERR_PREPROC | プリプロセッサにおけるエラー |
| DBPLUS_ERR_DBPARSE (integer) | ERR_DBPARSE | パーサ上のエラー |
| DBPLUS_ERR_DBRUNERR (integer) | ERR_DBRUNERR | dbにおける実行エラー |
| DBPLUS_ERR_DBPREEXIT (integer) | ERR_DBPREEXIT | prexit() * プロシージャにより発生した終了条件 |
| DBPLUS_ERR_WAIT (integer) | ERR_WAIT | 少し待つ(simple のみ) |
| DBPLUS_ERR_CORRUPT_TUPLE (integer) | ERR_CORRUPT_TUPLE | クライアントが壊れたタプルを送信した |
| DBPLUS_ERR_WARNING0 (integer) | ERR_WARNING0 | simple ルーチンが、修正済みの致命的でないエラーを発見した |
| DBPLUS_ERR_PANIC (integer) | ERR_PANIC | サーバは実際に実行中断していないが、全てのクライアントに ERR_PANIC が送信された |
| DBPLUS_ERR_FIFO (integer) | ERR_FIFO | fifo を作成できない |
| DBPLUS_ERR_PERM (integer) | ERR_PERM | 不許可 |
| DBPLUS_ERR_TCL (integer) | ERR_TCL | TCL_error |
| DBPLUS_ERR_RESTRICTED (integer) | ERR_RESTRICTED | ユーザ二人のみ |
| DBPLUS_ERR_USER (integer) | ERR_USER | アプリケーションプログラマによるライブラリの使用エラー |
| DBPLUS_ERR_UNKNOWN (integer) | ERR_UNKNOWN |
- 目次
- dbplus_add -- リレーションにタプルを追加する
- dbplus_aql -- AQL クエリを実行する
- dbplus_chdir -- データベース仮想カレントディレクトリを設定/取得する
- dbplus_close -- リレーションを閉じる
- dbplus_curr -- リレーションからカレントタプルを取得する
- dbplus_errcode -- 指定したエラーコードまたは直近のエラーに関するエラー文字列を取得する
- dbplus_errno -- 直近の操作に関するエラーコードを取得する
- dbplus_find -- リレーションに拘束を設定する
- dbplus_first -- リレーションから最初のタプルを取得する
- dbplus_flush -- リレーションに行った全ての変更をフラッシュする
- dbplus_freealllocks -- このクライアントにより保持された全てのロックを解放する
- dbplus_freelock -- タプルの書き込みロックを解放する
- dbplus_freerlocks -- 指定したリレーションに関する全てのタプルロックを解放する
- dbplus_getlock -- タプルの書き込みロックを取得する
- dbplus_getunique -- あるリレーションのユニークな ID 番号を取得する
- dbplus_info -- リレーションについての情報を取得する
- dbplus_last -- リレーションから直近のタプルを取得する
- dbplus_lockrel -- リレーションに書き込みロックを要求する
- dbplus_next -- リレーションから次のタプルを取得する
- dbplus_open -- リレーションファイルをオープンする
- dbplus_prev -- リレーションから前のタプルを取得する
- dbplus_rchperm -- リレーションの許可属性を変更する
- dbplus_rcreate -- 新しい DB++ リレーションを作成する
- dbplus_rcrtexact -- インデックスを含む、リレーションの空のコピーを作成する
- dbplus_rcrtlike -- デフォルトのインデックスで、リレーションの空のコピーを作成する
- dbplus_resolve -- リレーションのホスト情報を取得する
- dbplus_restorepos -- 位置を復元する
- dbplus_rkeys -- リレーションの主キーを新規に指定する
- dbplus_ropen -- リレーションファイルをローカルにオープンする
- dbplus_rquery -- ローカル (raw) AQL クエリを実行する
- dbplus_rrename -- リレーションの名前を変更する
- dbplus_rsecindex -- リレーションに新規セカンダリインデックスを作成する
- dbplus_runlink -- ファイルシステムからリレーションを削除する
- dbplus_rzap -- リレーションから全てのタプルを削除する
- dbplus_savepos -- 位置を保存する
- dbplus_setindex -- インデックスを設定する
- dbplus_setindexbynumber -- インデックスを数字で設定する
- dbplus_sql -- SQL クエリを実行する
- dbplus_tcl -- サーバ側で TCL コードを実行する
- dbplus_tremove -- タプルを削除し、新規カレントタプルを返す
- dbplus_undo -- 元に戻す
- dbplus_undoprepare -- 元に戻す準備をする
- dbplus_unlockrel -- リレーションの書き込みロックを中断する
- dbplus_unselect -- リレーションから制約を削除する
- dbplus_update -- リレーション内の指定したタプルを更新する
- dbplus_xlockrel -- リレーションの排他的ロックを要求する
- dbplus_xunlockrel -- リレーションの排他的ロックを解放する