はじめに

この章では、『Oracle Database SQLJ開発者ガイド』の概要、対象読者および表記規則について説明します。関連するOracleドキュメントのリストも提供します。

この章の構成は、次のとおりです。

対象読者

このマニュアルは、SQLJプログラミングに関心のあるすべての読者を対象にしていますが、次の事項に関するいくらかの予備知識があることを前提にしています。

Java
SQL
PL/SQL
Oracle Database

SQLの一般知識で十分ですが、JDBCおよびOracle固有のSQL機能に関する知識もあると役立ちます。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートを購入したオラクル社のお客様は、My Oracle Supportを介して電子的なサポートにアクセスできます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

表記規則

このセクションでは、このマニュアルの本文およびコード例で使用される表記規則について説明します。この項の内容は次のとおりです。

ノート:

コマンドラインの例は、システム・プロンプトが「%」のUNIX環境用であることに注意してください。これは単に慣例であり、使用するオペレーティング・システムで適切なように調整できます。

本文の表記規則

本文では、特定の項目が一目でわかるように、次の表記規則を使用します。次の表に、その規則と使用例を示します。

規則	意味	例
イタリック	イタリックは、ドキュメントのタイトルまたは強調、あるいは本文中で定義されている用語を示します。	Oracle Database概要リカバリ・カタログおよびターゲット・データベースは、同一のディスクには存在しないことを確認してください。
`固定幅フォントの大文字`	固定幅フォントの大文字は、システム指定の要素を示します。このような要素には、パラメータ、権限、データ型、RMANキーワード、SQLキーワード、SQL*Plusまたはユーティリティ・コマンド、パッケージおよびメソッドがあります。また、システム指定の列名、データベース・オブジェクト、データベース構造、ユーザー名およびロールも含まれます。	`NUMBER`列に対してのみ、この句を指定できます。 `BACKUP`コマンドを使用して、データベースのバックアップを作成できます。 `USER_TABLES`データ・ディクショナリ・ビュー内の`TABLE_NAME`列を問い合せます。 `DBMS_STATS`.`GENERATE_STATS`プロシージャを使用します。
`固定幅フォントの小文字`	固定幅フォントの小文字は、実行可能ファイル、ファイル名、ディレクトリ名およびユーザーが指定する要素のサンプルを示します。このような要素には、コンピュータ名およびデータベース名、ネット・サービス名および接続識別子があります。また、ユーザーが指定するデータベース・オブジェクトとデータベース構造、列名、パッケージとクラス、ユーザー名とロール、プログラム・ユニットおよびパラメータ値も含まれます。ノート: プログラム要素には、大文字と小文字を組み合せて使用するものもあります。これらの要素は、記載されているとおりに入力してください。	`sqlplus`と入力してSQL*Plusをオープンします。パスワードは、`orapwd`ファイルで指定します。 `/disk1/oracle/dbs`ディレクトリのデータ・ファイルおよび制御ファイルをバックアップします。 `hr.departments`表には、`department_id`、`department_name`および`location_id`列があります。 `QUERY_REWRITE_ENABLED`初期化パラメータを`true`に設定します。 `oe`ユーザーとして接続します。 `JRepUtil`クラスが次のメソッドを実装します。
`固定幅フォントの小文字のイタリック`	固定幅フォントの小文字のイタリックは、プレースホルダまたは変数を示します。	`parallel_clause`を指定できます。 `old_release.SQL`を実行します。ここで、`old_release` とはアップグレード前にインストールしたリリースを示します。

コード例の表記規則

コード例は、SQL、PL/SQL、SQL*Plusまたは他のコマンドライン文の例です。次のように固定幅フォントで表示され、通常のテキストと区別されます。

SELECT username FROM dba_users WHERE username = 'MIGRATE';

次の表に、コード例で使用される表記規則とその使用例を示します。

このドキュメントではオプションに山カッコを使用することに言及するよう次の1行目を変更しました。

規則	意味	例
< >	このドキュメントでは、1つ以上のオプション項目を囲むために、丸カッコではなく、山カッコが使用されます。山カッコは入力しないでください。(丸カッコは、SQLJ構文を考慮して使用しません)	`DECIMAL (digits` `< ,` `precision` `>)`
\|	縦線は、大カッコまたは中カッコ内の複数の選択項目の区切りに使用します。項目のうちの1つを入力します。縦線は、入力しないでください。	`{ENABLE \| DISABLE}` `[COMPRESS \| NOCOMPRESS]`
`...`	水平の省略記号は、次のいずれかを示します。例に直接関連しないコードの一部が省略されている。コードの一部を繰り返すことができる。	`CREATE TABLE ... AS` `subquery;SELECT` `col1,` `col2, ... ,` `coln` `FROM employees;`
その他の記号	大カッコ、中カッコ、縦線および省略記号以外の記号は、記載されているとおりに入力する必要があります。	`acctbal NUMBER(11,2);` `acct CONSTANT NUMBER(4) := 3;`
`Italics`	イタリック体は、特定の値を指定する必要があるプレースホルダや変数を示します。	`CONNECT SYSTEM` Enter password: password `DB_NAME =` `database_name`
`UPPERCASE`	大文字は、システム指定の要素を示します。これらの要素は、ユーザー定義の要素と区別するために大文字で示されます。大カッコ内にないかぎり、表示されているとおりの順序および綴りで入力します。ただし、大/小文字が区別されないため、小文字で入力してもかまいません。	`SELECT last_name, employee_id FROM employees;` `SELECT * FROM USER_TABLES;` `DROP TABLE hr.employees;`
`lowercase`	小文字は、ユーザー指定のプログラム要素を示します。たとえば、表名、列名またはファイル名などです。ノート: プログラム要素には、大文字と小文字を組み合せて使用するものもあります。これらの要素は、記載されているとおりに入力してください。	`SELECT last_name, employee_id FROM employees;` `sqlplus hr/hr` `CREATE USER mjones IDENTIFIED BY ty3MU9;`

対象読者

関連ドキュメント

ドキュメントのアクセシビリティについて

表記規則