CUBRID 関数 (PDO

導入

PDO_CUBRID は PHP Data Objects (PDO) インターフェイスを実装したドライバで、PHP から CUBRID データベースにアクセスするためのものです。

注意:
現在のバージョンの PDO_CUBRID は、持続的接続に対応していません。

インストール手順

PDO_CUBRID 拡張モジュールをビルドするには、PHP を動かしているシステム上に CUBRID DBMS をインストールしなければなりません。 PDO_CUBRID は » PECL 拡張モジュールなので、 PECL 拡張モジュールのインストールの手順に従えば PDO_CUBRID をインストールできます。configure コマンドを実行するときに、次のようにして CUBRID のベースディレクトリの場所を指定します。

   $ ./configure --with-pdo-cubrid=/path/to/CUBRID[,shared]

configure コマンドはデフォルトで、環境変数 CUBRID の値を使います。

この PECL 拡張モジュールの DLL は、現在存在しません。 Windows でのビルドも参照ください Linux や Windows への手動でのインストールに関する詳細な情報は、 PECL の CUBRID パッケージに含まれる build-guide.html を参照ください。

機能

**PDO_CUBRID の機能**
機能	説明
スクロール可能なカーソル	PDO_CUBRID はスクロール可能なカーソルをサポートしており、デフォルトの型は前進のみのカーソルです。 PDO::prepare() を使えばカーソルの型を変えることができます。
タイムアウト	PDO_CUBRID は sql ステートメントの実行時のタイムアウトの設定をサポートしています。 PDO::setAttribute() を使えばタイムアウトの値を設定できます。
Autocommit_mode およびトランザクション	PDO_CUBRID は自動コミットとトランザクションをサポートしており、自動コミットモードがデフォルトで有効になっています。 PDO::setAttribute() を使えば状態を変更することができます。 PDO::beginTransaction() でトランザクションを開始すると autocommit_mode は自動的に無効となり、PDO::commit() あるいは PDO::rollBack() の後で元の状態に戻します。autocommit_mode を無効にする前に、それまでの作業は自動的にコミットされることに注意しましょう。
複数の SQL 文	PDO_CUBRID は複数の SQL 文をサポートしています。複数の SQL 文はセミコロン (;) で区切られます。
スキーマ情報	PDO_CUBRID では PDO::cubrid_schema() 関数を用意しており、これでスキーマ情報を取得します。
LOBs	PDO_CUBRID は BLOB/CLOB データ型をサポートしています。PDO における LOB はストリームで表現されているので、LOB を追加するにはストリームをバインドし、 LOB を取得するには CUBRID PDO が返すストリームを読み込みます。例1 CUBRID PDO での LOB の追加 `<?php $fp = fopen('lob_test.png', 'rb'); $sql_stmt = "INSERT INTO lob_test(name, content) VALUES('lob_test.png', ?)"; $stmt = $dbh->prepare($sql_stmt); $ret = $stmt->bindParam(1, $fp, PDO::PARAM_LOB); $ret = $stmt->execute(); ?>` 例2 CUBRID PDO での LOB の取得 `<?php $sql_stmt = "SELECT content FROM lob_test WHERE name='lob_test.png'"; $stmt = $dbh->prepare($sql_stmt); $stmt->execute(); $result = $stmt->fetch(PDO::FETCH_NUM); header("Content-Type: image/png"); fpassthru($result[0]); ?>`
カラムのメタ情報	CUBRID PDO における PDOStatement::getColumnMeta() は、次の値を含む連想配列を返します。 type name table def precision scale not_null auto_increment unique_key multiple_key primary_key foreign_key reverse_index reverse_unique
コレクションデータ型	PDO_CUBRID は SET/MULTISET/SEQUENCE といったコレクションに対応しています。データ型を省略した場合のデフォルトは char で、次の例のようになります。例3 CUBRID PDO で、デフォルトのデータ型のセットを追加する例 `<?php $conn_str ="cubrid:dbname=demodb;host=localhost;port=33000"; $cubrid_pdo = new PDO($conn_str, 'dba', ''); $cubrid_pdo->exec("DROP TABLE if exists test_tbl"); $cubrid_pdo->exec("CREATE TABLE test_tbl (col_1 SET(VARCHAR))"); $sql_stmt_insert = "INSERT INTO test_tbl VALUES (?);"; $stmt = $cubrid_pdo->prepare($sql_stmt_insert); $data = array("abc","def","ghi"); $ret = $stmt->bindParam(1, $data, PDO::PARAM_NULL); $ret = $stmt->execute(); var_Dump($ret); ?>` 例4 CUBRID PDO でのセットの追加でデータ型を指定する例 `<?php $conn_str ="cubrid:dbname=demodb;host=localhost;port=33000"; $cubrid_pdo = new PDO($conn_str, 'dba', ''); $cubrid_pdo->exec("DROP TABLE if exists test_tbl"); $cubrid_pdo->exec("CREATE TABLE test_tbl (col_1 SET(int))"); $sql_stmt_insert = "INSERT INTO test_tbl VALUES (?);"; $stmt = $cubrid_pdo->prepare($sql_stmt_insert); $data = array(1,2,3,4); $ret = $stmt->bindParam(1, $data, 0,0,"int"); $ret = $stmt->execute(); var_Dump($ret); ?>` CUBRID のバインドデータ型 (PDOStatement::bindParam の五番目のパラメータ) CHAR STRING NCHAR VARNCHAR BIT VARBIT NUMERIC NUMBER INT SHORT BIGINT MONETARY FLOAT DOUBLE DATE TIME DATETIME TIMESTAMP

定義済み定数

このドライバでは以下の定数が定義されています。これは拡張モジュールが PHP に組み込まれているか、実行時に動的にロードされている場合のみ使用可能です。さらに、これらのドライバ固有の定数はそのドライバを使用している場合にのみ使用されます。あるドライバ固有の属性を別のドライバで使うと、予期せぬ結果を引き起こします。もし複数のドライバを使用しているコードを実行している場合、 PDO::getAttribute() で PDO_ATTR_DRIVER_NAME 属性を使用することで、使用中のドライバ名を調べることが可能です。

これらの定数を使ってデータベースの属性を設定します。これらの定数は PDO::getAttribute() あるいは PDO::setAttribute() に渡します。

**PDO::CUBRID 属性フラグ**
定数	説明
PDO::CUBRID_ATTR_ISOLATION_LEVEL	データベース接続に指定するトランザクション分離レベル。
PDO::CUBRID_ATTR_LOCK_TIMEOUT	トランザクションのタイムアウト秒数。
PDO::CUBRID_ATTR_MAX_STRING_LENGTH	読み込み専用。CUBRID PDO API を使うときの bit, varbit, char, varchar, nchar, nchar varying データ型の最大文字数。

これらの定数を使ってトランザクション分離レベルを設定します。これらの定数は PDO::getAttribute() に渡したり PDO::setAttribute() から返されたりします。

**PDO::CUBRID 分離レベルフラグ**
定数	説明
PDO::TRAN_COMMIT_CLASS_UNCOMMIT_INSTANCE	最も低い分離レベル (1)。タプルについてダーティリード、ノンリピータブルリード、ファントムリードが発生し、テーブルについてもノンリピータブルリードが発生します。
PDO::TRAN_COMMIT_CLASS_COMMIT_INSTANCE	比較的低い分離レベル (2)。ダーティリードは発生しませんが、ノンリピータブルリードやファントムリードは発生します。
PDO::TRAN_REP_CLASS_UNCOMMIT_INSTANCE	CUBRID のデフォルトの分離レベル (3)。タプルについてはダーティリード、ノンリピータブルリード、ファントムリードが発生しますが、テーブルについてはリピータブルリードが保証されています。
PDO::TRAN_REP_CLASS_COMMIT_INSTANCE	比較的低い分離レベル (4)。ダーティリードは発生しませんが、ノンリピータブルリードやファントムリードは発生します。
PDO::TRAN_REP_CLASS_REP_INSTANCE	比較的高い分離レベル (5)。ダーティリードやノンリピータブルリードは発生しませんが、ファントムリードは発生します。
PDO::TRAN_SERIALIZABLE	最も高い分離レベル (6)。並行性に関する問題 (ダーティリード、ノンリピータブルリード、ファントムリードなど) は発生しません。

これらの定数を使ってスキーマ情報を取得します。これらの定数は PDO::cubrid_schema() に渡します。

**PDO::CUBRID スキーマフラグ**
定数	説明
PDO::CUBRID_SCH_TABLE	CUBRID のテーブルの名前と型を取得します。
PDO::CUBRID_SCH_VIEW	CUBRID のビューの名前と型を取得します。
PDO::CUBRID_SCH_QUERY_SPEC	ビューのクエリ定義を取得します。
PDO::CUBRID_SCH_ATTRIBUTE	テーブルのカラムの属性を取得します。
PDO::CUBRID_SCH_TABLE_ATTRIBUTE	テーブルの属性を取得します。
PDO::CUBRID_SCH_METHOD	インスタンスメソッドを取得します。インスタンスメソッドはクラスのインスタンスからコールされるメソッドです。たいていの操作はインスタンス上で行われるので、クラスメソッドよりも頻繁に使います。
PDO::CUBRID_SCH_TABLE_METHOD	クラスメソッドを取得します。クラスメソッドはクラスオブジェクトからコールされるメソッドです。新しいクラスのインスタンスを作ったり初期化したりするときによく使います。また、クラスの属性にアクセスしたりそれを更新したりするときにも使います。
PDO::CUBRID_SCH_METHOD_FILE	テーブルのメソッドが定義されているファイルの情報を取得します。
PDO::CUBRID_SCH_SUPER_TABLE	このテーブルの属性の継承元のテーブルの名前と型を取得します。
PDO::CUBRID_SCH_SUB_TABLE	このテーブルの属性を継承しているテーブルの名前と型を取得します。
PDO::CUBRID_SCH_CONSTRAINT	亭ブルの制約を取得します。
PDO::CUBRID_SCH_TRIGGER	テーブルのトリガーを取得します。
PDO::CUBRID_SCH_TABLE_PRIVILEGE	テーブルの権限情報を取得します。
PDO::CUBRID_SCH_COL_PRIVILEGE	カラムの権限情報を取得します。
PDO::CUBRID_SCH_DIRECT_SUPER_TABLE	直接の親テーブルを取得します。
PDO::CUBRID_SCH_PRIMARY_KEY	テーブルの主キーを取得します。
PDO::CUBRID_SCH_IMPORTED_KEYS	テーブルのインポートしたキーを取得します。
PDO::CUBRID_SCH_EXPORTED_KEYS	テーブルのエクスポートしたキーを取得します。
PDO::CUBRID_SCH_CROSS_REFERENCE	ふたつのテーブルの参照関係を取得します。

CUBRID 関数 (PDO_CUBRID)

導入

インストール手順

機能

定義済み定数

目次