B OCIデモ・プログラム

OCIハンドルの割当ておよび使用方法を説明するサンプル・コード付きのサンプル・プログラムを示します。

OCIコールの使用方法を示すコード例を提供しています。これらのプログラムはあくまでも例であり、すべてのオペレーティング・システムで実行できるとはかぎりません。

『Oracle Database Examplesインストレーション・ガイド』の説明に従って、デモ・プログラムをイインストールする必要があります。デモ・プログラムの位置、名前および可用性は、オペレーティング・システムによって異なります。LinuxまたはUNIXワークステーションでは、デモ・プログラムは$ORACLE_HOME/rdbms/demoディレクトリにインストールされています。Windowsシステムの場合は、「OCI for Windowsスタート・ガイド」を参照してください。

LinuxまたはUNIXプラットフォームでOCIクライアント・アプリケーションの開発に必要なOCIヘッダー・ファイルは、$ORACLE_HOME/rdbms/publicディレクトリにインストールされています。demo_rdbms.mkファイルは$ORACLE_HOME/rdbms/demoディレクトリ内にあるサンプルMakefileです。Windowsシステムでの類似ファイルは、samplesディレクトリ内のmake.batです。Makefile内に指示があります。

demo_rdbms.mkファイルを大幅に変更しないかぎり、demo_rdbms.mkファイルが$ORACLE_HOME/rdbms/publicディレクトリを含む場合に行われた変更によって影響を受けることはありません。高度にカスタマイズしたMakefileが、INCLUDEパスの$ORACLE_HOME/rdbms/publicディレクトリにあることを確認してください。

OCIアプリケーションまたは外部プロシージャを構築するための新しいmakefilesを開発するには、独自のマクロをリンク行に追加して、指定したmakefileをカスタマイズします。ただし、独自のmakefilesのメンテナンスを簡単にするために、指定したマクロをデモmakefile内に保持しておく必要があります。

特定のヘッダー・ファイルまたはSQLファイルがアプリケーションで必要になった場合には、デモ・プログラム・ファイルでの指定に従って、それらのファイルも用意されています。設定やプログラム実行のヒントは、デモ・プログラムの最初に記載されたコメントの情報を参照してください。

表B-1に、重要なデモ・プログラムおよびそのプログラムで示されるOCI機能を示します。拡張子.sqlが付いた関連ファイルを検索してください。

表B-1 OCIデモ・プログラム

プログラム名	示される機能
`cdemo81.c`	リリース8の機能を使用した基本SQL処理の使用
`cdemo82.c`	ユーザー定義オブジェクトの基本処理の実行
`cdemocor.c`	複合オブジェクト検索(COR)を使用したパフォーマンス向上
`cdemodr1.c cdemodr2.c cdemodr3.c`	基本データ型のLOBおよび`REF`で使用される`RETURNING`句を伴う`INSERT`、`UPDATE`および`DELETE`文の使用
`cdemodsa.c`	表の情報の記述
`cdemodsc.c`	オブジェクト型の情報の記述
`cdemofo.c`	アプリケーション・フェイルオーバー・コールバックの登録および操作
`cdemolb.c`	LOBデータの作成と挿入およびその後のデータの読取り、書込み、コピー、追加および切捨て
`cdemolb2.c`	ストリーム・モードおよびコールバック関数を使用した`CLOB`および`BLOB`列の書込みおよび読取り
`cdemolbs.c`	LOBバッファリング・システムを使用したLOBの書込みおよび読取り
`cdemobj.c`	`REF`オブジェクトの確保およびナビゲーション
`cdemocoll.c`	ネストした表とVARRAYの挿入および選択
`cdemorid.c`	`INSERT`、`UPDATE`、`DELETE`文およびフェッチを使用した1ラウンドトリップでの複数ROWIDの取得
`cdemoses.c`	セッション切替えおよび移行の使用
`cdemothr.c`	OCIThreadパッケージの使用
`cdemosyev.c`	事前定義済サブスクリプションの登録およびクライアント通知用に呼び出すコールバック関数の指定(アドバンスト・キューイングの詳細は『Oracle Databaseアドバンスト・キューイング・ユーザーズ・ガイド』を参照してください)
`ociaqdemo00.c` `ociaqdemo01.c` `ociaqdemo02.c` `ociaqarrayenq.c` `ociaqarraydeq.c`	Streamsアドバンスト・キューイング。100メッセージをエンキューメッセージをブロックしてデキュー複数のエージェントをリスニング 10メッセージを配列してエンキュー 10メッセージを配列からデキュー
`cdemodp.c、cdemodp_lip.c`	ダイレクト・パス・ロード関数を使用したデータのロード
`cdemdpco.c` `cdemdpno.c` `cdemdpin.c` `cdemdpit.c` `cdemdpro.c` `cdemdpss.c`	ダイレクト・パス・ロード関数を使用した列オブジェクトのロードダイレクト・パス・ロード関数を使用した、ネストされた列オブジェクトのロード導出タイプ(継承)のロード - ダイレクト・パス継承があるオブジェクト表のロード - ダイレクト・パスダイレクト・パス・ロード関数を使用した参照のロードダイレクト・パス・ロード関数を使用したSQL文字列のロード
`cdemoucb.c、cdemoucbl.c`	静的および動的ユーザー・コールバックの使用
`cdemoupk.c、cdemoup1.c、cdemoup2.c`	複数パッケージでの動的ユーザー・コールバックの使用
`cdemodt.c`	日時および時間隔の例。(PL/SQLプロシージャまたは関数でのINおよびOUTバインドのデモ)
`cdemosc.c`	スクロール・カーソル
`cdemol2l.c`	`LONG` API (データ・インタフェース)を使用したLOBへのアクセス
`cdemoin1.c`	表にある継承されたタイプを変更し、その表からレコードを表示する継承デモ
`cdemoin2.c`	属性の代入性を提示する継承デモ
`cdemoin3.c`	オブジェクト、継承されたタイプ、オブジェクト表およびサブ表を記述した継承デモ
`cdemoanydata1.c`	任意データ・デモ。任意データ表との間での行の挿入と選択
`cdemoanydata2.c`	任意データ・デモ。`OCITypeBeginCreate()`を使用してタイプをピース単位に作成し、作成した新しいタイプを記述
`cdemoqc.c`	SQLヒントを使用した問合せキャッシュ
`cdemoqc2.c`	SQLヒントおよび表注釈を使用した問合せキャッシュ
`cdemosp.c`	セッション・プーリング
`cdemocp.c`	接続プーリング
`cdemocpproxy.c`	プロキシ機能を使用した接続プーリング
`cdemostc.c`	文キャッシュ
`cdemouni.c`	OCI UTF16 APIのプログラム
`nchdemo1.c`	`NCHAR`の暗黙的変換機能およびコード・ポイント機能の表示