Oracle® Application Express SQLワークショップ・ガイド

リリース4.2 for Oracle Database 12c

B71341-01(原本部品番号:E17964-06)

目次

表一覧

タイトルおよび著作権情報

はじめに

- トピック概要

- 対象読者

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

- 関連ドキュメント

- 表記規則

このリリースでの変更点

- Oracle Application Expressリリース4.2での変更点

1 オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理

- 1.1 オブジェクト・ブラウザへのアクセス

- 1.2 オブジェクト・ブラウザについて

- 1.3 データベース・オブジェクトの検索および参照

- 1.3.1 データベース・オブジェクトの検索および選択

- 1.3.2 「オブジェクト選択」ペインの非表示

- 1.4 データベース・オブジェクトの作成について

- 1.5 表の管理

- 1.5.1 表の作成

- 1.5.2 表の参照

- 1.5.2.1 使用可能なビューのまとめ

- 1.5.3 表の編集

- 1.5.4 表の削除

- 1.6 ビューの管理

- 1.6.1 ビューの作成

- 1.6.2 ビューの参照

- 1.6.2.1 使用可能なビューのまとめ

- 1.6.3 ビューの編集

- 1.6.3.1 ビューの手動編集

- 1.6.3.2 検索および置換の使用

- 1.6.3.3 ビューのダウンロード

- 1.6.4 ビューのコンパイル

- 1.6.5 ビューの削除

- 1.7 索引の管理

- 1.7.1 索引の作成

- 1.7.2 索引の参照

- 1.7.2.1 使用可能なビューのまとめ

- 1.7.3 索引の削除

- 1.8 順序の管理

- 1.8.1 順序の作成

- 1.8.2 順序の参照

- 1.8.2.1 使用可能なビューのまとめ

- 1.8.3 順序の削除

- 1.9 タイプの管理

- 1.9.1 タイプの作成

- 1.9.2 タイプの参照

- 1.9.2.1 使用可能なビューのまとめ

- 1.9.3 タイプの削除

- 1.10 パッケージの管理

- 1.10.1 パッケージの作成

- 1.10.2 パッケージの表示

- 1.10.2.1 使用可能なビューのまとめ

- 1.10.3 パッケージの編集

- 1.10.3.1 パッケージの手動編集

- 1.10.4 パッケージのコンパイル

- 1.10.5 パッケージのダウンロード

- 1.10.6 パッケージの削除

- 1.11 プロシージャの管理

- 1.11.1 プロシージャの作成

- 1.11.2 プロシージャの参照

- 1.11.2.1 使用可能なビューのまとめ

- 1.11.3 プロシージャの編集

- 1.11.3.1 プロシージャの手動編集

- 1.11.4 プロシージャのコンパイル

- 1.11.5 プロシージャのダウンロード

- 1.11.6 プロシージャの削除

- 1.12 ファンクションの管理

- 1.12.1 関数の作成

- 1.12.2 ファンクションの参照

- 1.12.2.1 使用可能なビューのまとめ

- 1.12.3 ファンクションの編集

- 1.12.3.1 ファンクションの手動編集

- 1.12.4 ファンクションのコンパイル

- 1.12.5 ファンクションのダウンロード

- 1.12.6 ファンクションの削除

- 1.13 トリガーの管理

- 1.13.1 トリガーの作成

- 1.13.2 トリガーの参照

- 1.13.2.1 使用可能なビューのまとめ

- 1.13.3 トリガーの編集

- 1.13.3.1 トリガーの手動編集

- 1.13.4 トリガーのコンパイル

- 1.13.5 トリガーのダウンロード

- 1.13.6 トリガーの削除

- 1.14 データベース・リンクの管理

- 1.14.1 データベース・リンクの作成

- 1.14.2 データベース・リンクの参照

- 1.14.2.1 使用可能なビューのまとめ

- 1.14.3 データベース・リンクの削除

- 1.15 マテリアライズド・ビューの管理

- 1.15.1 マテリアライズド・ビューの作成

- 1.15.2 マテリアライズド・ビューの参照

- 1.15.2.1 使用可能なビューのまとめ

- 1.15.3 マテリアライズド・ビューの削除

- 1.16 シノニムの管理

- 1.16.1 シノニムの作成

- 1.16.2 シノニムの表示

- 1.16.3 シノニムの削除

2 SQLコマンドの使用

- 2.1 「SQLコマンド」の概要

- 2.2 「SQLコマンド」へのアクセス

- 2.3 「SQLコマンド」ホームページについて

- 2.4 コマンド・エディタの使用

- 2.4.1 SQLコマンドの実行

- 2.4.2 「SQLコマンド」のトランザクションについて

- 2.4.3 サポートされていないSQL*Plusコマンドについて

- 2.4.4 コマンドの終了について

- 2.4.5 バインド変数の使用

- 2.4.6 「表の検索」アイコンの使用

- 2.5 SQLコマンドの保存

- 2.6 コマンドのコピー

- 2.7 結果の表示

- 2.7.1 「結果」ペインへのアクセス

- 2.7.2 「結果」ペインについて

- 2.8 実行計画の使用

- 2.8.1 実行計画の表示

- 2.8.2 「実行計画」ペインについて

- 2.9 保存されたコマンドの使用

- 2.9.1 保存されたコマンドへのアクセス

- 2.9.2 「保存されたSQL」ペインについて

- 2.10 SQLコマンド履歴の使用

- 2.10.1 コマンド履歴からのコマンドへのアクセス

- 2.10.2 「履歴」ペインについて

3 SQLスクリプトの使用

- 3.1 「SQLスクリプト」の概要

- 3.2 「SQLスクリプト」へのアクセス

- 3.2.1 SQLスクリプト・ページについて

- 3.3 SQLスクリプトの作成

- 3.3.1 スクリプト・エディタでのSQLスクリプトの作成

- 3.3.2 SQLスクリプトのアップロード

- 3.4 スクリプト・エディタの使用

- 3.4.1 既存のスクリプトの編集

- 3.4.2 テキストまたは正規表現の検索および置換

- 3.4.3 スクリプト・エディタのコントロールのサマリー

- 3.5 SQLスクリプトの削除

- 3.5.1 SQLスクリプト・ページからのスクリプトの削除

- 3.5.2 スクリプト・エディタでのスクリプトの削除

- 3.6 SQLスクリプトのコピー

- 3.7 SQLスクリプトの実行

- 3.7.1 スクリプト・エディタでのSQLスクリプトの実行

- 3.7.2 SQLスクリプト・ページからのSQLスクリプトの実行

- 3.8 SQLスクリプト結果の表示

- 3.8.1 SQLスクリプト・ページからの結果の表示

- 3.8.2 結果ページについて

- 3.9 SQLスクリプトのエクスポートおよびインポート

- 3.9.1 エクスポート・スクリプトへのスクリプトのコピー

- 3.9.1.1 「スクリプト」ペインについて

- 3.9.1.2 「エクスポートするスクリプト」ペイン

- 3.9.2 エクスポート・スクリプトからのスクリプトのインポート

- 3.9.2.1 「スクリプトのインポート」ペインについて

- 3.10 スクリプトおよび結果の割当て制限の表示

4 Oracle Application Expressユーティリティの使用

- 4.1 SQLクエリー・ビルダーを使用した問合せの構築

- 4.1.1 クエリー・ビルダーについて

- 4.1.1.1 クエリー・ビルダーへのアクセス

- 4.1.1.2 問合せ作成プロセスの理解

- 4.1.2 「オブジェクト選択」ペインの使用

- 4.1.2.1 オブジェクトの検索とフィルタの適用

- 4.1.2.2 「オブジェクト選択」ペインの非表示

- 4.1.3 オブジェクトの選択

- 4.1.3.1 サポートされる列の型について

- 4.1.3.2 「設計」ペインへのオブジェクトの追加

- 4.1.3.3 「設計」ペインでのオブジェクトの削除または非表示

- 4.1.4 問合せ条件の指定

- 4.1.5 オブジェクト間の関係の作成

- 4.1.5.1 結合条件について

- 4.1.5.2 オブジェクトの手動結合

- 4.1.5.3 オブジェクトの自動結合

- 4.1.6 保存された問合せでの操作

- 4.1.6.1 問合せの保存

- 4.1.6.2 保存された問合せの編集

- 4.1.6.3 保存された問合せの削除

- 4.1.7 生成されたSQLの表示

- 4.1.8 問合せ結果の表示

- 4.2 データ・ワークショップを使用したデータの管理

- 4.2.1 データのインポート、エクスポート、ロードおよびアンロードについて

- 4.2.1.1 正しいインポート/エクスポート/ロード/アンロード・オプションの選択

- 4.2.2 データのロード/アンロード・ページへのアクセス

- 4.2.3 データのロード

- 4.2.3.1 テキスト・ファイルまたはスプレッドシート・データのロード

- 4.2.3.2 XML文書のロード

- 4.2.4 データのアンロード

- 4.2.4.1 テキスト・ファイルのアンロード

- 4.2.4.2 XML文書へのアンロード

- 4.2.5 リポジトリの使用

- 4.3 DDLの生成

- 4.4 表のメソッドの管理

- 4.5 ユーザー・インタフェースのデフォルト値の管理

- 4.5.1 表のユーザー・インタフェースのデフォルト値の作成

- 4.5.2 表のユーザー・インタフェースのデフォルト値の変更

- 4.5.3 ユーザー・インタフェース属性の作成

- 4.5.4 ユーザー・インタフェース属性の変更

- 4.5.5 ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

- 4.6 データベースの詳細の表示

- 4.7 スキーマの比較

- 4.8 オブジェクト・レポートの表示

- 4.8.1 表レポート

- 4.8.2 セキュリティ・レポート

- 4.8.3 PL/SQLレポート

- 4.8.3.1 プログラム・ユニット引数

- 4.8.3.2 ユニット行数

- 4.8.3.3 PL/SQLソース・コードの検索

- 4.8.4 例外レポート

- 4.8.5 すべてのオブジェクトに関するレポート

- 4.9 データベースの監視

- 4.9.1 セッション

- 4.9.1.1 「セッション」レポート

- 4.9.1.2 「ロック」レポート

- 4.9.1.3 「待機」レポート

- 4.9.1.4 「I/O」レポート

- 4.9.1.5 「SQL」レポート

- 4.9.1.6 オープン・カーソル

- 4.9.2 システム統計について

- 4.9.3 上位のSQLについて

- 4.9.4 長時間操作について

- 4.10 ごみ箱を使用した、削除されたオブジェクトの表示およびリストア

- 4.10.1 ごみ箱内のオブジェクトの管理

- 4.10.2 オブジェクトを表示せずにごみ箱を空にする

5 RESTfulサービスの使用

- 5.1 RESTの概要

- 5.2 RESTfulサービスについて

- 5.3 RESTfulサービスの要件

- 5.4 RESTfulサービスへのアクセス

- 5.5 RESTfulサービス・モジュールの例(oracle.example.hr)について

- 5.5.1 CSV形式での結果セットの返却(empinfo/)

- 5.5.2 パラメータに基づくデータの取得(employees/{id})

- 5.5.3 ページ区切りセットを使用したJSON形式での結果セットの取得(employees/)

- 5.5.4 フィードとしての結果セットの返却(employeesfeed/)

- 5.5.5 PL/SQLブロックに基づく結果セットの返却(empsecformat/{empname})

- 5.6 RESTfulサービス・モジュールの管理

- 5.6.1 RESTfulサービス・モジュールの作成

- 5.6.2 RESTfulサービス・モジュールの編集

- 5.6.3 RESTfulサービス・モジュールの削除

- 5.6.4 RESTfulサービス権限の管理

- 5.6.4.1 RESTful Webサービス・モジュールへの権限の割当て

- 5.6.4.2 RESTfulサービス権限の作成

- 5.6.4.3 RESTfulサービス権限の編集

- 5.6.4.4 RESTfulサービス権限の削除

- 5.6.5 RESTfulサービス・モジュールのエクスポート

- 5.6.6 RESTfulサービス・モジュールのインポート

- 5.7 リソース・テンプレートの管理

- 5.7.1 リソース・テンプレートの追加

- 5.7.2 リソース・テンプレートの編集

- 5.7.3 リソース・テンプレートの削除

- 5.8 リソース・ハンドラの管理

- 5.8.1 リソース・ハンドラの追加

- 5.8.2 リソース・ハンドラの編集

- 5.8.3 リソース・ハンドラの削除

索引

表一覧

- 1-1 表に使用可能なビュー

- 1-2 表の編集ボタン

- 1-3 ビューに使用可能なビュー

- 1-4 索引に使用可能なビュー

- 1-5 順序に使用可能なビュー

- 1-6 タイプに使用可能なビュー

- 1-7 パッケージに使用可能なビュー

- 1-8 プロシージャに使用可能なビュー

- 1-9 ファンクションに使用可能なビュー

- 1-10 トリガーに使用可能なビュー

- 1-11 データベース・リンクに使用可能なビュー

- 1-12 マテリアライズド・ビューに使用可能なビュー

- 3-1 スクリプト・エディタのボタンおよびコントロール

- 4-1 「条件」タブ

- 4-2 Oracle Application Expressのインポート/エクスポート・オプションのサマリー

- 4-3 インポート/エクスポートの例と推奨オプション

Oracle® Application Express

SQLワークショップ・ガイド

リリース4.2 for Oracle Database 12c

B71341-01(原本部品番号:E17964-06)

2013年4月

Oracle Application Express SQLワークショップ・ガイド リリース4.2 for Oracle Database 12c

B71341-01

Copyright © 2003, 2013, Oracle and/or its affiliates.All rights reserved.

原本著者: Drue Swadener

原本協力者: Marco Adelfio、Carl Backstrom、Christina Cho、Michael Hichwa、Christopher Jones、Joel Kallman、Sharon Kennedy、Syme Kutz、Terri Jennings、Kris Rice、Marc Sewtz、Scott Spadafore、Scott Spendolini、Jason Straub、Simon Watt

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

はじめに

『Oracle Application Express SQLワークショップ・ガイド』では、Oracle Application Express SQLワークショップおよびユーティリティを使用して、Oracle Databaseに対するデータのロードとアンロード、DDLの生成、オブジェクト・レポートの表示、および削除されたデータベース・オブジェクトのリストアを行う方法を説明します。

内容は次のとおりです。

- トピック概要

- 対象読者

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

- 関連ドキュメント

- 表記規則

トピック概要

このマニュアルは、次の章で構成されています。

タイトル

説明

このリリースでの変更点

Oracle Application Expressリリース4.2に関するこのドキュメントでの変更点について説明します。

オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理

オブジェクト・ブラウザを使用して開発者がデータベースでオブジェクトを参照、作成および編集する方法を説明します。

SQLコマンドの使用

SQLコマンドを使用してSQLコマンドを作成、編集、表示、実行および削除する方法を説明します。

SQLスクリプトの使用

SQLスクリプトを使用してスクリプト・ファイルを作成、編集、表示、実行および削除する方法を説明します。

Oracle Application Expressユーティリティの使用

Oracle Application Expressユーティリティを使用して、Oracle Databaseに対するデータのロードおよびアンロード、DDLの生成、オブジェクト・レポートの表示および削除されたデータベース・オブジェクトのリストアを行う方法を説明します。

RESTfulサービスの使用

Oracle Application Express RESTfulサービスを使用して、データベースへのアクセスに使用されるRESTfulサービスの宣言仕様を有効にする方法を説明します。

対象読者

『Oracle Application Express SQLワークショップ・ガイド』は、Oracle Application Expressを使用して、データベース集中型のWebアプリケーションを構築するアプリケーション開発者を対象としています。Oracle Application Express SQLワークショップおよびユーティリティを使用して、Oracle Databaseに対するデータのロードとアンロード、DDLの生成、オブジェクト・レポートの表示、および削除されたデータベース・オブジェクトのリストアを行う方法を説明します。

このガイドを使用するには、リレーショナル・データベースの概念、およびOracle Application Expressを実行するオペレーティング・システム環境について理解しておく必要があります。

参照:
Oracle Database Application Express 2日で開発者ガイド

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

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

Oracle Supportへのアクセス

Oracleサポート・サービスでは、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)を参照してください。

ドキュメント内のサンプル・コードのアクセシビリティについて

スクリーン・リーダーは、ドキュメント内のサンプル・コードを正確に読めない場合があります。コード表記規則では閉じ括弧のみを行に記述する必要があります。しかし、一部のスクリーン・リーダーは括弧のみの行を読まない場合があります。

外部Webサイトのドキュメントのアクセシビリティについて

このドキュメントにはオラクル社およびその関連会社が所有または管理しないWebサイトへのリンクが含まれている場合があります。オラクル社およびその関連会社は、それらのWebサイトのアクセシビリティに関しての評価や言及は行っておりません。

関連ドキュメント

詳細は、次のOracleドキュメントを参照してください。

- Oracle Application Expressリリース・ノート

- Oracle Application Expressインストレーション・ガイド

- Oracle Database Application Express 2日で開発者ガイド

- Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド

- Oracle Application Express APIリファレンス

- Oracle Application Express管理ガイド

- Oracle Application Expressアプリケーション移行ガイド

- Oracle Application Expressエンド・ユーザー・ガイド

- Oracle Database概要

- Oracle Database開発ガイド

- Oracle Database管理者ガイド

- Oracle Database SQL言語リファレンス

- SQL*Plusユーザーズ・ガイドおよびリファレンス

- Oracle Database PL/SQL言語リファレンス

- Oracle Application Expressリスナー・インストレーションおよび開発者ガイド

Oracleエラー・メッセージについては、Oracle Databaseエラー・メッセージを参照してください。Oracleエラー・メッセージのドキュメントはHTMLのみで提供されています。Oracle Databaseドキュメント・ライブラリにアクセスできる場合は、エラー・メッセージを範囲で検索できます。特定の範囲を検索したら、ブラウザのページ内検索機能を使用して特定のメッセージを検索します。インターネットに接続している場合、オラクル社のオンライン・ドキュメントのエラー・メッセージ検索機能を使用して特定のエラー・メッセージを検索できます。

ドキュメント・セットにある多数のマニュアルでは、Oracleをインストールするときにデフォルトでインストールされるシード・データベースのサンプル・スキーマを使用しています。スキーマの作成方法および使用方法の詳細は、Oracle Databaseサンプル・スキーマを参照してください。

Oracle Technology Networkで入手できる追加のドキュメントについては、次のOracle Application ExpressのWebサイトにアクセスしてください。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

その他のアプリケーションの例については、Learning Libraryを参照してください。Oracle by Example(OBE)、デモ、チュートリアルなどの無料オンライン・トレーニング・コンテンツを検索します。次のURLでOracle Learning Libraryにアクセスしてください。

http://www.oracle.com/technetwork/tutorials/index.html

印刷されたマニュアルは次のURLのOracle Storeで入手できます。

http://shop.oracle.com/

すでにOTNのユーザー名およびパスワードを取得している場合は、次のURLでOTN Webサイトのドキュメントのセクションに直接接続できます。

http://www.oracle.com/technology/documentation/

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

このリリースでの変更点

この章の内容は次のとおりです。

- Oracle Application Expressリリース4.2での変更点

Oracle Application Expressリリース4.2での変更点

Oracle Application Expressリリース4.2の『Oracle Application Express SQLワークショップ・ガイド』の変更点は次のとおりです。

新機能

このリリースの新機能は次のとおりです。

- RESTful Webサービス
SQL Workshopでは、データベースからRESTful Webサービスの呼出しを定義できるようになりました。Oracle Application Expressリスナー2.0と組み合されるこれらの定義によって、データベースは、単にWebサービスを消費できるのみでなく、RESTful Webサービスを生成できます。

「RESTfulサービスの使用」を参照してください。

その他の変更

このリリースでの追加変更は次のとおりです。

- すべての内容は、新機能に合わせて更新されました。

- スクリーン・キャプチャおよびグラフィックは、Oracle Application Expressリリース4.2のユーザー・インタフェースの拡張に合わせて追加および更新されました。

1 オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理

オブジェクト・ブラウザを使用すると、開発者はデータベース内のオブジェクトを参照、作成および編集することができます。Oracle Application Expressには、基礎となる表構造の処理に役立つよう定義されたビューが多数用意されています。ビューでは複数の実表が結合され、わかりやすい列名が使用されるため、複雑さが最小限に抑えられ、より直観的に使用しやすくなっています。定義済のビューの詳細は、『Oracle Application Express APIリファレンス』を参照してください。

内容は次のとおりです。

- オブジェクト・ブラウザへのアクセス

- オブジェクト・ブラウザについて

- データベース・オブジェクトの検索および参照

- データベース・オブジェクトの作成について

- 表の管理

- ビューの管理

- 索引の管理

- 順序の管理

- タイプの管理

- パッケージの管理

- プロシージャの管理

- ファンクションの管理

- トリガーの管理

- データベース・リンクの管理

- マテリアライズド・ビューの管理

- シノニムの管理

参照:
Oracle Database SQL言語リファレンス

1.1 オブジェクト・ブラウザへのアクセス

オブジェクト・ブラウザにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページにログインします。

2. 「SQLワークショップ」をクリックします。

3. 「オブジェクト・ブラウザ」をクリックして、「オブジェクト・ブラウザ」ホームページにドリルダウンします。
図obj_browser.gifの説明

注意:
インスタンス管理者がこのApplication Expressインスタンスに対してRESTfulサービスを無効にしている場合、このインスタンスでRESTfulサービスが使用できないため、RESTfulサービス・アイコンが表示されません。『Oracle Application Express管理ガイド』のSQLワークショップの構成に関する説明を参照してください。

1.2 オブジェクト・ブラウザについて

オブジェクト・ブラウザ・ページは、2つのセクションに分かれています。

- 「オブジェクト選択」ペインはオブジェクト・ブラウザ・ページの左側に表示され、現行スキーマ内の選択されているタイプのデータベース・オブジェクトが表示されます。オブジェクト名に対してフィルタを適用して、さらに結果を絞り込むことができます。

- 「詳細」ペインはページの右側に表示され、選択したオブジェクトの詳細情報が表示されます。オブジェクトの詳細を表示するには、「オブジェクト選択」ペインでオブジェクトを選択します。「詳細」ペイン上部のタブをクリックして、現行のオブジェクトの詳細を表示します。オブジェクトを編集するには、該当するボタンをクリックします。

図obj_b_pane.gifの説明

参照:
「データベース・オブジェクトの検索および参照」および「データベース・オブジェクトの作成について」

スキーマの選択

スキーマはデータベース・オブジェクトの論理的なコンテナです。別のスキーマのオブジェクトにアクセスするには、SQLワークショップのホームページで「スキーマ」リストから選択します。自分のワークスペースに割り当てられたスキーマのみがリストされます。

別のSQLワークショップ・コンポーネントへの切替え

ページの右上にある、対応するアイコンを選択すると、別のSQLワークショップ・コンポーネントにナビゲートできます。

図obj_b_icons.gifの説明

次の使用可能なアイコンがあります。

- オブジェクト・ブラウザ: 「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

- SQLコマンド: 「SQLコマンドの使用」を参照してください。

- SQLスクリプト: 「SQLスクリプトの使用」を参照してください。

- クエリー・ビルダー: 「SQLクエリー・ビルダーを使用した問合せの構築」を参照してください。

- ユーティリティ: 「Oracle Application Expressユーティリティの使用」を参照してください。

- RESTfulサービス: 「RESTfulサービスへのアクセス」を参照してください。

- ヘルプ。

1.3 データベース・オブジェクトの検索および参照

「オブジェクト選択」ペインはオブジェクト・ブラウザ・ページの左側に表示され、データベース・オブジェクトがタイプごとに現行スキーマとともに表示されます。オブジェクト・タイプを選択するか、大/小文字を区別しない検索条件を入力して、ビューにフィルタを適用できます。

内容は次のとおりです。

- データベース・オブジェクトの検索および選択

- 「オブジェクト選択」ペインの非表示

1.3.1 データベース・オブジェクトの検索および選択

「オブジェクト選択」ペインでデータベース・オブジェクトを検索するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストからオブジェクト・タイプを選択します。
表示されるオブジェクトのリストは、現行スキーマで使用可能なオブジェクトによって異なります。横に赤いバーが表示されているオブジェクトは無効であることに注意してください。

図obj_b_srch.gifの説明

3. オブジェクト名を検索するには、「検索」フィールドに大/小文字を区別しない検索条件を入力します。

4. すべてのオブジェクトを表示するには、検索フィールドを空のままにします。

表示するデータベース・オブジェクトを検索したら、そのオブジェクトを選択します。選択したオブジェクトが「詳細」ペインに表示されます。オブジェクトを選択しない場合、「詳細」ペインは空白になります。

1.3.2 「オブジェクト選択」ペインの非表示

オブジェクトの非表示のコントロールを選択して、「オブジェクト選択」ペインを非表示にできます。このコントロールは「オブジェクト選択」ペインの右側に表示されます。「オブジェクト選択」ペインが表示されている場合は、このコントロールを選択すると「オブジェクト選択」ペインが非表示になります。同様に、「オブジェクト選択」ペインが非表示の場合は、このコントロールを選択すると、再度ペインが表示されます。

図obj_b_hide.gifの説明

1.4 データベース・オブジェクトの作成について

データベース・オブジェクトの作成ウィザードを使用して、データベース・オブジェクトを作成できます。オブジェクトを選択すると、「詳細」ペインの上部に一連のタブとボタンが表示されます。タブを使用して現行のアイテム(表の索引など)の様々な設定を表示します。ボタンを使用して現行のオブジェクトを変更します。

オブジェクトを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「詳細」ペインの右上にある「作成」をクリックします。

3. オブジェクト・タイプのリストから、作成するオブジェクトのタイプを選択します。

4. 画面に表示されるステップに従います。

1.5 表の管理

表は、Oracle Databaseのデータ記憶域の単位で、行と列が含まれます。オブジェクト・ブラウザで表を表示すると、表内の各列を説明する表の説明が表示されます。

内容は次のとおりです。

- 表の作成

- 表の参照

- 表の編集

- 表の削除

参照:

- 表の管理については、Oracle Database管理者ガイドを参照してください。

- 表のタイプの概念については、Oracle Database概要を参照してください。

- 表の作成および変更に必要な構文の詳細は、Oracle Database SQL言語リファレンスを参照してください。

1.5.1 表の作成

表を作成する手順は、次のとおりです。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「表」を選択します。

4. 表名を入力します。
表名は、Oracleのネーミング規則に準拠する必要があります。

5. 最終的な表名を「表名」フィールドで使用した大/小文字表記に一致させるには、「大/小文字を保持」をクリックします。

6. 各列の詳細を入力します。各列に対して、次のステップを実行します。

1. 列名を入力します。

2. 列タイプを選択します。

3. 必要に応じて、次の追加情報を入力します。

- 精度
精度は小数点の前の桁数です。これは一部の列タイプに設定できます。精度は正の整数である必要があります。NUMBER、FLOAT、INTERVAL YEAR TO MONTH、およびINTERVAL DAY TO SECONDのみがこの設定を持ちます。たとえば、タイプNUMBERの列が精度4の場合、列値は0から9999までになります。

- スケール
スケール設定の機能は、列タイプに応じて異なります。NUMBERタイプの場合、スケールは小数点の後の桁数です。VARCHAR2およびCHARタイプの場合、スケールは格納される文字の数です。TIMESTAMPタイプの場合、スケールは小数秒の精度で、0から9の間の数である必要があります。スケールは正数である必要があります。たとえば、列タイプTIMESTAMPのスケールが3の場合、秒は.000秒から.999秒までになります。

4. 列が必ず値を持つように指定するには、「NOT NULL」列のチェック・ボックスを選択します。
以前に入力した列の順序を変更するには、「移動」列の上または下矢印をクリックします。列を追加するには、「列の追加」をクリックします。

5. Oracle Database 12cを実行している場合は、NUMBER列およびFLOAT列にアイデンティティ・オプションを選択します。オプションは次のとおりです。

- Always: Oracle Databaseは、この列に値を割り当てるために、常にシーケンス・ジェネレータを使用するようになります。INSERTまたはUPDATEを使用して、列に明示的に値を割り当てようとすると、エラーが返されます。

- Default: Oracle Databaseはシーケンス・ジェネレータを使用して列に値を割り当てますが、明示的に指定した値を列に割り当てることもできるようになります。

- Default on Null: それ以降のINSERT文でNULLに評価される値を割り当てようとしたときに、Oracle Databaseはシーケンス・ジェネレータを使用して列に値を割り当てます。

6. 「次へ」をクリックします。

次に、この表の主キーを定義します(オプション)。主キーは、レコードを一意に識別する単一のフィールドまたは複数のフィールドの組合せです。

7. 「主キー」で適切なオプションを選択し、「次へ」をクリックします。

- 主キーなし: 主キーは作成されません。

- 新しい順序から移入: 主キーを作成して、トリガーと順序を作成します。順序は、選択された主キー列を移入するためにトリガーで使用されます。主キーは単一の列のみです。

- 既存の順序から移入: 主キーを作成して、トリガーを作成します。選択された順序は、選択された主キー列を移入するためにトリガーで使用されます。主キーは単一の列のみです。

- 移入されていません: 主キーを定義しますが、トリガー内の順序から自動的に値を移入しません。コンポジット主キー(複数の列で構成される主キー)を定義する場合にもこのオプションを選択できます。

次に、外部キーを追加します(オプション)。外部キーによって、ある表の列(複数可)と別の表の主キーまたは一意キーとの関係が確立されます。

8. 外部キーを追加するには、次のステップを実行します。

1. 名前: 定義する外部キー制約の名前を入力します。

2. キー列の選択: 外部キーを構成する列を選択し、「追加」アイコンをクリックして列を「キー列」に移動します。

3. 参照表: この外部キーが参照する表を選択します。次に、この外部キーが参照する列を選択します。選択後、「追加」アイコンをクリックして、選択した列を「参照される列」に移動します。

4. 適切なオプションを選択します。

- 削除を許可しない: この表に依存行がある場合、参照表からの行の削除をブロックします。

- カスケード削除: 対応する親表内の行が削除された場合に、この表から依存行を削除します。

- 削除時にNULLを設定: 対応する親表内の行が削除された場合に、この表の外部キー列の値をNULLに設定します。

5. 「追加」をクリックします。

6. 「次へ」をクリックします。

次に、制約を追加します(オプション)。複数の制約を作成できますが、制約は1つずつ個別に追加する必要があります。

9. 制約を追加するには、次のステップを実行します。

1. 制約のタイプ(「チェック」または「一意」)を指定します。
チェック制約は、表内の1つ以上の列に対する妥当性チェックです。有効なチェック制約に違反している表では、レコードの挿入または更新を行うことはできません。一意制約では、1つの列または複数の列の組合せが一意キーとして指定されます。一意制約を満たすには、同じ表の2つの行を、指定した列に対して同じ値にすることはできません。

2. フィールドに制約を入力します。一意制約では、一意にする列を選択します。チェック制約では、flag in ('Y','N')のように、チェックする式を入力します。

3. 「追加」をクリックします。

10. 「次へ」をクリックします。
確認ページが表示されます。

11. 「作成」をクリックします。

参照:
表の詳細は、Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドの「「表ファインダ」の使用」およびOracle Database概要の表の概要に関するセクションを参照してください。

1.5.2 表の参照

オブジェクト・ブラウザで表を表示すると、表の説明が表示されます。この説明を確認しながら、列の追加、列の変更、列の名前変更、列の削除、表の名前変更、表のコピー、表の削除、表の切捨て、または現行の表の列に基づく参照表の作成ができます。また、関連情報を持つ他のレポートにアクセスすることもできます(この情報とは、表データ、索引、データ・モデル、制約、権限付与、統計、ユーザー・インタフェースのデフォルト、トリガー、依存性、および選択した表を作成するSQLなどです)。

表の説明を表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから「表」が選択されていることを確認します。

3. 「オブジェクト選択」ペインから表を選択します。
表の説明が表示されます。

1.5.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、表に関する各種レポートを表示します。表1-1に、使用可能なすべてのビューを示します。

表1-1 表に使用可能なビュー

ビュー

説明

表

最初の57列の詳細を示します。これには、列名、データ型、NULL値許可のステータス、デフォルト値および主キーが含まれます。表の詳細を確認しながら、列の追加、変更、削除および名前変更ができます。また、参照する表にレコードがない場合にのみ表の削除、名前変更、コピーまたは切捨てができ、参照表の作成もできます。

データをカンマ区切り(.csv)ファイルとしてエクスポートするには、「ダウンロード」リンクをクリックしてください。

データをPortable Document Format (.pdf)ファイルに出力するには、「出力」リンクをクリックします。このオプションでは、レポート・サーバーがインスタンス・レベルで構成されている必要があることに注意してください。『Oracle Application Express管理ガイド』のインスタンス設定の構成に関する説明を参照してください。

参照: 「表の編集」

データ

現行の表のデータのレポートを表示します。実行できる操作は次のとおりです。

- 問合せ - 列によるソートができます。特定の行を制限するには、「列条件」フィールドに条件を入力します。ワイルドカードにはパーセント記号(%)を使用します。「並替え基準」から、確認する列を選択して「問合せ」をクリックします。

- 行をカウント - 現行の表の列数のレポートを表示します。

- 行を挿入 - 表に行を挿入できます。

- ダウンロード: 表のすべてのデータをスプレッドシートにエクスポートします。選択した表のすべてのデータをエクスポートするには、ページ下部の「ダウンロード」リンクをクリックします。

索引

この表に関連付けられている索引を表示します。実行できる操作は、「作成」と「削除」です。

参照: 「索引の管理」

モデル

選択した表および関連するすべての表をグラフィカルに表示します。関連する表とは、外部キーで現行の表を参照する表、および現行の表の外部キーで参照されている表です。

下線の付いた表の名前の上にカーソルを置くと、その表と現行の表との関係を表示できます。下線の付いた表の名前をクリックすると、関連する表のモデルが表示されます。

制約

現行の表の制約リストを表示します。実行できる操作は、「作成」、「削除」、「有効化」、「無効化」です。

権限付与

権限受領者、権限、権限付与オプションなど、現行の表に関する権限付与のリストを表示します。このビューで実行できる操作は、「権限付与」および「取消し」です。

統計

行およびブロックの数、平均行長、サンプル・サイズ、データの最終分析日、圧縮ステータス(有効または無効)など、現行の表に関して収集された統計を表示します。「表を解析」ウィザードにアクセスするには、「解析」をクリックします。

UIのデフォルト値

フォームとレポートのユーザー・インタフェースのデフォルト値を表示します。開発者は、ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

定義済のユーザー・インタフェースのデフォルト値を編集するには、「編集」をクリックします。ユーザー・インタフェースのデフォルト値が定義されていない表のデフォルト値を初期化するには、「デフォルト値の作成」をクリックします。

参照: 「ユーザー・インタフェースのデフォルト値の管理」

トリガー

現行の表に関連付けられているトリガーのリストを表示します。実行できる操作は、「作成」、「削除」、「有効化」、「無効化」です。

トリガーの詳細を表示するには、トリガー名をクリックします。

参照: 「トリガーの管理」

依存性

この表によって参照されるオブジェクトおよびこの表のシノニムを示すレポートを表示します。

SQL

この表の再作成に必要なSQLを表示します。キー、索引、トリガーおよび表定義を含みます。

1.5.3 表の編集

表の説明の表示中に、表の説明の上にあるボタンをクリックして表を編集できます。

表を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから「表」が選択されていることを確認します。

3. 「オブジェクト選択」ペインから表を選択します。
表の説明が表示されます。

4. 表1-2に示す該当するボタンをクリックします。

表1-2「表の編集」ボタン

ボタン

説明

列の追加

列を表に追加します。列名を入力し、型を選択します。列タイプに応じて、列に値が必要かどうか、列長、精度およびスケールを指定します。

列の変更

選択した列を変更します。

列名の変更

選択した列の名前を変更します。

列の削除

選択した列を削除します。

名前の変更

選択した表の名前を変更します。

コピー

選択した表をコピーします。

削除

選択した表を削除します。

参照: 「ごみ箱を使用した、削除されたオブジェクトの表示およびリストア」

切捨て

選択した表からすべての行を削除します。表を切り捨てると、表を削除し、再作成するよりも効率的な場合があります。表の削除および再作成により、依存オブジェクトが無効になる可能性があり、その場合、オブジェクト権限の再付与や、索引、整合性制約およびトリガーの再作成が必要になります。

参照表の作成

選択した列に基づいて参照表を作成します。選択した列は、参照表への外部キーになります。

1.5.4 表の削除

表を削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから「表」が選択されていることを確認します。

3. 「オブジェクト選択」ペインから表を選択します。
表の説明が表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

参照:
「ごみ箱を使用した、削除されたオブジェクトの表示およびリストア」

1.6 ビューの管理

ビューは別の表のまたは複数の表の組合せの論理的な表現です。ビューにはデータが含まれることも格納されることもなく、そのビューの基になるビューまたは表からそのデータを取得します。基になる表は実表と呼ばれます。ビューで実行される操作はすべてビューの実表に影響を与えます。ビューが更新可能であるために、SETまたはDISTINCT、演算子、集計または分析ファンクション、GROUP BY、ORDER BY、CONNECT BY、START WITH句、SELECTリスト内の副問合せまたはコレクション式のどの構文も、ビューに含めることはできません。

表よりもビューの使用が推奨される例として、いくつかの列と多数の行があるHR.EMPLOYEES表を考えてみます。これらの列のうち5つの列のみ、または特定の行のみをユーザーに表示可能にするには、次のようにビューを作成します。

CREATE VIEW staff AS
SELECT employee_id, last_name, job_id, manager_id, department_id
FROM employees

内容は次のとおりです。

- ビューの作成

- ビューの参照

- ビューの編集

- ビューのコンパイル

- ビューの削除

参照:
Oracle Database管理者ガイド

1.6.1 ビューの作成

ビューを作成するには、次のようにします。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「ビュー」を選択します。

4. ビューを定義します。

- ビュー名: ビューの名前を入力します。

- 問合せ: ビューを定義する問合せを指定します。
クエリー・ビルダーまたはSQLコマンド・プロセッサにアクセスするには、ページ下部の該当するリンクをクリックします。選択したツールがポップアップ・ウィンドウに表示されます。該当するSQLが作成されたら、「戻る」をクリックします。ポップアップ・ウィンドウが自動的に閉じ、SQLとともにウィザードに戻ります。

5. 「次へ」をクリックします。
確認ページが表示され、ビューの作成に使用されるSQLが表示されます。

6. 「ビューの作成」をクリックします。

参照:
「SQLクエリー・ビルダーを使用した問合せの構築」および「「SQLコマンド」の使用」

1.6.2 ビューの参照

オブジェクト・ブラウザでビューにアクセスすると、「詳細」ペインに、そのビュー内の列を示すレポートが表示されます。

ビューを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ビュー」を選択します。

3. 「オブジェクト選択」ペインからビューを選択します。
ビュー定義に、該当する列が表示されます。

1.6.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、各種レポートを表示します。表1-3に、使用可能なすべてのビューを示します。

表1-3 ビューに使用可能なビュー

ビュー

説明

ビュー

(デフォルト)カレント・ビュー内の列を示します。実行できる操作は次のとおりです。

- コンパイル

- 削除

参照: 「ビューの編集」、「ビューのコンパイル」および「ビューの削除」

コード

コード・エディタを表示します。

参照: 「ビューの編集」.

データ

ビュー内の列データのレポートを表示します。実行できる操作は次のとおりです。

- 問合せ: 列によるソートができます。特定の行を制限するには、「列条件」フィールドに条件を入力します。ワイルドカードにはパーセント記号(%)を使用します。「並替え基準」から、確認する列を選択して「問合せ」をクリックします。

- 行をカウント: 表内の行をカウントできます。

- 行を挿入: 表に行を挿入できます。

権限付与

ビュー内の列に関連付けられている権限付与のリストを表示します。権限付与の詳細には、権限受領者、権限、権限付与オプションが含まれます。実行できる操作は、「権限付与」と「取消し」です。

UIのデフォルト値

フォームとレポートのユーザー・インタフェースのデフォルト値を表示します。開発者は、ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

既存のユーザー・インタフェースのデフォルト値を編集するには、「編集」をクリックします。ユーザー・インタフェースのデフォルト値が定義されていないビューのデフォルト値を初期化するには、「デフォルト値の作成」をクリックします。

参照: 「ユーザー・インタフェースのデフォルト値の管理」

依存性

このビューによって参照されるオブジェクトおよびこのビューのシノニムを示すレポートを表示します。

SQL

このビューの再作成に必要なSQLを表示します。

1.6.3 ビューの編集

ビューを編集する際には、コードの手動編集、検索および置換の実行、ビューのコンパイルが可能です。また、ビューをファイルとして保存したり、ビューを削除することができます。

1.6.3.1 ビューの手動編集

ビューを手動で編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ビュー」を選択します。

3. 「オブジェクト選択」ペインからビューを選択します。

4. 「コード」タブを選択します。
コード・エディタが表示されます。

ビューを編集および変更する場合は、コンパイルする必要があります。「ビューのコンパイル」を参照してください。

1.6.3.2 検索および置換の使用

基本的な検索および置換を実行するには、「検索して置換」をクリックします。

1.6.3.3 ビューのダウンロード

「ソースのダウンロード」をクリックすると、カレント・ビューがファイルとして保存されます。

1.6.4 ビューのコンパイル

ビューを編集および変更する場合は、変更内容を保存するためにコンパイルする必要があります。これはデータベース内のオブジェクトの単なるビューであるため、保存機能がないことに注意してください。

「保存してコンパイル」をクリックして現行のビューを再作成します。

1.6.5 ビューの削除

ビューを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ビュー」を選択します。

3. 「オブジェクト選択」ペインからビューを選択します。

4. 「ビュー」タブまたは「コード」タブを選択します。

5. 「削除」をクリックします。

6. 確定するには、「終了」をクリックします。

1.7 索引の管理

索引は、表およびクラスタに関連付けられたオプションの構造です。表の1つ以上の列に索引を作成すると、その列のデータへのアクセスを高速化できます。

オブジェクト・ブラウザで索引を表示すると、索引名、索引タイプ、表の所有者、表のタイプ、一意性、圧縮、接頭辞の長さ、表領域名、ステータス、最終解析、および索引付きの列のリストを含むレポートが「詳細」ペインに表示されます。

内容は次のとおりです。

- 索引の作成

- 索引の参照

- 索引の削除

1.7.1 索引の作成

索引を作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「索引」を選択します。

4. 表を選択し、作成する索引のタイプを選択します。使用可能な索引のタイプは次のとおりです。

- 標準: 表の1つ以上のスカラー型オブジェクト属性に索引を付けます。

- テキスト: テキストの索引(Oracle Text)を作成します。

5. 「次へ」をクリックします。

6. 索引の定義を作成します。索引名を指定し、索引を作成する1つ以上の列を選択して、「次へ」をクリックします。
確認ページが表示され、索引の作成に使用されるSQLが表示されます。

7. 確定するには、「索引の作成」をクリックします。

1.7.2 索引の参照

索引を参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「索引」を選択します。

3. 「オブジェクト選択」ペインから索引を選択します。
索引が、索引名、タイプ、表の所有者、表のタイプおよび索引付きの列のリストとともに表示されます。

1.7.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、索引に関する各種レポートを表示します。表1-4に、使用可能なすべてのビューを示します。

表1-4 索引に使用可能なビュー

ビュー

説明

オブジェクトの詳細

索引名、索引のタイプ、表の所有者、表名、表のタイプ、一意性、圧縮、接頭辞の長さ、表領域名、ステータス、最終解析および索引付きの列のリストを表示します。オブジェクトの詳細を表示しているときに実行できる操作は次のとおりです。

- 無効化 - 現行の索引を無効にします

- 削除: 現行の索引を削除します。

- 再ビルド - 現行の索引を再ビルドします

統計

行数、サンプル・サイズ、データの最終分析日時、圧縮ステータス(有効または無効)など、現行のビューに関して収集された統計を表示します。表示された統計をリフレッシュするには、「解析」をクリックします。

SQL

この索引の再作成に必要なSQLを表示します。

1.7.3 索引の削除

索引を削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「索引」を選択します。

3. 「オブジェクト選択」ペインから索引を選択します。

4. 「オブジェクトの詳細」の下の「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.8 順序の管理

順序は、データベース表の数値列に対して連続した一意の番号のリストを生成します。データベースの順序は、一般に、表の主キーの移入に使用されます。

内容は次のとおりです。

- 順序の作成

- 順序の参照

- 順序の削除

1.8.1 順序の作成

順序を作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「順序」を選択します。

4. 次の情報を指定し、「次へ」をクリックします。

- 順序名: 順序の名前を入力します。

- 大/小文字を保持: 最終的な順序名と「順序名」フィールドに入力した名前の大文字と小文字を一致させるには、「大/小文字を保持」をクリックします。

- 開始: 順序の最初の番号を入力します。sequence_name.nextvalの最初の参照では、この番号が戻されます。

- 最小値: この順序が戻すことができる最小値を入力します。

- 最大値: この順序が戻すことができる最大値を入力します。

- 増分: sequence_name.nextvalへの各コールは、最大値に達するまで、直前より大きい値を戻します。次の順序番号への増分値を入力します。

- サイクル: 順序番号が最大値に達した場合に最小値から再開するには、このオプションを選択します。主キーの作成に順序を使用する場合、この設定はお薦めできません。

- キャッシュする数: アクセスをより速くするために、順序値をメモリーに格納する数を指定します。

- 順序: 順序番号がリクエスト順に生成されることを保証するには、ORDERを指定します。Real Application Clusters(Oracle RAC)を使用する場合、このオプションは必須です。

確認ページが表示され、順序の作成に使用されるSQLが表示されます。

5. 「順序の作成」をクリックします。

1.8.2 順序の参照

順序を参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「順序」を選択します。

3. 「オブジェクト選択」ペインから順序を選択します。
「オブジェクトの詳細」ビューが表示されます。

1.8.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、順序に関する各種レポートを表示します。表1-5に、使用可能なすべてのビューを示します。

表1-5 順序に使用可能なビュー

ビュー

説明

オブジェクトの詳細

現行の順序の詳細を示します。このビューで実行できる操作は、「変更」と「削除」です。

権限付与

順序に関連付けられている権限付与のリストを表示します。権限付与の詳細には、権限受領者、権限、権限付与オプションが含まれます。実行できる操作は、「権限付与」と「取消し」です。

依存性

この順序を使用する(またはこれに依存する)オブジェクトのリストを表示します。

SQL

この順序の再作成に必要なSQLを表示します。

1.8.3 順序の削除

順序を削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「順序」を選択します。

3. 「オブジェクト選択」ペインから順序を選択します。
「オブジェクトの詳細」ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.9 タイプの管理

タイプは、ユーザー指定のオブジェクトまたはコレクションの定義です。Oracle Application Expressは現在、コレクションの定義のみをサポートしています。Oracleのコレクション(SQLコレクション)には、次の2つのカテゴリがあります。

- 可変長配列(VARRAY型)

- ネストした表(TABLE型)

VARRAY型は1次元配列に使用され、ネストした表のタイプは外部表内の単一列の表に使用されます。

内容は次のとおりです。

- タイプの作成

- タイプの参照

- タイプの削除

参照:
コレクション・タイプの詳細は、Oracle Database概要およびOracle Database PL/SQL言語リファレンスを参照してください

1.9.1 タイプの作成

コレクション・タイプを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「タイプ」を選択します。

4. 名前を指定し、「次へ」をクリックします。

5. タイプ、データ型、制限を選択し、「次へ」をクリックします。
確認ページが表示され、タイプの作成に使用されるSQLが表示されます。

6. 「タイプの作成」をクリックします。

1.9.2 タイプの参照

コレクション・タイプを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「タイプ」を選択します。

3. 「オブジェクト選択」ペインからタイプを選択します。
「オブジェクトの詳細」ビューが表示されます。

1.9.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、各種レポートを表示します。表1-6に、使用可能なすべてのビューを示します。

表1-6 タイプに使用可能なビュー

ビュー

説明

オブジェクトの詳細

選択したタイプの詳細を表示します。タイプを削除するには、「削除」をクリックします。

シノニム

現行のタイプのシノニムのリストを表示します。

権限付与

タイプに関連付けられている権限付与のリストを表示します。権限付与の詳細には、権限受領者、権限、権限付与オプションが含まれます。実行できる操作は、「権限付与」と「取消し」です。

SQL

このタイプの再作成に必要なSQLを表示します。

1.9.3 タイプの削除

コレクション・タイプを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「タイプ」を選択します。

3. 「オブジェクト選択」ペインからタイプを選択します。
「オブジェクトの詳細」ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.10 パッケージの管理

パッケージは、論理的に関連するPL/SQLタイプ、アイテム、ファンクションおよびプロシージャをグループ化するデータベース・オブジェクトです。通常、パッケージは仕様と本体の2つの部分で構成されます。仕様はアプリケーションへのインタフェースです。本体は仕様を実装します。

内容は次のとおりです。

- パッケージの作成

- パッケージの表示

- パッケージの編集

- パッケージのコンパイル

- パッケージのダウンロード

- パッケージの削除

参照:

- PL/SQLパッケージの詳細は、Oracle Database SQL言語リファレンスのPL/SQLパッケージを参照。

- PL/SQLサブプログラムの詳細は、Oracle Database SQL言語リファレンスのPL/SQLサブプログラムを参照

1.10.1 パッケージの作成

パッケージを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「パッケージ」を選択します。

4. 作成するパッケージのタイプを選択し、「次へ」をクリックします。

- 仕様部

- ボディ

- データベース表のメソッドを使用したパッケージ

5. 「仕様部」を選択した場合は、次のステップを実行します。

1. 名前を入力し、「次へ」をクリックします。
ウィザードによって、仮のパッケージ仕様部が作成され、編集用に表示されます。

2. 仕様部を編集し、「終了」をクリックします。

6. 「本体」を選択した場合は、次のステップを実行します。

1. 本体を作成するパッケージを選択し、「次へ」をクリックします。
ウィザードによって、中止されたコールが仕様部で識別された状態でパッケージの本体が作成され、編集用に表示されます。

2. パッケージ本体を編集し、「終了」をクリックします。

7. 「データベース表のメソッドを使用したパッケージ」を選択した場合は、次のステップを実行します。

1. 名前を入力し、「次へ」をクリックします。

2. 最大10個の表を選択して、「次へ」をクリックします。
ウィザードによって、選択した表に対する挿入、更新、削除およびGET APIを持つ仕様部および本体が作成されます。仕様部または本体は、表示またはダウンロードすることもできます。

3. 確定するには、「終了」をクリックします。

1.10.2 パッケージの表示

オブジェクト・ブラウザでパッケージにアクセスすると、仕様が表示されます。

仕様を表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。このビューからコードを編集することもできます。

1.10.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、パッケージに関する各種レポートを表示します。表1-7に、使用可能なすべてのビューを示します。

表1-7 パッケージに使用可能なビュー

ビュー

説明

仕様部

パッケージの仕様部を表示します。これは、アプリケーションのインタフェースを定義します。実行できる操作は次のとおりです。

- コードの手動編集

- 保存してコンパイル

- 検索して置換

- 元に戻す

- やり直し

- ソースのダウンロード

- 削除

ボディ

選択したパッケージに本体が存在する場合、パッケージ本体を表示します。実行できる操作は次のとおりです。

- コードの手動編集

- 保存してコンパイル

- 検索して置換

- 元に戻す

- やり直し

- ソースのダウンロード

- 削除

依存性

カレント・パッケージを使用する(またはこれに依存する)オブジェクトと、カレント・パッケージが依存するオブジェクトを表示します。

エラー

カレント・パッケージに関連するエラーを表示します。

権限付与

権限、権限受領者、権限付与可能者、権限付与者、オブジェクト名など、カレント・パッケージの権限付与の詳細を表示します。

1.10.3 パッケージの編集

パッケージを編集する際には、コードの手動編集、検索および置換の実行、パッケージのコンパイルが可能です。

1.10.3.1 パッケージの手動編集

パッケージを手動で編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。このビューでコードを編集できます。

4. 基本的な検索および置換を実行するには、「検索して置換」をクリックします。

1.10.4 パッケージのコンパイル

パッケージを編集および変更する場合は、変更内容を保存するためにコンパイルする必要があります。これはデータベース内のオブジェクトの単なるビューであるため、保存機能はありません。

パッケージをコンパイルするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。

4. 「保存してコンパイル」をクリックして現行のパッケージをコンパイルします。
コンパイルによりデータベースのオブジェクトが再作成されます。コンパイルが失敗すると、コードの上にエラー・メッセージが表示されます。

1.10.5 パッケージのダウンロード

パッケージをダウンロードするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。

4. 「ソースのダウンロード」をクリックすると、カレント・パッケージがファイルとして保存されます。

1.10.6 パッケージの削除

「仕様部」の表示中にパッケージを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

「ボディ」の表示中にパッケージを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「パッケージ」を選択します。

3. 「オブジェクト選択」ペインからパッケージを選択します。
仕様部が表示されます。

4. 「ボディ」タブをクリックします。

5. 「削除」をクリックします。

6. 確定するには、「終了」をクリックします。

1.11 プロシージャの管理

プロシージャは、特定のアクションを実行するサブプログラムです。オブジェクト・ブラウザを使用して、プロシージャを表示、作成、編集、ダウンロードおよび削除できます。

内容は次のとおりです。

- プロシージャの作成

- プロシージャの参照

- プロシージャの編集

- プロシージャのコンパイル

- プロシージャのダウンロード

- プロシージャの削除

参照:
Oracle Database PL/SQL言語リファレンス

1.11.1 プロシージャの作成

プロシージャを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「プロシージャ」を選択します。

4. プロシージャ名を入力し、「次へ」をクリックします。

5. 次の情報を指定して引数を定義します(オプション)。

- 引数名

- 入出力(パラメータ・モード)

- 引数のタイプ(データ型)

- デフォルト(値)

引数を追加するには、「引数の追加」をクリックします。

6. 「次へ」をクリックします。

7. プロシージャ本体として使用するPL/SQLブロックを入力し、「次へ」をクリックします。
確認ページが表示され、プロシージャの作成に使用されるSQLが表示されます。

8. 「プロシージャの作成」をクリックします。

1.11.2 プロシージャの参照

プロシージャを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「プロシージャ」を選択します。

3. 「オブジェクト選択」ペインからプロシージャを選択します。
「コード」ビューに、プロシージャのソース・コードが表示されます。このビューでコードを編集できます。

1.11.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、プロシージャに関する各種レポートを表示します。表1-8に、使用可能なすべてのビューを示します。

表1-8 プロシージャに使用可能なビュー

ビュー

説明

コード

(デフォルト)プロシージャのソース・コードを表示します。このビューでコードを編集できます。このビューで実行できる操作は次のとおりです。

- コードの手動編集

- 保存してコンパイル

- 検索して置換

- 元に戻す

- やり直し

- ソースのダウンロード

- 削除

参照: 「プロシージャの編集」、「プロシージャのコンパイル」、「プロシージャのダウンロード」および「プロシージャの削除」

依存性

カレント・プロシージャを使用する(またはこれに依存する)オブジェクトと、プロシージャが依存するオブジェクトを表示します。

エラー

カレント・プロシージャに関連するエラーを表示します。

権限付与

権限、権限受領者、権限付与可能者、権限付与者、オブジェクト名など、カレント・プロシージャの権限付与の詳細を表示します。

1.11.3 プロシージャの編集

プロシージャを編集する際には、コードの手動編集、検索および置換の実行が可能です。

1.11.3.1 プロシージャの手動編集

プロシージャを手動で編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「プロシージャ」を選択します。

3. 「オブジェクト選択」ペインからプロシージャを選択します。
「コード」ビューが表示されます。このビューでコードを編集できます。

4. 基本的な検索および置換を実行するには、「検索して置換」をクリックします。

1.11.4 プロシージャのコンパイル

プロシージャを編集および変更する場合は、変更内容を保存するためにコンパイルする必要があります。これはデータベース内のオブジェクトの単なるビューであるため、保存機能はありません。

プロシージャをコンパイルするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「プロシージャ」を選択します。

3. 「オブジェクト選択」ペインからプロシージャを選択します。

4. 「保存してコンパイル」をクリックして現行のプロシージャをコンパイルします。
コンパイルによりデータベースのオブジェクトが再作成されます。コンパイルが失敗すると、コードの上にエラー・メッセージが表示されます。

1.11.5 プロシージャのダウンロード

プロシージャをダウンロードするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「プロシージャ」を選択します。

3. 「オブジェクト選択」ペインからプロシージャを選択します。

4. 「ソースのダウンロード」をクリックすると、カレント・プロシージャがファイルとして保存されます。

1.11.6 プロシージャの削除

プロシージャを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「プロシージャ」を選択します。

3. 「オブジェクト選択」ペインからプロシージャを選択します。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.12 ファンクションの管理

ファンクションは、パラメータを取ることができ、単一値を戻すサブプログラムです。

内容は次のとおりです。

- ファンクションの作成

- ファンクションの参照

- ファンクションの編集

- ファンクションのコンパイル

- ファンクションのダウンロード

- ファンクションの削除

参照:
Oracle Database SQL言語リファレンス(PL/SQLファンクションの詳細)およびOracle Database PL/SQL言語リファレンス

1.12.1 ファンクションの作成

ファンクションを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「ファンクション」を選択します。

4. ファンクション名を入力し、戻りデータ型を指定して、「次へ」をクリックします。

5. 引数を定義して、「次へ」をクリックします(オプション)。

- 引数名

- 引数のタイプ(データ型)

- デフォルト(値)

引数を追加するには、「引数の追加」をクリックします。

6. ファンクション本体として使用するPL/SQLブロックを入力し、「次へ」をクリックします。
確認ページが表示され、ファンクションの作成に使用されるSQLが表示されます。

7. 「ファンクションの作成」をクリックします。

1.12.2 ファンクションの参照

オブジェクト・ブラウザでファンクションを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ファンクション」を選択します。

3. 「オブジェクト選択」ペインからファンクションを選択します。
「コード」ビューが表示されます。このビューでコードを編集できます。

1.12.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、ファンクションに関する各種レポートを表示します。表1-9に、使用可能なすべてのビューを示します。

表1-9 ファンクションに使用可能なビュー

ビュー

説明

コード

(デフォルト)ファンクションのソース・コードを表示します。このビューでコードを編集できます。このビューで実行できる操作は次のとおりです。

- コードの手動編集

- 保存してコンパイル

- 検索して置換

- 元に戻す

- やり直し

- ソースのダウンロード

- 削除

参照: 「ファンクションの編集」、「ファンクションのコンパイル」、「ファンクションのダウンロード」および「ファンクションの削除」

依存性

カレント・ファンクションで使用する(またはこれに依存する)オブジェクトと、カレント・ファンクションが依存するオブジェクトを表示します。

エラー

カレント・ファンクションに関連するエラーを表示します。

権限付与

権限、権限受領者、権限付与可能者、権限付与者、オブジェクト名など、カレント・ファンクションの権限付与の詳細を表示します。

1.12.3 ファンクションの編集

ファンクションを編集する際には、コードの手動編集、検索および置換の実行、ファンクションのコンパイルが可能です。

1.12.3.1 ファンクションの手動編集

ファンクションを手動で編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ファンクション」を選択します。

3. 「オブジェクト選択」ペインからファンクションを選択します。
「コード」ビューが表示されます。このビューでコードを編集できます。

4. 手動編集モードを有効にするには、「編集」をクリックします。

5. 基本的な検索および置換を実行するには、「検索して置換」をクリックします。

1.12.4 ファンクションのコンパイル

ファンクションを編集および変更する場合は、変更内容を保存するためにコンパイルする必要があります。これはデータベース内のオブジェクトの単なるビューであるため、保存機能はありません。

オブジェクト・ブラウザでファンクションをコンパイルするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ファンクション」を選択します。

3. 「オブジェクト選択」ペインからファンクションを選択します。
「コード」ビューが表示されます。

4. 「保存してコンパイル」をクリックして現行のファンクションをコンパイルします。
コンパイルによりデータベースのオブジェクトが再作成されます。コンパイルが失敗すると、コードの上にエラー・メッセージが表示されます。

1.12.5 ファンクションのダウンロード

オブジェクト・ブラウザでファンクションをファイルに保存するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ファンクション」を選択します。

3. 「オブジェクト選択」ペインからファンクションを選択します。
「コード」ビューが表示されます。

4. 「ソースのダウンロード」をクリックすると、カレント・ファンクションがファイルとして保存されます。

1.12.6 ファンクションの削除

オブジェクト・ブラウザでファンクションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「ファンクション」を選択します。

3. 「オブジェクト選択」ペインからファンクションを選択します。
「コード」ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.13 トリガーの管理

データベース・トリガーは、データベースの表、ビューまたはイベントに関連付けられているストアド・サブプログラムです。トリガーは、イベントが発生したときなどに1回コールするか、INSERT、UPDATEまたはDELETE文の影響を受ける各行などに対して複数回コールすることができます。

内容は次のとおりです。

- トリガーの作成

- トリガーの参照

- トリガーの編集

- トリガーのコンパイル

- トリガーのダウンロード

- トリガーの削除

参照:

- Oracle Database概要

- Oracle Database開発ガイド

1.13.1 トリガーの作成

オブジェクト・ブラウザでトリガーを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「トリガー」を選択します。

4. 表名を選択して、「次へ」をクリックします。

5. 適切なトリガーの属性を選択し、トリガー本体を入力して「次へ」をクリックします。
確認ページが表示され、トリガーの作成に使用されるSQLが表示されます。

6. 「トリガーの作成」をクリックします。

1.13.2 トリガーの参照

オブジェクト・ブラウザでトリガーを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「トリガー」を選択します。

3. 「オブジェクト選択」ペインからトリガーを選択します。
「オブジェクトの詳細」ビューが表示されます。

1.13.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、トリガーに関する各種レポートを表示します。表1-10に、使用可能なすべてのビューを示します。

表1-10 トリガーに使用可能なビュー

ビュー

説明

オブジェクトの詳細

(デフォルト)カレント・トリガーの詳細を示します。実行できる操作は次のとおりです。

- コンパイル

- ダウンロード

- 削除

- 無効化

コード

トリガーのソース・コードを表示します。このビューでコードを編集できます。このビューで実行できる操作は次のとおりです。

- コードの手動編集

- 保存してコンパイル

- 検索して置換

- 元に戻す

- やり直し

- ソースのダウンロード

- 削除

参照: 「トリガーの編集」、「トリガーのコンパイル」、「トリガーのダウンロード」および「トリガーの削除」

エラー

カレント・トリガーに関連するエラーを表示します。

SQL

トリガーの再作成に必要なSQLを表示します。

1.13.3 トリガーの編集

トリガーを編集する際には、コードの手動編集、検索および置換の実行、トリガーのコンパイルが可能です。

1.13.3.1 トリガーの手動編集

トリガーを手動で編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「トリガー」を選択します。

3. 「オブジェクト選択」ペインからトリガーを選択します。
「コード」ビューが表示されます。このビューでコードを編集できます。

4. 基本的な検索および置換を実行するには、「検索して置換」をクリックします。

1.13.4 トリガーのコンパイル

ファンクションを編集および変更する場合は、変更内容を保存するためにコンパイルする必要があります。これはデータベース内のオブジェクトの単なるビューであるため、保存機能はありません。コンパイルによりデータベースのオブジェクトが再作成されます。

オブジェクト・ブラウザでトリガーをコンパイルするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「トリガー」を選択します。

3. 「オブジェクト選択」ペインからトリガーを選択します。
「詳細」ビューが表示されます。

4. 現行トリガーをコンパイルするには:

- 「オブジェクトの詳細」の下の「コンパイル」をクリックします。

- 「コード」の下の「保存してコンパイル」をクリックします。

コンパイルが失敗すると、コードの上にエラー・メッセージが表示されます。

1.13.5 トリガーのダウンロード

現行のトリガーをファイルとして保存するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「トリガー」を選択します。

3. 「オブジェクト選択」ペインからトリガーを選択します。
「詳細」ビューが表示されます。

4. 「ソースのダウンロード」をクリックすると、カレント・トリガーがファイルとして保存されます。

5. 現行トリガーをダウンロードするには次のステップを実行します。

- 「オブジェクトの詳細」の下の「ダウンロード」をクリックします。

- 「コード」の下の「ソースのダウンロード」をクリックします。

コンパイルが失敗すると、コードの上にエラー・メッセージが表示されます。

1.13.6 トリガーの削除

オブジェクト・ブラウザでトリガーを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「トリガー」を選択します。

3. 「オブジェクト選択」ペインからトリガーを選択します。
「詳細」ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.14 データベース・リンクの管理

データベース・リンクは1つのデータベースのスキーマ・オブジェクトであり、これを使用すると、別のデータベース上のオブジェクトにアクセスできます。データベース・リンクを作成した後、表またはビューの名前の末尾に@dblinkを追加すると、リモート・オブジェクトにアクセスできます。dblinkはデータベース・リンクの名前です。

内容は次のとおりです。

- データベース・リンクの作成

- データベース・リンクの参照

- データベース・リンクの削除

1.14.1 データベース・リンクの作成

データベース・リンクを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「データベース・リンク」を選択します。

4. 次の情報を指定し、「次へ」をクリックします。

- データベース・リンク名

- スキーマへの接続

- パスワード

- リモート・ホスト名またはIP

- リモート・ホストのポート

- SIDまたはサービス名

確認ページが表示されます。

5. 「作成」をクリックします。

1.14.2 データベース・リンクの参照

データベース・リンクを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「データベース・リンク」を選択します。

3. 「オブジェクト選択」ペインから、データベース・リンクを選択します。
「オブジェクトの詳細」ビューが表示されます。

1.14.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、データベース・リンクに関する各種レポートを表示します。表1-11に、使用可能なすべてのビューを示します。

表1-11 データベース・リンクに使用可能なビュー

ビュー

説明

オブジェクトの詳細

(デフォルト)データベース・リンクの詳細を示します。実行できる操作は次のとおりです。

- 削除: データベース・リンクを削除します。

- テスト - データベース・リンクをテストします

依存性

このデータベース・リンクを使用する(またはこれに依存する)オブジェクトのリストを表示します。

SQL

このデータベース・リンクの再作成に必要なSQLを表示します。

1.14.3 データベース・リンクの削除

オブジェクト・ブラウザでデータベース・リンクを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「データベース・リンク」を選択します。

3. 「オブジェクト選択」ペインから、データベース・リンクを選択します。
「オブジェクトの詳細」ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.15 マテリアライズド・ビューの管理

マテリアライズド・ビューは、問合せの結果を別のスキーマ・オブジェクトに格納して、表データへの間接的なアクセスを提供します。記憶域を占有せず、データが含まれない通常のビューと異なり、マテリアライズド・ビューには、1つ以上の実表またはビューに対する問合せの結果生成される行が含まれます。マテリアライズド・ビューはその実表と同じデータベースまたは別のデータベースに格納できます。

マテリアライズド・ビューは、パフォーマンス向上のためによく使用されます。特にソースがデータベース・リンクを使用している表またはビューであるデータを、ローカルに格納する場合に使用されます。同様に、大規模な計算または要約がある場合、特にデータ・セットが非常に大きい場合に、ビューのかわりにマテリアライズド・ビューがよく使用されます。マテリアライズド・ビューは指定した間隔でリフレッシュされます。これは、データが必ずしも最新ではないことを意味していますが、マテリアライズド・ビューに対する問合せは前述の例については非常に高速になります。

内容は次のとおりです。

- マテリアライズド・ビューの作成

- マテリアライズド・ビューの参照

- マテリアライズド・ビューの削除

参照:
マテリアライズド・ビューについては、Oracle Database概要を参照してください

1.15.1 マテリアライズド・ビューの作成

マテリアライズド・ビューを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「マテリアライズド・ビュー」を選択します。

4. マテリアライズド・ビューを定義します。

1. マテリアライズド・ビュー名: 名前を入力します。

2. 問合せ: ビューを定義する問合せを指定します。
クエリー・ビルダーまたはSQLコマンド・プロセッサにアクセスするには、ページ下部の該当するリンクをクリックします。選択したツールがポップアップ・ウィンドウに表示されます。該当するSQLが生成されたら、「戻る」をクリックします。ポップアップ・ウィンドウが自動的に閉じ、SQLとともにウィザードに戻ります。

3. 「次へ」をクリックします。
確認ページが表示され、マテリアライズド・ビューの作成に使用されるSQLが表示されます。

5. 「マテリアライズド・ビューの作成」をクリックします。

参照:
「SQLクエリー・ビルダーを使用した問合せの構築」および「「SQLコマンド」の使用」

1.15.2 マテリアライズド・ビューの参照

マテリアライズド・ビューを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「マテリアライズド・ビュー」を選択します。

3. 「オブジェクト選択」ペインからビューを選択します。
マテリアライズド・ビューが表示されます。

1.15.2.1 使用可能なビューのまとめ

ページ上部のタブをクリックして、マテリアライズド・ビューに関する各種レポートを表示します。表1-12に、使用可能なすべてのビューを示します。

表1-12 マテリアライズド・ビューに使用可能なビュー

ビュー

説明

マテリアライズド・ビュー

(デフォルト)マテリアライズド・ビュー内の列について、次の詳細を表示します。

- 列名

- データ型

- NULL値可能フラグ

- デフォルト値

- 主キー

「削除」をクリックすると、カレント・マテリアライズド・ビューが削除されます。

データ

列内のデータのレポートを表示します。実行できる操作は次のとおりです。

- 問合せ - 列によるソートができます。特定の行を制限するには、「列条件」フィールドに条件を入力します。ワイルドカードにはパーセント記号(%)を使用します。「並替え基準」から、確認する列を選択して「問合せ」をクリックします。

- 行をカウント - 現行の表のデータのレポートを表示します。

- ダウンロード: このリンクをクリックして、データをカンマ区切り(.csv)ファイルとしてエクスポートします。

詳細

DBA_SNAPSHOTSに格納されているオブジェクトの詳細(更新可能かどうか、ステータスなど)を表示します。

権限付与

権限受領者、権限、権限付与オプションなど、現行のビューに関する権限付与のリストを表示します。このビューで実行できる操作は、「権限付与」および「取消し」です。

依存性

このマテリアライズド・ビューを使用する(またはこれに依存する)オブジェクトのリストを表示します。

SQL

このマテリアライズド・ビューの再作成に必要なSQLを表示します。

1.15.3 マテリアライズド・ビューの削除

オブジェクト・ブラウザでマテリアライズド・ビューを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「マテリアライズド・ビュー」を選択します。

3. 「オブジェクト選択」ペインからビューを選択します。
マテリアライズド・ビューが表示されます。

4. 「削除」をクリックします。

5. 確定するには、「終了」をクリックします。

1.16 シノニムの管理

シノニムは、スキーマ・オブジェクトの別名です。シノニムは、オブジェクトの名前および所有者をマスキングし、分散データベースのリモート・オブジェクトに対する位置の透過性を提供することで、一定レベルのセキュリティを提供できます。また、データベース・ユーザーにとって、シノニムは使いやすく、SQL文の複雑さが軽減されます。

内容は次のとおりです。

- シノニムの作成

- シノニムの表示

- シノニムの削除

参照:
シノニムについては、Oracle Database管理者ガイドを参照してください

1.16.1 シノニムの作成

シノニムを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. オブジェクト・タイプのリストから、「シノニム」を選択します。

4. シノニムを定義します。

1. シノニム名: 名前を入力します。

2. パブリックまたはプライベート: シノニムをパブリックにするか、プライベートにするかを指定します。

3. スキーマ: シノニムを作成するオブジェクトを所有するデータベース・スキーマ(またはユーザー名)を選択します。

4. オブジェクト: シノニムを作成するオブジェクトの名前を入力します。

5. データベース・リンク: リモート・オブジェクトに対してシノニムを作成する場合に使用するデータベース・リンクの名前を入力します。

6. 「次へ」をクリックします。

確認ページが表示され、シノニムの作成に使用されるSQLが表示されます。

5. 「シノニムの作成」をクリックします。

1.16.2 シノニムの表示

シノニムを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「シノニム」を選択します。

3. 「オブジェクト選択」ペインからシノニムを選択します。
「オブジェクトの詳細」ビューに、次の項目が表示されます。

- シノニム所有者

- シノニム名

- オブジェクト所有者

- オブジェクト名

- オブジェクト・タイプ

- ステータス

1.16.3 シノニムの削除

オブジェクト・ブラウザでシノニムを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「シノニム」を選択します。

3. 「オブジェクト選択」ペインからシノニムを選択し、「削除」をクリックします。

4. 確定するには、「終了」をクリックします。

2 SQLコマンドの使用

このセクションでは、SQLコマンドを使用してSQLコマンドを作成、編集、表示、実行および削除する方法について説明します。

内容は次のとおりです。

- 「SQLコマンド」の概要

- 「SQLコマンド」へのアクセス

- 「SQLコマンド」ホームページについて

- コマンド・エディタの使用

- SQLコマンドの保存

- コマンドのコピー

- 結果の表示

- 実行計画の使用

- 保存されたコマンドの使用

- SQLコマンド履歴の使用

参照:

- SQL文およびその他のSQLの詳細(演算子、ファンクションおよび書式モデルなど)は、Oracle Database SQL言語リファレンスを参照してください

- SQLの概念については、Oracle Database概要を参照してください

- SQL*Plus(OracleバージョンのSQL)の詳細は、SQL*Plusユーザーズ・ガイドおよびリファレンスを参照してください

- この章の例で使用されているHRサンプル・スキーマの詳細は、Oracle Databaseサンプル・スキーマを参照してください

2.1 「SQLコマンド」の概要

データベース・オブジェクトの作成、編集、表示、実行および削除には、SQLコマンドを使用できます。SQLコマンドには、SQL文またはPL/SQLブロックを含めることができます。

「SQLコマンド」を使用する場合は、次の点に注意してください。

- クエリー・ビルダーで作成したSQLコマンドは、「SQLコマンド」からアクセスできます。

- 保存されたSQLコマンドには、指定されたワークスペース内で一意の名前が付いている必要があります。

- 「SQLコマンド」と「SQLスクリプト」の間の対話はありません。

- 「SQLコマンド」からSQLコマンドをカット・アンド・ペーストしてSQLスクリプト・エディタで実行できます。

参照:
「SQLスクリプトの使用」

2.2 「SQLコマンド」へのアクセス

「SQLコマンド」にアクセスするには、次のステップを実行します。

1. ワークスペースのホームページにログインします。
ワークスペースのホームページが表示されます。

2. 「SQLワークショップ」をクリックします。

3. 「SQLコマンド」をクリックします。
図sql_c.gifの説明

「SQLコマンド」ホームページが表示されます。

注意:
インスタンス管理者がこのApplication Expressインスタンスに対してRESTfulサービスを無効にしている場合、このインスタンスでRESTfulサービスが使用できないため、RESTfulサービス・アイコンが表示されません。『Oracle Application Express管理ガイド』のSQLワークショップの構成に関する説明を参照してください。

2.3 「SQLコマンド」ホームページについて

「SQLコマンド」ホームページはコマンド・エディタおよび表示ペインの2つのセクションに分かれます。コマンド・エディタを使用するとSQLコマンドが実行され、表示ペインには出力、保存されたコマンドのリストおよび履歴リストが表示されます。

図sql_c_top.gifの説明

「SQLコマンド」ホームページの上部にはコマンド・エディタおよび次のコントロールがあります。

- 自動コミット: 「自動コミット」チェック・ボックスが利用可能な場合は、このチェック・ボックスをクリックして自動コミットを有効化し、トランザクション・コマンドを無効化します。「「SQLコマンド」のトランザクションについて」を参照してください。

- 行: 「表示」リストから、同時に表示する出力の行数(最大100,000行)を選択します。「表示」リストの設定に関係なく、DBMS出力のすべての行が表示されます。

- 「コマンドのクリア」アイコン: 「コマンドのクリア」アイコンは消しゴム付きの鉛筆の形をしています。このアイコンを使用するとコマンド・エディタ内のテキストがクリアされます。

- 「表の検索」アイコン: 「表の検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、現在選択しているスキーマ内の表を表示できます。「「表の検索」アイコンの使用」を参照してください。

- 保存: 「保存」ボタンをクリックするとコマンド・エディタのコンテンツ、またはファイルで現在ハイライトされているコンテンツが保存されます。名前および説明(オプション)を入力するよう求められます。「保存されたSQL」リストにコマンドが表示されます。「SQLコマンドの保存」を参照してください。

- 実行: 「実行」ボタンをクリックすると、コマンド・エディタ内のコマンド、または現在コマンド・エディタでハイライトされているコマンドが実行されます。「SQLコマンドの実行」を参照してください。

参照:
「コマンド・エディタの使用」

表示ペインは、「SQLコマンド」ホームページの下部にあり、次の5つのタブを備えています。

- 結果:「結果」タブをクリックして、最後に正常に実行されたSQLコマンドからの結果を表示します。表示された結果の下部にある「DBMS出力」をクリックして、DBMS出力の行を表示します。このコントロールは、表示するDBMS出力がある場合にのみ表示されます。「ダウンロード」をクリックして、結果をローカル・ファイルシステムのカンマ区切りファイルにエクスポートします。「結果の表示」を参照してください。

- 実行計画:「実行計画」タブをクリックして、オプティマイザで使用される実行計画を調べ、データベースに変更を加える文がないかどうかを確認します。出力内のオブジェクトはオブジェクト・ブラウザにリンクされています。リンクされたオブジェクトをクリックして、そのオブジェクトのプロパティをオブジェクト・ブラウザに表示します。「実行計画の使用」を参照してください。

- 説明:「説明」タブで、Describe object_nameと入力して「実行」をクリックし、表またはビューの列定義を表示するか、あるいはファンクションまたはプロシージャの仕様を表示します。「説明」に表示されたリンクを選択して、その情報をコマンド・エディタに書き込みます。たとえば、owner.tableを追加するには表名を、列名を追加するには列名を、パラメータを持つオブジェクト・コールを追加するにはプロシージャ名またはファンクション名を、パッケージ・コールを追加するにはパッケージ名をクリックします。

- 保存されたSQL:「保存されたSQL」タブをクリックして、現行のワークスペースに保存されたすべてのSQLコマンドのリストを表示します。コマンドのタイトルをクリックして、そのコマンドをコマンド・エディタにロードします。「保存されたコマンドの使用」を参照してください

- 履歴:「履歴」タブをクリックして、最近実行されたコマンドのリストを表示します。最後に実行された200のコマンドが保存されています。「SQLコマンド履歴の使用」を参照してください。

スキーマの選択

スキーマはデータベース・オブジェクトの論理的なコンテナです。別のスキーマのオブジェクトにアクセスするには、SQLワークショップのホームページで「スキーマ」リストから選択します。自分のワークスペースに割り当てられたスキーマのみがリストされます。

別のSQLワークショップ・コンポーネントへの切替え

ページの右上にある「コンポーネント」リストから選択を行い、別のSQLワークショップ・コンポーネントにナビゲートできます。

図obj_b_icons.gifの説明

次の使用可能なアイコンがあります。

- オブジェクト・ブラウザ: 「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

- SQLコマンド: 「SQLコマンドの使用」を参照してください。

- SQLスクリプト: 「SQLスクリプトの使用」を参照してください。

- クエリー・ビルダー: 「SQLクエリー・ビルダーを使用した問合せの構築」を参照してください。

- ユーティリティ: 「Oracle Application Expressユーティリティの使用」を参照してください。

- RESTfulサービス: 「RESTfulサービスへのアクセス」を参照してください。

- ヘルプ。

2.4 コマンド・エディタの使用

SQLコマンドのコマンド・エディタを使用して、Oracle Application Express内でSQLコマンドを実行します。

内容は次のとおりです。

- SQLコマンドの実行

- 「SQLコマンド」のトランザクションについて

- サポートされていないSQL*Plusコマンドについて

- コマンドの終了について

- バインド変数の使用

- 「表の検索」アイコンの使用

参照:
「「SQLコマンド」ホームページについて」

2.4.1 SQLコマンドの実行

SQLコマンドを実行するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 実行するSQLコマンドをコマンド・エディタに入力します。

3. 「実行」([Ctrl]+[Enter])をクリックして、コマンドを実行します。

ヒント:
特定の文を実行する場合は、実行する文を選択して「実行」をクリックします。

「結果」ペインに結果が表示されます。

4. 結果レポートをカンマ区切り(.csv)としてエクスポートするには、「ダウンロード」リンクをクリックしてください。

参照:
「「結果」ペインについて」、「「SQLコマンド」のトランザクションについて」、「サポートされていないSQL*Plusコマンドについて」、「コマンドの終了について」および「バインド変数の使用」

2.4.2 SQLコマンドのトランザクションについて

「SQLコマンド」でトランザクションSQLコマンドを無効にするには、「自動コミット」チェック・ボックスを選択します。トランザクション・モードが無効になっている場合にCOMMIT、ROLLBACKなどのトランザクションSQLコマンドを使用しようとすると、エラー・メッセージが戻されます。

トランザクションSQLコマンドを有効にするには、「自動コミット」チェック・ボックスを選択解除します。Oracle Application Expressは、トランザクション・モードに入る前に、必要なシステム・リソースが使用可能であることを確認します。リソースが使用できない場合は、エラー・メッセージが表示されます。

トランザクション・モードは、更新の実行、確認するデータの選択、COMMITまたはROLLBACKの変更などを行うことができるステートフルなトランザクション・モードです。このモードは、DBMS_JOBSを使用して実装されます。

トランザクション・モードの次の動作を考慮してください。

- 明示的なCOMMITコマンドを入力するまで操作はデータベースにコミットされません。

- カレント・トランザクションは、「SQLコマンド」を終了すると終了し、ロールバックされます。

- カレント・トランザクションは、セッション・タイムアウトにより終了し、ロールバックされます。
環境設定(「SQLコマンドの最大停止時間」)で非アクティブ・セッションがタイムアウトするまでの時間が設定されることに注意してください。デフォルトのタイムアウトは60秒です。Oracle Application Express管理ガイドの「SQLワークショップの構成」を参照してください。

- 「CSVのエクスポート」オプションは使用できません。

参照:
「SQLコマンドの実行」、「「SQLコマンド」のトランザクションについて」、「サポートされていないSQL*Plusコマンドについて」および「バインド変数の使用」

2.4.3 サポートされていないSQL*Plusコマンドについて

SQLコマンドではSQL*Plusコマンドをサポートしていません。SET ECHOやDEFINEなどのSQLコマンドラインのコマンドをSQLコマンドに入力しようとすると、エラー・メッセージが表示されます。

参照:
「SQLコマンドの実行」、「「SQLコマンド」のトランザクションについて」、「サポートされていないSQL*Plusコマンドについて」および「バインド変数の使用」

2.4.4 コマンドの終了について

「SQLコマンド」では、セミコロン(;)またはスラッシュ(/)を使用するか、あるいは何も付けずにコマンドを終了できます。次に、有効な選択肢を示します。

SELECT * from emp;

SELECT * from emp
/

SELECT * from emp

最初の例ではセミコロン(;)、2番目の例ではスラッシュ(/)を使用しています。最後の例では、終了記号が付いていないコマンドを示しています。

参照:
「SQLコマンドの実行」、「「SQLコマンド」のトランザクションについて」、「サポートされていないSQL*Plusコマンドについて」および「バインド変数の使用」

2.4.5 バインド変数の使用

バインド変数がサポートされています。コマンドの実行時に、バインド変数の値を入力するよう求められます。バインド変数の前にはコロンを付けます。

次に例を示します。

SELECT * FROM emp WHERE deptno = :dept

次のSQLコマンドを実行してワークスペースIDを確認します。

SELECT v('WORKSPACE_ID') FROM dual

参照:
「SQLコマンドの実行」、「「SQLコマンド」のトランザクションについて」、「サポートされていないSQL*Plusコマンドについて」および「バインド変数の使用」

2.4.6 「表の検索」アイコンの使用

「表の検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、現在選択しているスキーマ内の表を表示できます。

図wrkshp_find_tables.gifの説明

現在のスキーマ内の表を表示するには、次のステップを実行します。

1. 「SQLコマンド」にナビゲートします。

2. 「スキーマ」リストから、スキーマを選択します(オプション)。

3. 「表の検索」アイコンをクリックします。
「表ファインダ」が表示されます。選択されたスキーマを表示するナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 検索:表名を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべての表を表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- ビュー:生成されるレポートにビューを含めるには、「ビュー」チェック・ボックスを選択して「実行」をクリックします。

- 行:生成されるレポートに表示する行数を指定します。表示する行数を変更するには、リストから選択して「実行」をクリックします。

表ファインダ・レポートが表示され、その中には表名、行数、最新分析日およびオブジェクト・タイプが含まれます。

4. 表名を選択します。
表ファインダ・レポートが表示されます。

図table_finder.gifの説明

このレポートには列名、データ型、長さ、精度およびスケールが表示され、ページ下部には表を再作成するために必要なSQLが表示されます。

5. このページからコマンド・エディタ内の既存のコマンドにSQLを追加するには、「追加」をクリックします。コマンド・エディタ内の既存のコマンドをこのページのSQLで置換するには、「置換」をクリックします。

2.5 SQLコマンドの保存

「SQLコマンド」で入力したコマンドを保存できます。

SQLコマンドを保存するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. コマンド・エディタにコマンドを入力します。

3. 「保存」をクリックして、コマンドを保存します。
コマンドの名前と説明を入力するよう求められます。

4. 「保存」をクリックするか、または「取消」をクリックして保存せずにコマンド・エディタに戻ります。
保存されたコマンドが表示領域に表示されます。

2.6 コマンドのコピー

SQLコマンドをコピーするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 「保存されたSQL」をクリックします。
コマンドの「保存されたSQL」リストが表示ペインに表示されます。

3. コマンドの名前をクリックして、コマンド・エディタにロードします。

4. 「保存」をクリックして、コマンドを保存します。

5. コマンドの名前を「名前」フィールドに入力して、「保存」をクリックします。
コマンドが新しい名前にコピーされます。

2.7 結果の表示

SQLコマンドを実行すると、結果が表示されます。最後に実行されたコマンドの結果は、別のSQLコマンドを実行するか、「SQLコマンド」を終了するまで入手可能です。

内容は次のとおりです。

- 「結果」ペインへのアクセス

- 「結果」ペインについて

2.7.1 「結果」ペインへのアクセス

SQLコマンドの結果を表示するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 「結果」タブをクリックします。
表示ペインに、HTML形式で結果が表示されます。

3. 「DBMS出力」をクリックして、プレーン・テキストでDBMS出力の結果を表示します。
DBMS出力結果がある場合にのみ、「DBMS出力」コントロールが表示されます。

2.7.2 「結果」ペインについて

「結果」ペインには、SQLコマンドの結果がHTML形式の表として表示されます。出力の後に、戻された行数とかかった時間が表示されます。DBMS出力は、HTML形式の結果の後にプレーン・テキストとして表示されます。

図proc_results.gifの説明

「結果」ペインでは、次の操作を実行できます。

- DBMS出力の表示。入力されたSQLコマンド、SQLまたはPL/SQLブロックのタイプに応じてHTML出力またはDBMS出力が自動的に表示されます。

- 結果のエクスポート。「ダウンロード」をクリックして、結果をローカル・ファイルシステムのカンマ区切りファイルにエクスポートします。ファイルの名前とディレクトリを入力するよう要求されます。HTML出力の場合にのみ使用できます。

参照:
「「結果」ペインへのアクセス」

2.8 実行計画の使用

OracleオプティマイザでSQLコマンドを実行するために使用する実行計画を表示できます。実行計画を表示するためにコマンドを実行する必要はありません。

内容は次のとおりです。

- 実行計画の表示

- 「実行計画」ペインについて

2.8.1 実行計画の表示

実行計画を表示するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 表示する計画を持つコマンドを入力またはロードします。

3. 「実行計画」タブをクリックします。
表示ペインに、オプティマイザに使用される実行計画が表示されます。

2.8.2 「実行計画」ペインについて

「実行計画」ペインに、OracleオプティマイザでSQLコマンドを実行するために使用する計画が表示されます。このペインには、通常、使用される問合せ計画、索引列および表列が表示されます。

図explain_tab.gifの説明

「実行計画」ペインでは、次の操作を実行できます。

- オブジェクト定義の表示。問合せ計画内のオブジェクト名をクリックして、そのオブジェクトの定義をオブジェクト・ブラウザに表示します。

- 索引定義の表示。表の列内の索引名をクリックして、その索引の定義をオブジェクト・ブラウザに表示します。

2.9 保存されたコマンドの使用

自分が保存したコマンドや、同じワークスペース内の他のユーザーが保存したコマンドにアクセスできます。また、クエリー・ビルダーから、自分が保存したSQLコマンドまたは同じワークスペース内の他のユーザーが保存したSQLコマンドにアクセスすることもできます。

内容は次のとおりです。

- 保存されたコマンドへのアクセス

- 「保存されたSQL」ペインについて

2.9.1 保存されたコマンドへのアクセス

保存されたSQLコマンドにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 「保存されたSQL」タブをクリックします。
コマンドの「保存されたSQL」リストが表示ペインに表示されます。

3. コマンドのタイトルをクリックして、そのコマンドをコマンド・エディタにロードします。
エディタにコマンドが表示されます。

4. 「実行」をクリックして、コマンドを実行します。

参照:
「「保存されたSQL」ペインについて」

2.9.2 「保存されたSQL」ペインについて

「保存されたSQL」ペインには、現行のワークスペースに保存されたすべてのコマンドのリストが表示されます。このリストには、「SQLコマンド」から保存されたコマンドとクエリー・ビルダーから保存されたSQLコマンドが表示されます。保存するSQLコマンドには、現行のワークスペース内で一意の名前を指定する必要があります。クエリー・ビルダーと「SQLコマンド」で同じ名前を使用することはできません。

各コマンド・エントリには、所有者名、コマンド名、説明が存在する場合はその説明、SQLコマンドの最初の文字、およびそのコマンドの最終更新者名と最終更新日時が示されます。

図sql_hist.gifの説明

「保存されたSQL」ペインでは、次の操作を実行できます。

- 所有者別のコマンドの表示。「所有者」リストから、表示するコマンドを所有するユーザーを選択して指定します。すべてのスクリプトを表示するには、「-すべてのユーザー-」を選択します。

- コマンドの検索。「検索」フィールドにコマンドの名前または名前の一部、あるいはコード・スニペットを入力して、「実行」をクリックします。すべてのスクリプトを表示するには、「検索」フィールドを空のままにして「実行」をクリックします。「行」リストから選択して、表示する行数を制御します。

- 出力行数の設定。「表示」リストから、同時に表示する保存されたSQLコマンドの数を選択して指定します。

- コマンドの削除。コマンドに関連付けられたチェック・ボックスを選択し、「チェックした項目の削除」をクリックします。

2.10 SQLコマンド履歴の使用

実行したコマンドは、明示的に保存するかどうかに関係なく、コマンド履歴に格納されます。SQLコマンドの履歴を使用して、「SQLコマンド」で実行したコマンドにアクセスします。

内容は次のとおりです。

- コマンド履歴からのコマンドへのアクセス

- 「履歴」ペインについて

2.10.1 コマンド履歴からのコマンドへのアクセス

履歴のコマンドにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLコマンド」の順にクリックします。
SQLコマンド・ページが表示されます。

2. 「履歴」タブをクリックします。
「履歴」のコマンドのリストが表示ペインに表示されます。

3. SQL列に表示されているコマンドの一部をクリックします。
エディタにコマンドが表示されます。

2.10.2 「履歴」ペインについて

「履歴」ペインには、実行したコマンドのリストが表示されます。

図sql_hist.gifの説明

各履歴エントリには、コマンドが最後に実行された時間、コマンドの最初の文字およびコマンドを実行したスキーマが表示されます。

「履歴」ペインでは、次の操作を実行できます。

- コマンドのロード:SQL列に表示されているコマンドの一部をクリックして、コマンドをコマンド・エディタにロードします。コマンドがロードされると、このコマンドを最後に実行したスキーマも設定されます。

- 時間によるソート:「時間」列ヘッダーをクリックして、コマンド履歴を古い順または新しい順にソートします。

参照:
「コマンド履歴からのコマンドへのアクセス」

3 SQLスクリプトの使用

このセクションでは、SQLスクリプトを使用してスクリプト・ファイルを作成、編集、表示、実行および削除する方法について説明します。

内容は次のとおりです。

- 「SQLスクリプト」の概要

- 「SQLスクリプト」へのアクセス

- SQLスクリプトの作成

- スクリプト・エディタの使用

- SQLスクリプトの削除

- SQLスクリプトのコピー

- SQLスクリプトの実行

- SQLスクリプト結果の表示

- SQLスクリプトのエクスポートおよびインポート

- スクリプトおよび結果の割当て制限の表示

3.1 「SQLスクリプト」の概要

SQLスクリプトは、「SQLスクリプト」にファイルとして保存された一連のSQLコマンドです。SQLスクリプトには、1つ以上のSQL文またはPL/SQLブロックが含まれています。「SQLスクリプト」を使用して、データベース・オブジェクトを作成、編集、表示、実行および削除できます。

「SQLスクリプト」を使用する場合は、次の点に注意してください。

- 実行時には、SQLスクリプト内のSQL*Plusコマンドは無視されます。

- 「SQLコマンド」と「SQLスクリプト」の間の対話はありません。

- SQLスクリプト・エディタからSQLコマンドをカット・アンド・ペーストして、「SQLコマンド」で実行できます。

- 「SQLスクリプト」ではバインド変数はサポートされていません。

参照:
「「SQLスクリプト」の使用」、「SQLコマンドの使用」および「長時間操作について」

3.2 「SQLスクリプト」へのアクセス

「SQLスクリプト」にアクセスするには、次のステップを実行します。

1. ワークスペースのホームページにログインします。

2. 「SQLワークショップ」アイコン、「SQLスクリプト」の順にクリックします。
図sql_script.gifの説明

SQLスクリプト・ページが表示されます。

注意:
インスタンス管理者がこのApplication Expressインスタンスに対してRESTfulサービスを無効にしている場合、このインスタンスでRESTfulサービスが使用できないため、RESTfulサービス・アイコンが表示されません。『Oracle Application Express管理ガイド』のSQLワークショップの構成に関する説明を参照してください。

参照:
「SQLスクリプト・ページについて」、「SQLコマンドの使用」および「長時間操作について」

3.2.1 SQLスクリプト・ページについて

SQLスクリプト・ページには、現行ユーザーが作成したすべてのSQLスクリプトの対話モード・レポートが表示されます。関心のある列の選択、フィルタの適用、ハイライト、ソートを実行すると、レポート・データのレイアウトを変更できます。ブレーク、集計、各種チャート、グループ化、および独自の計算の追加を定義することもできます。『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。「レポート」ビューには、各スクリプトがレポートの行として表示されます。

図sql_s_home.gifの説明

SQLスクリプト・ページには次のようなコントロールがあります。

- アイコンの表示:各スクリプトが、スクリプト名で識別されるアイコンとして表示します。

- レポートの表示:各スクリプトが、レポートに1行として表示されます。各行には、削除対象としてのスクリプトの選択を有効にするためのチェック・ボックス、スクリプトをスクリプト・エディタにロードできるようにするための「編集」アイコン、スクリプト名、スクリプトの所有者、スクリプトの最終更新日時と最終更新者名、バイト単位で示されたサイズ、実行結果にリンクされているスクリプトの実行回数、およびスクリプトを実行できるようにするためのアイコンが含まれています。
「レポート」ビューには、さらに次のようなコントロールもあります。

- チェックした項目の削除:「レポート」ビューで、削除するスクリプトに関連付けられたチェック・ボックスを選択し、「チェックした項目の削除」をクリックします。「SQLスクリプトの削除」を参照してください。

- ソート:「レポート」ビューで、列ヘッダーをクリックして、リストされたスクリプトをその列ごとにソートします。その他のカスタマイズ・オプションについては、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

- アップロード:「アップロード」をクリックして、スクリプトをローカル・ファイルシステムから「SQLスクリプト」にアップロードします。「SQLスクリプトの作成」を参照してください。

- 作成:「作成」をクリックして、スクリプト・エディタでスクリプトを作成します。「SQLスクリプトの作成」を参照してください。

別のSQLワークショップ・コンポーネントへの切替え

ページの右上にある「コンポーネント」リストから選択を行い、別のSQLワークショップ・コンポーネントにナビゲートできます。

図obj_b_icons.gifの説明

次の使用可能なアイコンがあります。

- オブジェクト・ブラウザ: 「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

- SQLコマンド: 「SQLコマンドの使用」を参照してください。

- SQLスクリプト: 「SQLスクリプトの使用」を参照してください。

- クエリー・ビルダー: 「SQLクエリー・ビルダーを使用した問合せの構築」を参照してください。

- ユーティリティ: 「Oracle Application Expressユーティリティの使用」を参照してください。

- RESTfulサービス: 「RESTfulサービスへのアクセス」を参照してください。

- ヘルプ。

「タスク」リストについて

「タスク」リストがSQLスクリプト・ページの右側に表示されます。

図sql_s_task.gifの説明

「タスク」リストには次のリンクが含まれます。

- 結果の管理: 結果を表示したり、検索して表示することができます。「SQLスクリプト結果の表示」を参照してください。

- 割当て制限の表示: スクリプトの割当て制限ページを表示します。スクリプトの割当て制限ページには、単一の結果の最大サイズ、すべての結果の最大サイズ、使用済の割当て制限および未使用の割当て制限が表示されます。また、SQLスクリプトの最大サイズも表示されます。

- エクスポート: 別のワークスペース内の「SQLスクリプト」にインポートするために、複数のスクリプトを現行のSQLスクリプト・リポジトリからエクスポートできます。エクスポート対象として選択したスクリプトは、ローカル・ファイルシステムに書き込まれた単一のエクスポート・スクリプト内でエンコードされます。エクスポート・スクリプトは、デフォルトではworkspace_name_script.sqlという名前が付けられます。「SQLスクリプトのエクスポートおよびインポート」を参照してください。

- インポート: このワークスペースまたは別のワークスペースでエクスポートされたスクリプトをインポートできます。「インポート」では、「エクスポート」を使用して作成したエクスポート・スクリプト内でエンコードされたスクリプトのみをインポートします。インポートするエクスポート・スクリプトは、ローカル・ファイルシステム上でアクセス可能である必要があります。「SQLスクリプトのエクスポートおよびインポート」を参照してください。

参照:
「「SQLスクリプト」へのアクセス」

3.3 SQLスクリプトの作成

スクリプト・リポジトリでスクリプトを作成するには、次の方法があります。

- スクリプト・エディタでのスクリプトの作成

- ローカル・ファイルシステムからのスクリプトのアップロード

内容は次のとおりです。

- スクリプト・エディタでのSQLスクリプトの作成

- SQLスクリプトのアップロード

3.3.1 スクリプト・エディタでのSQLスクリプトの作成

スクリプト・エディタでSQLスクリプトを作成するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「作成」ボタンをクリックします。
スクリプト・エディタが表示されます。

3. 「スクリプト名」フィールドにスクリプトの名前を入力します。
スクリプト名の拡張子はオプションです。

4. スクリプトに含めるSQL文およびPL/SQLブロックを入力します。
SQL*Plusコマンドは実行時に無視されることに注意してください。

5. 「保存」をクリックして、スクリプトをリポジトリに保存します。
新しく保存されたスクリプトがリストされたSQLスクリプト・ページが表示されます。

参照:
「SQLスクリプトのアップロード」

3.3.2 SQLスクリプトのアップロード

ローカル・ファイルシステムからスクリプトをアップロードするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「アップロード」ボタンをクリックします。
「スクリプトをアップロード」ダイアログ・ボックスが表示されます。

3. ファイルの選択ボタンを使用して、アップロードするスクリプトを選択します。

4. オプションで、「スクリプト名」フィールドに新しい名前を入力して、スクリプト名を変更します。
この名前が、スクリプト・リポジトリ内のスクリプトに対して指定された名前となります。

5. 「アップロード」をクリックして、スクリプトをスクリプト・リポジトリに追加します。
新しくアップロードされたスクリプトがリストされたSQLスクリプト・ページが表示されます。

スクリプトはランタイムに解析されます。解析されると、無視されたSQL*Plusコマンドなどの文がリストされます。無効なSQLは、結果でのみ識別されます。

スクリプト・リポジトリ内に同じ名前のスクリプトが存在する場合は、スクリプトの名前を変更するように求められます。

参照:
「スクリプト・エディタでのSQLスクリプトの作成」

3.4 スクリプト・エディタの使用

スクリプト・リポジトリ内で新規スクリプトへのコンテンツの追加、既存のスクリプトの編集、スクリプトの実行および削除を行うには、スクリプト・エディタを使用します。

内容は次のとおりです。

- 既存のスクリプトの編集

- テキストまたは正規表現の検索および置換

- スクリプト・エディタのコントロールのサマリー

3.4.1 既存のスクリプトの編集

SQLスクリプトを編集するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 次のようにしてスクリプトをエディタにロードできます。

- 「アイコン」ビューでスクリプトのアイコンをクリックします。

- 「レポート」ビューで「編集」アイコンをクリックします。

スクリプト・エディタが表示されます。

図sql_s_editor.gifの説明

3. スクリプトを編集します。
新規の行は、前の行の先頭の列に合せて自動的にインデントされます。スクリプト・エディタのその他の機能には次のものがあります。

- 検索および置換:「検索して置換」をクリックすると、テキストおよびJavaScriptの正規表現の検索および置換オプションが表示されます。再度「検索して置換」をクリックすると、オプションが非表示になります。「テキストまたは正規表現の検索および置換」を参照してください。

- カット、コピーおよびペースト:スクリプト・エディタのコンテンツの切取り、コピーおよび貼付けを行うには、標準の編集コントロールを使用します。

- 元に戻す:直前の編集を元に戻します。

- やり直し:直前に元に戻した編集を再度適用します。

編集中に、スクリプトを実行することによってテストし、エラーを明らかにすることができます。「スクリプトの実行」ダイアログ・ボックスとスクリプト結果ページを使用すると、スクリプトの編集を再開できます。詳細は、「SQLスクリプトの実行」および「SQLスクリプト結果の表示」を参照してください。

4. 「保存」をクリックして、スクリプトをスクリプト・リポジトリに保存します。
SQLスクリプト・ページが表示されます。

3.4.2 テキストまたは正規表現の検索および置換

スクリプト・エディタで「検索して置換」ボタンをクリックすると、上部にフィールドのある検索と置換のページが表示されます。これらのフィールドを使用して、スクリプト内のテキスト文字列やJavaScript正規表現を検索して置換します。「検索」モードを終了するには、再度「検索」をクリックします。

図sql_s_find.gifの説明

スクリプト・エディタで「検索」モードにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. スクリプトを選択します。
スクリプト・エディタが表示されます。

3. 「検索して置換」ボタンをクリックします。
検索と置換のフィールドが表示されます。

4. 「検索」フィールドに検索する文字列を入力します。「置換後の値」には追加する新しい文字列を入力し、適切なボタン(「次を検索」、「置換」または「すべて置換」)をクリックします。
さらに検索を絞り込むには、「大/小文字の区別」チェック・ボックスを選択します。

5. 「検索」モードを終了するには、「検索して置換」をクリックします。

3.4.3 スクリプト・エディタのコントロールのサマリー

表3-1に、スクリプト・エディタで使用できるボタンおよびコントロールを示します。

表3-1 スクリプト・エディタのボタンおよびコントロール

ボタン

説明

取消

編集セッションを取り消して、前回の保存以降に行われた変更内容を保存せずにスクリプト・エディタを終了します。

ダウンロード

現在のスクリプトのコピーをローカル・ファイルシステムに保存します。ローカル・ファイルシステム上のスクリプトの名前とディレクトリ・パスを入力します。

削除

スクリプト・リポジトリから現在のスクリプトを削除します。

参照: 「SQLスクリプトの削除」

保存

現在のスクリプトへの変更を、スクリプト・リポジトリに保存します。

実行

スクリプトを送信して実行します。

参照: 「SQLスクリプトの実行」

元に戻す([Ctrl]+[Z])

スクリプト・エディタで最後に実行した行編集を削除または元に戻します。

やり直し([Ctrl]+[Y])

スクリプト・エディタで最後に実行した行編集を繰り返します。

検索して置換

「検索して置換」をクリックすると検索および置換モードにアクセスします。再度「検索して置換」をクリックすると「検索」モードを終了します。

参照: 「テキストまたは正規表現の検索および置換」

3.5 SQLスクリプトの削除

SQLスクリプト・ページで選択したスクリプトを削除するか、スクリプト・エディタで現在のスクリプトを削除すると、スクリプト・リポジトリからスクリプトを削除できます。

内容は次のとおりです。

- SQLスクリプト・ページからのスクリプトの削除

- スクリプト・エディタでのスクリプトの削除

3.5.1 SQLスクリプト・ページからのスクリプトの削除

SQLスクリプト・ページからスクリプトを削除するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「レポートの表示」アイコンをクリックします。
「レポート」ビューが表示されます。

3. 削除するスクリプトを選択します。
個別にスクリプトを選択するには、「編集」アイコンの左にあるチェック・ボックスをクリックします。現在のページに表示されているスクリプトをすべて選択するには、列ヘッダーのチェック・ボックスをクリックします。

4. 「チェックした項目の削除」をクリックして、選択したスクリプトをスクリプト・リポジトリから完全に削除します。スクリプトが削除される前に、この操作を確認するよう求められます。
「スクリプトは削除されました。」というメッセージが、更新されたスクリプトのリストの上に表示されます。

3.5.2 スクリプト・エディタでのスクリプトの削除

スクリプト・エディタでスクリプトを削除するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. スクリプト・エディタで削除するスクリプトを開きます。

3. 「削除」をクリックして、スクリプトをスクリプト・リポジトリから完全に削除します。スクリプトが削除される前に、この操作を確認するよう求められます。
SQLスクリプト・ページが表示されます。「スクリプトは削除されました。」というメッセージが、更新されたスクリプトのリストの上に表示されます。

3.6 SQLスクリプトのコピー

スクリプト・リポジトリ内のスクリプトは、新しい名前を付けて保存することによってコピーできます。

スクリプトをコピーするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. スクリプト・エディタでスクリプトを開きます。

3. スクリプトの名前をリポジトリ内に存在しない名前に変更します。

4. 「保存」をクリックして、スクリプトを新しい名前のスクリプトにコピーします。
新しくコピーされたスクリプトがリストされたSQLスクリプト・ページが表示されます。

3.7 SQLスクリプトの実行

スクリプト・リポジトリに格納されているスクリプトを実行できます。実行するスクリプトは、スクリプト・エディタから、またはSQLスクリプト・ページから送信できます。

スクリプトを実行するために送信すると、スクリプトの実行ページが表示されます。このページには、スクリプト名、スクリプトの作成日時と作成者、最新更新日時と更新者、含まれる文の数、およびスクリプトのサイズ(バイト単位)が表示されます。また、実行時に無視されるSQL*Plusコマンドなどの不明な文もリストされます。

スクリプトに実行可能な文が含まれない場合は、「コントロールの実行」が表示されません。

内容は次のとおりです。

- スクリプト・エディタでのSQLスクリプトの実行

- SQLスクリプト・ページからのSQLスクリプトの実行

参照:
「長時間操作について」

3.7.1 スクリプト・エディタでのSQLスクリプトの実行

スクリプト・エディタでスクリプトを実行するには、次のステップを実行します。

1. 実行するスクリプトをスクリプト・エディタで開きます。「スクリプト・エディタの使用」を参照してください。

2. スクリプト・エディタで「実行」をクリックします。

3. スクリプトの実行ページが表示されます。
スクリプトの実行ページには、スクリプトについての情報が表示され、エラー防止実行内の文、またはスクリプトの実行時に無視されるSQL*Plusコマンドなどの文がリストされます。

スクリプトの実行ページには3つのコントロールがあります。

- 取消: スクリプトを実行せずに、SQLスクリプト・ページに戻ります。

- バックグラウンドで実行: スクリプトを実行するために送信するのではなく、DBMS_JOBを使用してスクリプトを実行します。このオプションは、長く時間のかかるスクリプトで便利です。

- 即時実行: スクリプトを実行するために送信します。

4. 「即時実行」をクリックして、スクリプトを実行するために送信します。
スクリプト結果の管理ページが表示され、スクリプトの結果がリストされます。

5. スクリプトの結果を表示するには、「結果の表示」の下の「ビュー」アイコンをクリックします。

参照:
「SQLスクリプト結果の表示」

3.7.2 SQLスクリプト・ページからのSQLスクリプトの実行

SQLスクリプト・ページからスクリプトを実行するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「レポートの表示」アイコンをクリックします。
「レポート」ビューが表示されます。

3. 実行するスクリプトの「実行」アイコンをクリックします。「実行」アイコンはスクリプト名の右横にあります。

4. スクリプトの実行ページが表示されます。
スクリプトの実行ページには、スクリプトについての情報が表示され、エラー防止実行内の文、またはスクリプトの実行時に無視されるSQL*Plusコマンドなどの文がリストされます。スクリプトの実行ページには3つのコントロールがあります。

- 取消: スクリプトを実行せずに、SQLスクリプト・ページに戻ります。

- バックグラウンドで実行: スクリプトを実行するために送信するのではなく、DBMS_JOBを使用してスクリプトを実行します。このオプションは、長く時間のかかるスクリプトで便利です。

- 即時実行: スクリプトを実行するために送信します。

5. 「即時実行」をクリックして、スクリプトを実行するために送信します。
スクリプト結果の管理ページが表示され、使用可能なスクリプトの結果がリストされます。

6. 表示する結果の「ビュー」アイコンをクリックします。「ビュー」アイコンは、スクリプト結果の管理ページにリストされるスクリプトの右端にあります。

参照:
「SQLスクリプト結果の表示」

3.8 SQLスクリプト結果の表示

スクリプトの結果を表示および削除するには、スクリプト結果の管理ページを使用します。

SQLスクリプト・ページの「アイコン」ビューから、またはSQLスクリプト・ページの「詳細」ビューの「結果」列から、表示するスクリプトの結果を選択することもできます。

内容は次のとおりです。

- SQLスクリプト・ページからの結果の表示

- 結果ページについて

3.8.1 SQLスクリプト・ページからの結果の表示

SQLスクリプト・ページからスクリプトの結果を表示するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「タスク」リストで「結果の管理」をクリックします。

3. 表示する結果に対して、「結果の表示」アイコンをクリックします。
利用可能なスクリプトの結果がリストされたスクリプト結果の管理ページが表示されます。

図sql_m_results.gifの説明

4. 表示する結果の「結果の表示」アイコンをクリックします。「ビュー」アイコンは、ページの右端の「結果の表示」ヘッダーの下に表示されます。
結果ページが表示されます。「結果ページについて」を参照してください。

3.8.2 結果ページについて

結果ページには、スクリプト名およびステータス(「完了」、「取消済」、「実行中」または「送信」)が表示され、実行された文がリストされます。

図sql_s_result.gifの説明

結果ページでは、次の操作を実行できます。

- ビューの選択:「詳細」または「サマリー」オプションをクリックして「実行」をクリックし、完全な情報またはサマリー情報のどちらを表示するかを指定します。

- 表示する行数の選択:「サマリー」ビューで「表示」リストから選択し、「実行」をクリックして、表示する行数を指定します。

- 文レポートのソート:「サマリー」ビューで列ヘッダーを選択し、リストされた値をその列でソートします。

- スクリプトの編集。「スクリプトの編集」をクリックして、スクリプト・エディタにスクリプトをロードします。「スクリプト・エディタの使用」を参照してください。

3.9 SQLスクリプトのエクスポートおよびインポート

エクスポートおよびインポート・タスクを使用して、スクリプトを現行のスクリプト・リポジトリから別のワークスペース内のスクリプト・リポジトリに送信できます。エクスポートされたスクリプトは、ローカル・ファイルシステムの単一のファイル内でエンコードされます。エクスポート後に、もう一方のワークスペースにログインしてそのファイルをインポートします。インポート時には、そのファイルが実行されて現行のスクリプト・リポジトリでスクリプトが再作成されます。

デフォルトでは、SQLスクリプトのエクスポート・ページには現行のユーザーによって作成されたスクリプト・リポジトリ内のすべてのスクリプトが表示されます。SQLスクリプトのエクスポート・ページには、「スクリプト」および「エクスポートするスクリプト」の2つのペインがあります。エクスポートするスクリプトを選択するには、「スクリプト」ペインを使用します。次に、エクスポートするスクリプトを確定し、エクスポート・スクリプト名を選択し、エクスポート・スクリプト内の選択したスクリプトをローカル・ファイルシステム上に保存するには、「エクスポートするスクリプト」ペインを使用します。インポートするスクリプトを含むエクスポート・スクリプトを選択するには、「スクリプトのインポート」ペインを使用します。

内容は次のとおりです。

- エクスポート・スクリプトへのスクリプトのコピー

- エクスポート・スクリプトからのスクリプトのインポート

3.9.1 エクスポート・スクリプトへのスクリプトのコピー

スクリプトをエクスポート・スクリプトにコピーするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「タスク」リストで、「エクスポート」をクリックします。
SQLスクリプトのエクスポート・ページが表示されます。

3. エクスポートする各スクリプトのチェック・ボックスを選択します。チェック・ボックスは、スクリプト名の左横に表示されます。表示されているすべてのスクリプトをエクスポート対象として選択するには、列ヘッダーのチェック・ボックスを選択します。

4. 「エクスポートに追加」をクリックして、エクスポート・スクリプトに追加するスクリプトのリストを作成します。
選択したスクリプトが、「エクスポートするスクリプト」ペインのスクリプト・リストに追加されます。

5. 「ファイル名」フィールドにエクスポート・スクリプトの名前を入力します。
デフォルトのスクリプト名はworkspace_name_script.sqlです。

6. 「すべてのエクスポート」をクリックして、スクリプトをエクスポート・スクリプトにエクスポートします。
エクスポート・スクリプトを保存するディレクトリを入力するよう求められます。

3.9.1.1 「スクリプト」ペイン

図sql_s_pane.gifの説明

「スクリプト」ペインでは、次の操作を実行できます。

- スクリプトの検索。「検索」フィールドにスクリプトの名前または名前の一部を入力して、「実行」をクリックします。すべてのスクリプトを表示するには、「検索」フィールドを空のままにして「所有者」リストから「- すべてのユーザー -」を選択し、「実行」をクリックします。「行」リストから選択して、表示する行数を制御します。

- エクスポートの取消し。スクリプトをエクスポートせずにSQLスクリプト・ページに戻るか、エクスポート・スクリプトを保存した後、SQLスクリプト・ページに戻るには、「取消」をクリックします。

- エクスポートするスクリプトの選択。「エクスポートに追加」をクリックして、エクスポート・スクリプトにスクリプトを追加します。エクスポート・スクリプトに追加されたスクリプトは、「スクリプト」ペインのリストから削除され、「エクスポートするスクリプト」ペインに表示されます。

- スクリプトのソート。列ヘッダーをクリックして、リストされたスクリプトをその列ごとにソートします。

3.9.1.2 「エクスポートするスクリプト」ペインについて

図sql_s_export.gifの説明

「エクスポートするスクリプト」ペインでは、次の操作を実行できます。

- エクスポート・スクリプトの名前の変更。「ファイル名」フィールドにエクスポート・スクリプトの名前を入力するか、デフォルトのスクリプト名のままにします。

- スクリプトの削除。削除するスクリプトの横のチェック・ボックスをクリックし、「チェックした項目の削除」をクリックします。削除されたスクリプトは、「エクスポートするスクリプト」ペインのリストから削除され、「スクリプト」ペインに表示されます。

- エクスポート・スクリプトの保存。エクスポート・スクリプトをローカル・ファイルシステム上に保存するには、「すべてのエクスポート」をクリックします。エクスポート・スクリプトを保存するディレクトリを入力するよう求められます。

3.9.2 エクスポート・スクリプトからのスクリプトのインポート

スクリプトをエクスポート・スクリプトからインポートするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「タスク」リストで「インポート」をクリックします。
「スクリプトのインポート」ペインが表示されます。「「スクリプトのインポート」ペインについて」を参照してください。

3. スクリプト・リポジトリにインポートするエクスポート・スクリプトの名前とパスを入力するか、または「参照」をクリックして、インポートするエクスポート・スクリプトを選択します。

4. 「次へ」をクリックして、エクスポート・スクリプト内のスクリプトをリストします。
「アクション」列に、インポートされるファイルが新しいファイルなのか、同名の既存スクリプトを置換するかが示されます。

5. 「スクリプトのインポート」をクリックして、リストされたスクリプトを現行のスクリプト・リポジトリにインポートします。
インポートされたスクリプトがリストされたSQLスクリプト・ページが表示されます。

3.9.2.1 「スクリプトのインポート」ペイン

図sql_s_import.gifの説明

「スクリプトのインポート」ペインでは、次の操作を実行できます。

- エクスポート・スクリプトの入力。インポートするスクリプトの名前とパスを「ファイルのインポート」フィールドに入力するか、「参照」をクリックしてスクリプトを選択します。

- インポートの取消し。スクリプトをインポートせずにSQLスクリプト・ページに戻るには、「取消」をクリックします。

- インポートの続行。指定したエクスポート・スクリプト内のスクリプトをインポートするには、「次へ」をクリックします。リストしたインポート対象スクリプトを確認できます。

- 別のエクスポート・ファイルの選択。「スクリプトのインポート」ファイル選択ページに戻って別のエクスポート・スクリプトを選択するには、「戻る」を選択します。

3.10 スクリプトおよび結果の割当て制限の表示

現在のワークスペース内のスクリプトの制限をスクリプトの割当て制限ページで確認できます。

スクリプトの割当て制限ページを表示するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「SQLスクリプト」の順にクリックします。
SQLスクリプト・ページが表示されます。

2. 「タスク」リストで「割当て制限の表示」をクリックします。
スクリプトの割当て制限ページが表示されます。

3. 「取消」をクリックして、SQLスクリプト・ページに戻ります。

スクリプトの割当て制限ページについて

スクリプトの割当て制限ページには次の制限が表示されます。

- 結果の割当て制限(バイト):

- スクリプト結果の最大サイズ:単一のスクリプト結果の最大サイズ(バイト)。このサイズは、Oracle Application Expressインスタンス管理者によって設定され、ワークスペースから変更することはできません。

- すべてのスクリプト結果の割当て制限:このワークスペース内のすべての結果の最大サイズ(バイト)。このサイズは、Oracle Application Expressインスタンス管理者によって設定され、ワークスペースから変更することはできません。

- 使用済: このワークスペース内で現在使用されているバイト数。

- 空き: このワークスペース内で現在未使用のバイト数。

- 割当て制限: 現在使用されている割当て制限の割合を示す使用状況バー。

- スクリプトの割当て制限(バイト):

- スクリプトの最大サイズ: 単一のスクリプトの最大サイズ(バイト)。このサイズは、Oracle Application Expressインスタンス管理者によって設定され、ワークスペースから変更することはできません。

4 Oracle Application Expressユーティリティの使用

この項では、Oracle Application Expressユーティリティを使用して、SQL問合せの作成、Oracle Databaseからのデータのロードとアンロード、DDLの生成、オブジェクト・レポートの表示、ユーザー・インタフェース・デフォルトの管理、削除されたデータベース・オブジェクトのリストア、スキーマの比較、データベースの監視およびデータベース詳細の表示を行う方法を説明します。

内容は次のとおりです。

- SQLクエリー・ビルダーを使用した問合せの構築

- データ・ワークショップを使用したデータの管理

- DDLの生成

- 表のメソッドの管理

- ユーザー・インタフェースのデフォルト値の管理

- データベースの詳細の表示

- スキーマの比較

- オブジェクト・レポートの表示

- データベースの監視

- ごみ箱を使用した、削除されたオブジェクトの表示およびリストア

4.1 クエリー・ビルダーを使用した問合せの構築

クエリー・ビルダーのGraphical User Interfaceを使用すると、データベース開発者は、手動でSQLをコーディングしなくても、SQL問合せを作成できます。クエリー・ビルダーを使用すると、SQLの知識がほとんどなくても、データベース・オブジェクトの検索およびフィルタ適用、オブジェクトおよび列の選択、オブジェクト間の関係の作成、問合せ結果の書式の表示、問合せの保存を行うことができます。

内容は次のとおりです。

- クエリー・ビルダーについて

- 「オブジェクト選択」ペインの使用

- オブジェクトの選択

- 問合せ条件の指定

- オブジェクト間の関係の作成

- 保存された問合せでの操作

- 生成されたSQLの表示

- 問合せ結果の表示

参照:
Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドの「「問合せファインダ」の使用」

4.1.1 クエリー・ビルダーについて

クエリー・ビルダー・ページは、次の3つのセクションに分かれています。

- 「オブジェクト選択」ペイン: ページの左側に表示され、問合せの構築に使用できるオブジェクトのリストがあります。現行スキーマのオブジェクトのみが表示されます。

- 「設計」ペイン: 「オブジェクト選択」ペインの右側、「条件」、「SQL」、「結果」および「保存されたSQL」の上に表示されます。「オブジェクト選択」ペインでオブジェクトを選択すると、そのオブジェクトが「設計」ペインに表示されます。

- 「出力」ペイン: 「設計」ペインの下に表示されます。オブジェクトおよび列を選択すると、条件の作成、生成済のSQLの表示、または問合せ結果の表示を行うことができます。

図query_builder.gifの説明

スキーマの選択

スキーマはデータベース・オブジェクトの論理的なコンテナです。別のスキーマのオブジェクトにアクセスするには、SQLワークショップのホームページで「スキーマ」リストから選択します。自分のワークスペースに割り当てられたスキーマのみがリストされます。

別のSQLワークショップ・コンポーネントへの切替え

ページの右上にある「コンポーネント」リストから選択を行い、別のSQLワークショップ・コンポーネントにナビゲートできます。

図obj_b_icons.gifの説明

次の使用可能なアイコンがあります。

- オブジェクト・ブラウザ: 「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

- SQLコマンド: 「SQLコマンドの使用」を参照してください。

- SQLスクリプト: 「SQLスクリプトの使用」を参照してください。

- クエリー・ビルダー: 「SQLクエリー・ビルダーを使用した問合せの構築」を参照してください。

- ユーティリティ: 「Oracle Application Expressユーティリティの使用」を参照してください。

- RESTfulサービス: 「RESTfulサービスへのアクセス」を参照してください。

- ヘルプ。

内容は次のとおりです。

- クエリー・ビルダーへのアクセス

- 問合せ作成プロセスの理解

4.1.1.1 クエリー・ビルダーへのアクセス

クエリー・ビルダーにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページにログインします。

2. 「SQLワークショップ」をクリックします。

3. 「ユーティリティ」をクリックします。

4. 「クエリー・ビルダー」をクリックします。

クエリー・ビルダーのホームページが表示されます。

4.1.1.2 問合せ作成プロセスの理解

クエリー・ビルダーで問合せを作成するには、次のステップを実行します。

1. 「オブジェクト選択」ペインで、オブジェクトを選択します。詳細は、「「オブジェクト選択」ペインの使用」を参照してください。

2. 「設計」ペインにオブジェクトを追加して、列を選択します。詳細は、「オブジェクトの選択」を参照してください。

3. オプション: オブジェクト間の関係を確立します。詳細は、「オブジェクト間の関係の作成」を参照してください。

4. オプション: 問合せ条件を作成します。詳細は、「問合せ条件の指定」を参照してください。

5. 問合せを実行し、結果を表示します。詳細は、「問合せ結果の表示」を参照してください。

参照:
「生成されたSQLの表示」および「保存された問合せでの操作」

4.1.2 「オブジェクト選択」ペインの使用

「オブジェクト選択」ペインはクエリー・ビルダー・ページの左側に表示され、カレント・スキーマ内の表、ビューおよびマテリアライズド・ビューをリストします。

内容は次のとおりです。

- オブジェクトの検索とフィルタの適用

- 「オブジェクト選択」ペインの非表示

4.1.2.1 オブジェクトの検索とフィルタの適用

「オブジェクト選択」ペインを使用して、カレント・スキーマ内の表、ビューおよびマテリアライズド・ビューを検索して表示します。

オブジェクトの検索またはフィルタの適用を行うには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. ペイン上部の検索フィールドに、大/小文字が区別されない問合せを入力します。

3. 現在選択されているスキーマ内のすべての表またはビューを表示するには、検索フィールドを空白のままにします。

図q_b_search.gifの説明

4.1.2.2 「オブジェクト選択」ペインの非表示

表またはビューの非表示のコントロールを選択して、「オブジェクト選択」ペインを非表示にできます。「オブジェクト選択」ペインを非表示にすると、「設計」および「結果」ペインのサイズを大きくすることができます。

表またはビューの非表示のコントロールは「オブジェクト選択」ペインの右側に表示されます。「オブジェクト」リストが表示されている場合は、このコントロールを選択するとリストが非表示になります。同様に、「オブジェクト」リストが非表示の場合は、このコントロールを選択すると、再度リストが表示されます。

4.1.3 オブジェクトの選択

「設計」ペインは「オブジェクト選択」ペインの右側に表示されます。「オブジェクト選択」ペインでオブジェクトを選択すると、そのオブジェクトが「設計」ペインに表示されます。「オブジェクト選択」ペインを使用してオブジェクト(つまり表、ビューおよびマテリアライズド・ビュー)を選択し、「設計」ペインを使用して選択したオブジェクトの問合せでの使用方法を指定します。

内容は次のとおりです。

- サポートされる列の型について

- 「設計」ペインへのオブジェクトの追加

- 「設計」ペインでのオブジェクトの削除または非表示

参照:
「オブジェクト間の関係の作成」

4.1.3.1 サポートされる列の型について

Oracle Database 10gリリース(10.2)またはそれ以降で使用可能なすべての型の列が「設計」ペインにオブジェクトとして表示されます。次の列制限に注意してください。

- それぞれの問合せに対して選択できるのは、最大60列です。

- 次の型の列は選択不可で、生成された問合せに含めることはできません。

- BLOB

- NCLOB

- RAW

- LONG

- LONG RAW

- XMLType

- その他の非スカラー列の型

4.1.3.2 「設計」ペインへのオブジェクトの追加

「オブジェクト選択」ペインからオブジェクトを選択して、オブジェクトを「設計」ペインに追加します。

「設計」ペインにオブジェクトを追加するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインで、オブジェクトを選択します。
選択したオブジェクトが「設計」ペインに表示されます。列名の右側にデータ型がグラフィカルに表示されることに注意してください。

図q_b_add.gifの説明

3. 列名の左のチェック・ボックスを選択することによって、問合せに含める列を選択します。
列を選択すると、その列が問合せに含まれることになります。また、その列が「条件」タブに表示されます。「条件」タブの「表示」チェック・ボックスによって、列が問合せ結果に含まれるかどうかを制御します。このチェック・ボックスは、デフォルトでは選択されています。

最初の20列を選択するには、オブジェクトの左上にある「表の処理」アイコンをクリックします。「アクション」ウィンドウが表示されます。「すべてをチェック」を選択します。

4. 問合せを実行し、結果を表示するには、「実行」([Ctrl] + [Enter])をクリックします。
「結果」ペインに問合せ結果が表示されます。

参照:
「問合せ条件の指定」

4.1.3.2.1 「設計」ペインと「結果」ペインのサイズ変更

オブジェクトを選択すると、ページ中央の灰色の水平罫線を選択して、「設計」および「結果」ペインのサイズを変更できます。罫線を上に移動すると、「設計」ペインが縮小します。罫線を下に移動すると、「設計」ペインが拡大します。

4.1.3.3 「設計」ペインでのオブジェクトの削除または非表示

「設計」ペインでオブジェクトを削除または非表示にするには、オブジェクトの上部にあるコントロールを選択します。オブジェクトを削除するには、右上の「削除」アイコンを選択します。オブジェクト内の列を一時的に非表示にするには、「列の表示/非表示」アイコンをクリックします。

図q_b_remove.gifの説明

4.1.4 問合せ条件の指定

条件を使用すると、操作するデータにフィルタを適用し、識別することができます。オブジェクト内の列を選択するときに、「条件」タブで条件を指定できます。これらの属性を使用して、列の別名の変更や、列条件の適用、列のソート、ファンクションの適用を行うことができます。

問合せ条件を指定するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインで、オブジェクトを選択します。
選択したオブジェクトが「設計」ペインに表示されます。

3. 列名の左のボックスをクリックして、問合せに含める列を選択します。
列を選択すると、問合せにその列を含めることになります。各列を選択すると、「条件」ビューに別個の行として表示されます。表4-1に、「条件」タブで使用可能な属性を示します。

表4-1 「条件」タブ

条件属性

説明

上矢印および下矢印

問合せの結果に表示される列の順序を制御します。矢印ボタンをクリックして、列を上下に移動します。

参照: 「問合せ結果の表示」

列

列名を表示します。

別名

列の別名(オプション)を指定します。別名は列の代替名です。別名は、列名をわかりやすくする、列名を短くする、またはあいまいな参照を防ぎます。

オブジェクト

表またはビュー名を指定します。

条件

列の条件を指定します。

入力した条件により、問合せのWHERE句が変更されます。列条件を指定するときは、適切な演算子およびオペランドを含める必要があります。次に例を示します。

>=10
='VA'
IN (SELECT dept_no FROM dept)
BETWEEN SYSDATE AND SYSDATE + 15

ソート・タイプ

ソート・タイプを選択します。オプションは次のとおりです。

- 昇順(Asc)

- 降順(Desc)

ソート順序

番号(1、2、3・・・)を入力して、選択した列が表示される順序を指定します。

表示

列を問合せ結果に含めるには、このチェック・ボックスを選択します。フィルタ目的のためにのみ、列を問合せに追加する場合は、「表示」を選択する必要はありません。

たとえば、次の問合せを作成するとします。

SELECT ename FROM emp WHERE deptno = 10

この問合せをクエリー・ビルダーで作成するには、次のステップを実行します。

1. 「オブジェクト」リストから、empを選択します。

2. 「設計」ペインで、enameおよびdeptnoを選択します。

3. deptno列に対して、「条件」で=10 と入力し、「表示」チェック・ボックスを選択解除します。

ファンクション

引数ファンクションを選択します。使用可能なファンクションは列タイプによって異なり、次のものがあります。

- NUMBER列: COUNT、COUNT DISTINCT、AVG、MAX、MIN、SUM

- VARCHAR2、CHAR列: COUNT、COUNT DISTINCT、INITCAP、LENGTH、LOWER、LTRIM、RTRIM、TRIM、UPPER

- DATE, TIMESTAMP列: COUNT、COUNT DISTINCT、TO_CHAR YEAR、TO_CHAR QUARTER、TO_CHAR MONTH、TO_CHAR DAY、TO_CHAR DAY OF YEAR、TO_CHAR WEEK

グループ化

集計関数の使用時にグループ化に使用する列を指定します。出力に含まれる列にのみ適用できます。

削除

問合せから列を排除して、選択解除します。

列を選択し条件を定義すると、クエリー・ビルダーによってSQLが書き込まれます。

4. 基礎となるSQLを表示するには、「SQL」タブをクリックします。

4.1.5 オブジェクト間の関係の作成

結合を作成することで、オブジェクト間の関係を作成できます。結合によって、複数の表、ビューまたはマテリアライズド・ビューの関係が識別されます。

内容は次のとおりです。

- 結合条件について

- オブジェクトの手動結合

- オブジェクトの自動結合

4.1.5.1 結合条件について

結合の問合せを記述するときは、2つのオブジェクトの関係を示す条件を指定します。この条件を結合条件といいます。結合条件によって、1つのオブジェクトの行を別のオブジェクトの行とどのように組み合せるかが決定されます。

クエリー・ビルダーは、内部結合、外部結合、左側結合および右側結合をサポートしています。内部結合(単純結合ともいう)は、結合条件を満たす行を戻します。外部結合は、単純な結合の結果を拡張します。外部結合は、結合条件に一致するすべての行に加え、一方の表では結合条件を満たし、もう一方の表では結合条件を満たさない行のすべてまたは一部を戻します。

参照:
結合条件の詳細は、Oracle Database SQL言語リファレンスを参照してください

4.1.5.2 オブジェクトの手動結合

「設計」ペインの「結合」列を選択して、結合を手動で作成できます。

2つのオブジェクトを手動で結合するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインで、結合するオブジェクトを選択します。
選択したオブジェクトが「設計」ペインに表示されます。

3. 結合する列を指定します。
列名の横にある「結合」列を選択して、結合を作成します。「結合」列はデータ型の右、「削除」アイコンの下に表示されます。該当する位置にカーソルを置くと、次のヘルプ・ヒントが表示されます。

Click here to select column for join

4. 最初のオブジェクトについて、該当する「結合」列を選択します。
選択すると、「結合」列が濃い灰色で表示されます。「結合」列の選択を解除するには、再度その列を選択するか[Esc]を押します。

5. 2つ目のオブジェクトについて、該当する「結合」列を選択します。

ヒント:
2つのオブジェクトをドラッグ・アンド・ドロップして結合することもできます。最初の表の列を選択し、その列を別の表の列にドラッグ・アンド・ドロップします。

図q_b_join.gifの説明

オブジェクトが結合されると、2つの列が線で結ばれます。

6. 問合せに含める列を選択します。線の上にカーソルを置くと、この結合によって生成されたSQL文を表示できます。

7. 「実行」をクリックして問合せを実行します。
「結果」ペインに問合せ結果が表示されます。

4.1.5.3 オブジェクトの自動結合

オブジェクトを自動的に結合する場合は、既存の列における既存の論理的親子関係が、クエリー・ビルダーによって提示されます。

オブジェクトを自動的に結合するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインから、オブジェクトを選択します。
選択したオブジェクトが「設計」ペインに表示されます。

3. オブジェクトの左上にある小さいアイコンをクリックします。選択したオブジェクトに応じて、アイコン・ラベルに「表の処理」または「処理の表示」と表示されます。
「アクション」ウィンドウが表示されます。「アクション」ウィンドウを使用して、現行オブジェクトに関連する現行オブジェクト内の列をすべて選択します。

4. 「アクション」ウィンドウで、適切なオプションを選択します。

- すべてをチェック: 現行のオブジェクト内の最初の20列を選択するには、このオプションを選択します。

- 親の追加: 現行オブジェクトの外部キーとして参照される表を表示します。

- 子の追加: 外部キー内の現行オブジェクトを参照する表を表示します。

「親の追加」または「子の追加」を使用している場合、選択したオブジェクトが表示され、外部キー列が線で結ばれます。

5. 問合せに含める追加の列を選択します。
緑の線の上にカーソルを置くと、この結合によって生成されたSQL文を表示できます。

6. 「実行」をクリックして問合せを実行します。
「結果」ペインに問合せ結果が表示されます。

4.1.6 保存された問合せでの操作

問合せを作成したときは、「設計」ペインの「保存」ボタンをクリックして、問合せを保存できます。問合せを保存すると、後に「保存されたSQL」ビューでその問合せにアクセスできます。

内容は次のとおりです。

- 問合せの保存

- 保存された問合せの編集

- 保存された問合せの削除

4.1.6.1 問合せの保存

問合せを保存するには、次のステップを実行します。

1. 問合せを構築します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインで、オブジェクトを選択します。

3. 「設計」ペインにオブジェクトを追加して、列を選択します。

4. 問合せを実行します。

2. 「保存」をクリックします。

3. 名前と説明を入力して、「保存」をクリックします。
保存された問合せが「保存されたSQL」ビューに表示されます。

図q_b_save.gifの説明

クエリー・ビルダーでは重複する問合せ名はサポートされていないことに注意してください。既存の問合せを開き、既存の名前をそのまま使用して再度保存すると、クエリー・ビルダーによって既存の問合せが上書きされます。既存の問合せの名前を変更して再度保存すると、その問合せはクエリー・ビルダーによって新しい名前で保存されます。

4.1.6.2 保存された問合せの編集

問合せを保存すると、「保存されたSQL」ビューでその問合せにアクセスできます。

保存されたSQL問合せを編集するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「保存されたSQL」タブを選択します。

3. 次の方法で表示にフィルタを適用できます。

- 「所有者」リストから表示内容を選択して、「実行」をクリックします。

- 「名前」フィールドに検索問合せを入力して、「実行」をクリックします。

4. 問合せを編集するには、該当する名前を選択します。
保存された問合せが表示されます。選択したオブジェクトが「設計」ペインに表示され、「条件」ビューが表示されます。

4.1.6.3 保存された問合せの削除

保存されたSQL問合せを削除するには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「保存されたSQL」タブを選択します。

3. 削除する問合せを選択し、「チェックした項目の削除」をクリックします。

4.1.7 生成されたSQLの表示

「SQL」ビューには、クエリー・ビルダーによって生成されたSQLが書式設定され、読取り専用で表示されます。「SQL」ビューに表示されたSQLコードをコピーして、SQLコマンド・プロセッサまたはアプリケーション・ビルダーなどの他のツールで使用することができます。

参照:
「SQLコマンドの使用」

「SQL」ビューにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで「SQLワークショップ」、「クエリー・ビルダー」の順にクリックします。
クエリー・ビルダーが表示されます。

2. 「オブジェクト選択」ペインで、オブジェクトを選択します。
選択したオブジェクトが「設計」ペインに表示されます。

3. 問合せに含める列を選択します。

4. 「SQL」タブを選択します。
クエリー・ビルダーによって生成されたSQLコードが表示されます。

4.1.8 問合せ結果の表示

オブジェクトを選択し、問合せに含める列を決定した後、次の方法で問合せを実行します。

- 「実行」ボタンのクリック(または[Ctrl]+[Enter]の使用)。

- 「結果」タブの選択

「結果」ビューが表示され、書式設定された問合せの結果が示されます。レポートをカンマ区切り(.csv)ファイルとしてエクスポートするには、ページ下部の「ダウンロード」リンクをクリックしてください。

図qry_bldr_results.gifの説明

4.2 データ・ワークショップを使用したデータの管理

Oracle Application Expressのデータのロード/アンロード・ウィザードを使用すると、区切られたテキスト・データをデータベースから簡単にロードおよびアンロードできます。段階的に進むウィザードには次の機能があります。

- XMLファイルまたは区切られたフィールドを持つテキスト・ファイル(カンマ区切り(.csv)またはタブ区切りファイルなど)をロードまたはアンロードできます。

- スプレッドシートからコピー・アンド・ペーストすることでロードできます。

- ロード時またはアンロード時に列を省略(スキップ)できます。

- 既存の表にロードするか、ロードしたデータから新しい表を作成できます。

- 新しい表へのロード時に、主キーをデータから取得するか、新規または既存のOracleの順序から生成できます。

- 新しい表へのロード時に、列名をロードしたデータから取得できます。

- ファイルからロードするたびに、ファイルの詳細がテキスト・データのロード・リポジトリに保存されます。これらのファイルには、リポジトリからいつでもアクセスできます。

次の制限があります。

- ウィザードでは表データのみをロードおよびアンロードします。他の種類のスキーマ・オブジェクトのロードやアンロードはできません。

- ロードおよびアンロードはユーザー自身のスキーマのみで可能です。これは、管理者権限を持つユーザーにも該当します。

- 一度にロードまたはアンロードできる表は1つのみです。

- テキストまたはXMLファイルへのアンロード、またはXMLファイルからのロードについては、データ・タイプの制限はありません。しかし、スプレッドシートからの(コピー・アンド・ペーストによる)ロードまたはテキスト・ファイルからのロードの場合、NUMBER、DATE、VARCHAR2、CLOB、BINARY_FLOATおよびBINARY_DOUBLEのデータ型のみがサポートされています。

サポートされているアンロード形式は次のとおりです。

- カンマ区切りデータ、タブ区切りデータなどのテキスト

- XML文書

内容は次のとおりです。

- データのインポート、エクスポート、ロードおよびアンロードについて

- データのロード/アンロード・ページへのアクセス

- データのロード

- データのアンロード

- リポジトリの使用

4.2.1 データのインポート、エクスポート、ロードおよびアンロードについて

Oracle Database間、またはOracle Databaseと外部ファイル間でデータをコピーする場合、様々なオプションがあります。データのコピーは、データのエクスポートとインポート、およびデータのアンロードとロードで行います。次の表で、これらの用語を定義します。

用語

定義

エクスポート

他のOracle Databaseにインポートするためだけに、データベースのデータを外部ファイルにコピーします。ファイルは固有のバイナリ形式です。

インポート

他のOracle Databaseからエクスポートして作成した外部ファイルのデータを、データベースにコピーします。

アンロード

他のOracle Databaseまたは他のアプリケーション(スプレッドシート・アプリケーションなど)で使用するために、データベースのデータを外部テキスト・ファイルにコピーします。テキスト・ファイルは、タブ区切りやカンマ区切り(CSV)などの標準形式です。

ロード

標準の区切り形式またはOracleのSQL*Loaderユーティリティでサポートされている任意の形式の外部テキスト・ファイルのデータを、データベースにコピーします。

Oracle Databaseのどのエディション(Express Edition、Standard EditionおよびEnterprise Edition)間でもデータをエクスポートできます。

内容は次のとおりです。

- 正しいインポート/エクスポート/ロード/アンロード・オプションの選択

4.2.1.1 正しいインポート/エクスポート/ロード/アンロード・オプションの選択

Oracle DatabaseおよびOracle Application Expressには、データのインポート、エクスポート、ロードおよびアンロードのための様々な強力なオプションがあります。表4-2に、これらのオプションのサマリーを示します。

表4-2 Oracle Application Expressのインポート/エクスポート・オプションのサマリー

機能またはユーティリティ

説明

Oracle Application Expressのデータのロード/アンロード・ウィザード

- 使用しやすいグラフィカル・インタフェース

- 外部テキスト・ファイル(区切られたフィールド)またはXMLファイルのロード/アンロード

- 表のみ、一度に1つの表のみのロード/アンロード

- ログイン・ユーザーのスキーマのみにアクセス

- アップロード時にデータのフィルタ処理なし

SQL*Loaderユーティリティ

- sqlldrコマンドで起動するコマンドライン・インタフェース

- 外部ファイルからデータベースへデータをバルクロード

- 区切り、固定レコード、可変レコードおよびストリームなど、多数の入力形式をサポート

- 同時に複数の表をロード

- 強力なデータのフィルタ機能

データ・ポンプ・エクスポートおよびデータ・ポンプ・インポート・ユーティリティ

- expdpおよびimpdpコマンドで起動するコマンドライン・インタフェース

- 任意のOracle Databaseから別のOracle Databaseへのエクスポートおよびインポート(固有のバイナリ形式)

- すべてのスキーマ・オブジェクト・タイプのインポート/エクスポート

- データベース全体、スキーマ全体、複数のスキーマ、複数の表領域、または複数の表のインポート/エクスポート

- 強力なデータのフィルタ機能

- 高速

エクスポートおよびインポート・ユーティリティ

- expおよびimpコマンドで起動するコマンドライン・インタフェース

- 任意のOracle Databaseから別のOracle Databaseへのエクスポートおよびインポート(固有のバイナリ形式)

- XMLTypeデータをサポート

- FLOATおよびDOUBLEデータ型をサポートしない

- データ・ポンプの類似機能(データポンプを推奨)

表4-3では、ロード、アンロード、インポートおよびエクスポートの例を示し、それぞれで使用する適切なオプションを提案しています。

表4-3 インポート/エクスポートの例と推奨オプション

インポート/エクスポートの例

推奨オプション

ロードする表が10より少なく、データがスプレッドシートかタブ区切りまたはカンマ区切りのテキスト・ファイルにあり、複合データ型(オブジェクトや複数値のフィールドなど)が存在しない。

Oracle Application Expressのデータのロード/アンロード・ウィザード

区切られていないデータをロードする必要がある。レコードは固定長で、フィールド定義は列の位置に依存する。

SQL*Loader

ロードするデータがタブ区切りのテキスト・データであり、存在する表が10より多い。

SQL*Loader

ロードするデータがテキスト・データであり、ある選択基準(たとえば、部門番号3001の従業員のレコードのみ)を満たすレコードのみをロードする。

SQL*Loader

別のOracle Databaseへ、スキーマ全体をインポートまたはエクスポートする。データにはXMLTypeデータが存在しない。

データ・ポンプ・エクスポートおよびデータ・ポンプ・インポート

別のOracle Databaseへデータをインポートまたはエクスポートする。データにはXMLTypeデータが含まれるが、FLOATまたはDOUBLEデータ型は含まれない。

インポート(imp)およびエクスポート(exp)

参照:
データ・ポンプ、インポートおよびエクスポート・ユーティリティ、およびSQL*Loaderの詳細は、Oracle Databaseユーティリティを参照してください

4.2.2 データのロード/アンロード・ページへのアクセス

データのロード/アンロード・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データ・ワークショップ」をクリックします。
データ・ワークショップ・ページが表示されます。

4. データのロード、データのアンロードまたはリポジトリの表示を行うには、該当するアイコンをクリックします。

4.2.3 データのロード

次の方法で、Oracle Application Expressデータベースにデータをロードできます。

- スプレッドシートからデータをコピー・アンド・ペーストする。

- 区切り形式(カンマ区切り(.csv)、タブ区切りなど)でスプレッドシート・ファイルをアップロードする。

- カンマ区切りデータまたはタブ区切りデータを含むテキスト・ファイルをアップロードする。

- XML文書をアップロードする。

内容は次のとおりです。

- テキスト・ファイルまたはスプレッドシート・データのロード

- XML文書のロード

参照:
「正しいインポート/エクスポート/ロード/アンロード・オプションの選択」

4.2.3.1 テキスト・ファイルまたはスプレッドシート・データのロード

テキスト・ファイルをアップロードすることも、タブ区切りデータをデータのロード・ウィザードに直接コピー・アンド・ペーストすることもできます。

テキスト・ファイルからデータをロードするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データ・ワークショップ」をクリックします。

4. 「データ・ロード」で「テキスト・データ」をクリックします。
データのロード・ウィザードが表示されます。

5. 「ロード先」で、「既存の表」または「新しい表」のいずれかを選択します。

6. 「ロード元」で、「ファイルをアップロード」または「コピー・アンド・ペースト」のいずれかをクリックします。

- ファイルのアップロード: アップロードする既存のテキスト・ファイルを指定する場合に選択します。

- コピー・アンド・ペースト: コピー・アンド・ペーストを実行してアップロードするテキスト・ファイルを作成する場合に選択します。

7. 「次へ」をクリックします。

8. 「データのロード」でアップロード・ファイルを選択する場合は、次の変更を行います。

- テキスト・ファイル: ロードするテキスト・ファイルの名前を参照するか、入力します。

- セパレータ: 列セパレータ文字を入力します。詳細は、アイテム・ヘルプを参照してください。

- 囲み文字(オプション): データにデリミタ文字が含まれている場合は、それをここに入力します。詳細は、アイテム・ヘルプを参照してください。

- 1行目のデータに列名が含まれる: データの1行目が列名である場合にこのボックスを選択します。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。詳細は、アイテム・ヘルプを参照してください。

9. 「コピー・アンド・ペースト」を選択した場合、「データ」で次の変更を行います。

- データ: アップロードするテキスト・ファイルを入力します。

- 1行目のデータに列名が含まれる: データの1行目が列名である場合にこのボックスを選択します。

10. 「グローバリゼーション」で、次の変更を行います。

- 通貨記号: データに国際通貨記号が含まれている場合は、それをここに入力します。詳細は、アイテム・ヘルプを参照してください。

- グループ・セパレータ: データに整数グループを区切る文字が含まれている場合(たとえば千の位や百万の位を示す場合など)、それをここに入力します。詳細は、アイテム・ヘルプを参照してください。

- 小数点文字: データに整数部分と小数部分を区切る文字が含まれている場合は、それをここに入力します。詳細は、アイテム・ヘルプを参照してください。

11. 「次へ」をクリックします。
表のプロパティ・ページが表示されます。データのアップロードを実行する前に、このページで、必要に応じてデータをカスタマイズできます。

12. 「表のプロパティ」で次の変更を行って、「次へ」をクリックします。

- スキーマ: ロードする表が含まれているスキーマを選択します。

- 表名: 作成する表の名前を指定します。デフォルトでは、表の名前はすべて大文字に変換されます。「大/小文字を保持」を選択して、このデフォルトの動作を上書きします。

- 列名: 列の名前を入力します。

- データ型: この列のデータ型を選択します。

- 列長: この列のデータの長さを入力します。

- アップロード: この列のデータをアップロードする場合は「はい」を選択します。この列のデータはアップロードせずに、次の列にスキップする場合は「いいえ」を選択します。

13. 「主キー」で次の変更を行います。

- 主キーの移入元: 既存の列または新しい列の作成を選択して、主キー列を定義します。オプションは次のとおりです。

- 「既存の列を使用」: 既存の列を選択する場合は、ロードする列の中から列を選択する必要があります。

- 新しい列の作成: 新しい列の作成を選択した場合は、新しい列の名前を指定する必要があります。

- 制約名: 制約名は、デフォルトではテーブル名の末尾に_PKが付いた名前になります。必要に応じて名前を更新できます。

- 主キーの移入: 主キーが移入される方法を決定する必要があります。新しい順序から生成するか、まったく生成しません。オプションは次のとおりです。

- 新しい順序から生成: 新しい順序を選択した場合、指定した順序名を使用することも、必要に応じてそれを更新することもできます。順序が作成されます。

- 既存の順序から生成: 既存の順序を選択した場合、現在スキーマで定義されている順序から選択する必要があります。
順序(新規または既存)から主キーを生成すると、ウィザードは表にトリガーを作成して、次の順序値を取得し、レコードの挿入時に主キーを移入します。

- 生成しない

14. 「データのロード」をクリックします。

4.2.3.2 XML文書のロード

Oracle Application Expressでは、Oracleの標準的なXML形式のXML文書をサポートしています。

Oracleの標準的なXML形式では、各要素が列の値を表し、列から各要素の名前が付けられ、同じ行を構成するすべての要素が<ROW>要素の子であり、すべての<ROW>要素が<ROWSET>要素の子です。

XML文書をロードするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データ・ワークショップ」をクリックします。

4. 「XMLデータ」をクリックします。
XMLデータのロード・ウィザードが表示されます。

5. データの適切なスキーマを選択し、「次へ」をクリックします。

6. データをロードする表を選択し、「次へ」をクリックします。

7. 画面に表示されるステップに従います。

4.2.4 データのアンロード

アンロード・ページを使用して、表のコンテンツをテキスト・ファイルまたはXML文書にエクスポートできます。

内容は次のとおりです。

- テキスト・ファイルのアンロード

- XML文書へのアンロード

参照:
「正しいインポート/エクスポート/ロード/アンロード・オプションの選択」

4.2.4.1 テキスト・ファイルのアンロード

テキストへのアンロード・ウィザードを使用して、表のコンテンツをテキスト・ファイルにエクスポートします。たとえば、表全体をカンマ区切りファイル(.csv)にエクスポートできます。

表をテキスト・ファイルにアンロードするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データ・ワークショップ」をクリックします。

4. 「データ・アンロード」で「テキストへ」をクリックします。
テキストへのアンロード・ウィザードが表示されます。

5. 適切なスキーマを選択し、「次へ」をクリックします。

6. アンロードする表を選択し、「次へ」をクリックします。

7. 含める列をハイライトし、必要に応じて「WHERE句」に入力してアンロードするレコードを制限し、「次へ」をクリックします。

8. 「オプション」に次を入力します。

- セパレータ: 列の値の区切りに使用するセパレータのタイプを入力します。

- 囲み文字(オプション): データにデリミタ文字が含まれている場合は、それをここに入力します。詳細は、アイテム・ヘルプを参照してください。

- 列名を含める: テキスト・ファイルの各列の名前を含める場合は、このボックスを選択します。詳細は、アイテム・ヘルプを参照してください。

- ファイル形式: 適切なファイル形式を選択します。詳細は、アイテム・ヘルプを参照してください。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。詳細は、アイテム・ヘルプを参照してください。

9. 「データのアンロード」をクリックします。
「ファイルのダウンロード」ウィンドウが表示されます。

10. 「保存」をクリックして、ファイルをダウンロードします。

4.2.4.2 XML文書へのアンロード

XMLへのアンロード・ウィザードを使用して、表のコンテンツを標準XML仕様に準拠したXML文書にエクスポートします。

表をXML文書にアンロードするには、次のステップを実行します。

1. ワークスペースのホームページで「ユーティリティ」アイコンをクリックします。

2. 「データ・ワークショップ」をクリックします。

3. 「データ・アンロード」で「XMLへ」をクリックします。
XMLへのアンロード・ウィザードが表示されます。

4. 適切なスキーマを選択し、「次へ」をクリックします。

5. アンロードする表を選択し、「次へ」をクリックします。

6. 含める列をハイライトします。

7. 出力をファイルに直接保存する場合は、「ファイルとしてエクスポート」を選択します。
「ファイルとしてエクスポート」を選択しない場合、XML文書はブラウザに表示され、必要に応じてファイルに保存したり、カット・アンド・ペーストすることができます。

8. 必要に応じて、「WHERE句」を入力してアンロードするレコードを制限し、「データのアンロード」をクリックします。
ブラウザにXMLデータが表示されます。

4.2.5 リポジトリの使用

ロードされたテキスト・データ・ファイルとスプレッドシートは、リポジトリに格納されます。

別のリポジトリにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで「ユーティリティ」アイコンをクリックします。

2. 「データ・ワークショップ」をクリックします。

3. 次のいずれかを選択します。

- インポート・リポジトリ: ロードされたテキスト・データのステータスが表示されます。「詳細」には、ファイル名、インポート者、インポート日、スキーマ、表、バイト数、正常にロードされた行数と正常にロードされなかった行数が含まれます。
詳細の虫眼鏡をクリックすると、失敗した行を確認できます。

- スプレッドシートのインポート: ロードされたスプレッド・シートのステータスが表示されます。「詳細」には、ファイル名、インポート者、インポート日、スキーマ、表、バイト数、正常にロードされた行数と正常にロードされなかった行数が含まれます。
詳細の虫眼鏡をクリックすると、失敗した行を確認できます。

4. 表示にフィルタを適用するには、「表示」リストでフィルタを選択して、「実行」をクリックします。

5. 特定のファイルの詳細を表示するには、「ビュー」アイコンをクリックします。

6. インポートされたファイルを削除するには、そのファイルのチェック・ボックスを選択して「チェックした項目の削除」をクリックします。

4.3 DDLの生成

Oracle Application Expressを使用して、Oracleデータ・ディクショナリからデータ定義言語(DDL)文を生成できます。これらのスクリプトを使用して、データベース・スキーマ・オブジェクトを作成または再作成できます。スクリプトを生成し、インライン表示またはスクリプト・ファイルとして保存できます。すべてのオブジェクトの作成スクリプトは、特定のスキーマ、特定のオブジェクト・タイプ、または特定のオブジェクト用に生成できます。

DDL文を生成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「DDLの生成」をクリックします。
DDLの生成ページが表示されます。

4. 「スクリプトの作成」をクリックします。
DDLの生成ウィザードが表示されます。

5. データベース・スキーマを選択して「次へ」をクリックします。

6. オブジェクト・タイプを定義します。

1. 出力: 出力形式を指定します。「インライン表示」または「スクリプト・ファイルで保存」のいずれかを選択します。

2. すべてをチェック: このオプションを選択するとDDLを生成するすべてのオブジェクト・タイプが含まれます。

3. オブジェクト・タイプ: DDLを生成するオブジェクト・タイプを選択します。

4. 選択したオブジェクト・タイプのオブジェクト名を選択するには、「次へ」をクリックして画面に表示されるステップに従います。

7. 「DDLの生成」をクリックします。

参照:

- DDL文の詳細は、Oracle Database SQL言語リファレンスを参照してください

- データ・ディクショナリの詳細は、Oracle Database概要のデータ・ディクショナリを参照してください

4.4 表のメソッドの管理

表のメソッドの管理ユーティリティを使用すると、指定した表に基づいて、Application Programming Interface(パッケージ)を作成できます。

パッケージを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「表のメソッド」をクリックします。
表APIの作成ページが表示されます。

4. パッケージ名を入力します。最終的なパッケージ名を「パッケージ名」フィールドで使用した大/小文字表記に一致させるには、「大/小文字を保持」→「次へ」をクリックします。

5. PL/SQLパッケージベースのApplication Program Interface (API)の生成対象となる表を選択して、「次へ」をクリックします。

6. 確認ページが表示され、サブプログラムとその説明が表示されます。仕様部または本体は、表示またはダウンロードすることもできます。確定するには、「パッケージの作成」をクリックします。

4.5 ユーザー・インタフェースのデフォルト値の管理

ユーザー・インタフェースのデフォルト値を使用して、リージョンおよびアイテムのデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。このウィザードでは、ユーザー・インタフェースのデフォルト値が存在する場合にそれを使用するかどうかを指定できます。ウィザードを使用してフォームまたはレポートを作成する場合、ウィザードはこの情報を使用してリージョン・プロパティおよびアイテム・プロパティのデフォルト値を作成します。ユーザー・インタフェースのデフォルト値を使用すると、貴重な開発時間を節約でき、さらにアプリケーション内の複数のページで一貫性を保つことができるという利点もあります。ユーザー・インタフェースのデフォルト値は、表ディクショナリと属性ディクショナリの2つのカテゴリに分類されます。

- 表ディクショナリでは、データベース定義から初期化される表と列のデフォルトを指定できます。

- 属性ディクショナリでは、属性または列名に基づいてデフォルトを作成できるため、すべての表で使用できます。属性の定義はシノニムにすることもでき、複数の属性で共通の定義を共有することができます。

ページおよびリージョンの作成時に、ユーザー・インタフェースのデフォルト値を使用する場合、属性ディクショナリよりも表ディクショナリの方が優先されます。表と列の組合せが存在する場合、同じ名前の属性定義ではなく、その組合せが使用されます。たとえば、emp表のCREATED_BY列に特定のラベルまたはヘルプ・テキストが必要な場合に、別の表のCREATED_BYのより一般的なデフォルトを使用するときに便利です。

内容は次のとおりです。

- 表のユーザー・インタフェースのデフォルト値の作成

- 表のユーザー・インタフェースのデフォルト値の変更

- ユーザー・インタフェース属性の作成

- ユーザー・インタフェース属性の変更

- ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

4.5.1 表のユーザー・インタフェースのデフォルト値の作成

表に対してデフォルトを作成していない場合、表ディクショナリのデフォルトの作成ウィザードを使用して、データベース表と列定義に基づいて自動的にデフォルトを生成します。最初のデフォルトが作成された後に、個々のデフォルト値を変更できます。「表のユーザー・インタフェースのデフォルト値の変更」を参照してください。

表の最初のユーザー・インタフェースのデフォルト値を作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
「ユーザー・インタフェースのデフォルト値」のダッシュボード・ページが表示されます。

カレント・スキーマがブレッドクラム・メニューの右に表示されます。

4. 「表ディクショナリの管理」をクリックします。
表ディクショナリ・ページに、「デフォルト値あり」列を含むワークスペースのすべてのオブジェクトのレポートが表示され、デフォルトが各オブジェクトに作成されたかどうかが示されます。

5. デフォルトを作成するオブジェクト名をクリックします。
表ディクショナリのデフォルト値の作成ページが表示されます。

6. 「デフォルトの作成」をクリックします。
表ディクショナリ・ページに、選択したオブジェクトにデフォルトが存在することを示すレポートが表示されます。

注意:
デフォルトとデータベースのデータ・ディクショナリを同期化すると、まだデフォルトを持たない現在のスキーマ内の任意の表に対して表ベースのデフォルトが作成され、データベース定義と一致する表のデフォルトが調節されます。

4.5.2 表のユーザー・インタフェースのデフォルト値の変更

既存の表デフォルトを変更するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
「ユーザー・インタフェースのデフォルト値」のダッシュボード・ページが表示されます。

カレント・スキーマがブレッドクラム・メニューの右に表示されます。

4. 「表ディクショナリの管理」をクリックします。
表ディクショナリ・ページに、「デフォルト値あり」列を含むワークスペースのすべてのオブジェクトのレポートが表示され、デフォルトが各オブジェクトに作成されたかどうかが示されます。

5. 変更するオブジェクト名をクリックします。
表プロパティおよび列プロパティ・ページに、列のデフォルトのレポートが表示されます。

6. 変更する列名をクリックします。
列のデフォルト値ページが表示されます。

7. 変更し、「変更の適用」をクリックします。
このページの各設定の説明については、アイテム・ヘルプを参照してください。

注意:
表ディクショナリから列を削除できます。削除すると、作成プロセス中に属性ディクショナリのデフォルト値が使用されるようになります。たとえば、CREATED_BYおよびCREATED_ONのすべてのインスタンスで同一のラベルとヘルプが必要な監査列がある場合に、その表がどこに属するかに関係なく、各表のその列から列のデフォルト値を簡単に削除できます。

4.5.3 ユーザー・インタフェース属性の作成

属性ディクショナリの作成ウィザードを使用して、新しい属性を定義し、追加します。

次の手順で、属性を作成します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
「ユーザー・インタフェースのデフォルト値」のダッシュボード・ページが表示されます。

カレント・スキーマがブレッドクラム・メニューの右に表示されます。

4. 「属性ディクショナリの管理」をクリックします。
属性ディクショナリ・ページには、ワークスペースのすべての属性のレポートが表示されます。

5. 「作成」をクリックします。
列の詳細ページが表示されます。

6. 属性の仕様を入力し、「作成」をクリックします。
このページの各設定の説明については、アイテム・ヘルプを参照してください。

4.5.4 ユーザー・インタフェース属性の変更

既存の属性を変更するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
「ユーザー・インタフェースのデフォルト値」のダッシュボード・ページが表示されます。

カレント・スキーマがブレッドクラム・メニューの右に表示されます。

4. 「属性ディクショナリの管理」をクリックします。
属性ディクショナリ・ページには、ワークスペースのすべての属性のレポートが表示されます。

5. 表示されたすべての列の選択した属性を編集するには、次のステップを実行します。

1. 「グリッド編集」をクリックします。

2. 該当する属性を編集し、「変更の適用」をクリックします。

6. 特定の列を編集するには、変更する属性の編集アイコンをクリックします。
列の詳細ページが表示されます。

注意:
シノニムを編集する場合(Synonym of列を移入することで識別)、ベース列の定義を編集することになります。これは、ベース列とすべてのシノニムが1つの定義を共有するためです。シノニムを削除するには、シノニム・リージョン内のシノニムを選択します。ベース列を削除すると、その列とすべてのシノニムが削除されます。

7. 変更し、「変更の適用」をクリックします。
このページの各設定の説明については、アイテム・ヘルプを参照してください。

4.5.5 ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

関連するアプリケーション・ファイルのエクスポートと同様の方法でユーザー・インタフェースのデフォルト値をエクスポートします。1つの開発インスタンスから別のインスタンスへユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. ユーザー・インタフェースのデフォルト値のエクスポート・ユーティリティを使用してユーザー・インタフェースのデフォルト値をエクスポートします。『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のユーザー・インタフェースのデフォルト値のエクスポートに関するセクションを参照してください。

2. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のユーザー・インタフェースのデフォルト値のインポートに関するセクションを参照してください。

3. エクスポートされたファイルをエクスポート・リポジトリからインストールします。Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドの「エクスポート・ファイルのインストール」を参照してください。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのスクリプトにエクスポートされます。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

4.6 データベースの詳細の表示

データベースのバージョン情報ページでデータベースの詳細を表示できます。

データベースの詳細にアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 追加の「ユーティリティ」で「データベースについて」をクリックします。

4. 入力を求められた場合は、適切な管理者のユーザー名とパスワードを入力して「ログイン」をクリックします。
データベースのバージョン情報ページが表示されます。

5. インストール済オプション、現在使用されている機能または各国語サポートの詳細情報を表示するには、次のチェック・ボックスのいずれかを選択して「実行」をクリックします。

- バージョン

- 設定

- オプション

- 各国語サポート

- CGI環境

- パラメータ

4.7 スキーマの比較

2つのスキーマのデータベース・オブジェクトを比較し、それらの差分を表示するレポートを実行できます。スキーマ内のすべてのオブジェクトを比較するか、またはレポートを特定のオブジェクトに制限できます。2つのスキーマを比較するには、両方がワークスペースで使用可能である必要があります。

例:

- ネーミング規則を検索することによりDEMO_ objectsを比較します。レポートはオブジェクトが2つのスキーマのそれぞれに存在するかどうかを示します。

- 2つのスキーマのオブジェクトの詳細を分析して、一方の実装が異なる理由を判別します。たとえば、レポートには一方のスキーマの索引に追加の列や異なるデータ型の列があることが示されます。

スキーマを比較するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 追加の「ユーティリティ」で「スキーマの比較」をクリックします。

4. スキーマの比較ページで、比較を実行する選択をします。

- 「スキーマ1」および「スキーマ2」: 比較するスキーマを選択します。

- 比較: 1つのオブジェクト・タイプを表示するようにレポートを制限するか、「すべて」を選択してすべてのデータベース・オブジェクトを表示します。

- 検索: 大/小文字を区別しないオブジェクト名を入力します。

- 行: レポートに表示される行数を変更するには、「表示」リストから選択します。

- 比較: 「実行」をクリックして選択に合う結果を検索します。

- 「差分のみ表示」または「詳細の表示」: 確認する情報のタイプを選択します。

4.8 オブジェクト・レポートの表示

ユーティリティには、データベース内のオブジェクトをより効率的に管理できる様々なオブジェクト・レポートが含まれます。

内容は次のとおりです。

- 表レポート

- セキュリティ・レポート

- PL/SQLレポート

- 例外レポート

- すべてのオブジェクト・レポート

4.8.1 表レポート

表レポートを使用して、データベース内の表の特定の詳細を表示します。

表レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「表レポート」セクションで、表示するレポートを選択します。

- 表の列

- 表のコメント

- 表の制約

- 表の統計

- 表の記憶域サイズ

5. レポートをフィルタ処理するには、提供されるフィールドに検索基準を入力するか、リストから選択し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.2 セキュリティ・レポート

「セキュリティ」レポートを使用すると、他のスキーマによって所持されるデータベース・オブジェクトで付与されたオブジェクトまたは列を表示できます。また、これらのレポートを使用して、データベース・ロールおよびシステム権限も表示できます。

「セキュリティ」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「セキュリティ・レポート」セクションで、次の表示するレポートをクリックします。

- オブジェクト権限付与: 既存のスキーマの権限を表示するとともに、選択したスキーマから他のスキーマへ付与された権限を理解できます。

- 列権限: スキーマ内の列の権限を表示します。また、選択したスキーマから他のスキーマへ付与された権限を理解できます。

- ロール権限: 選択したスキーマに付与されたデータベース・ロールを表示します。ロールは様々な権限のコレクションです。

- システム権限: 選択したスキーマに付与されたデータベース権限を表示します。

5. レポートをフィルタ処理するには、提供されるフィールドに検索基準を入力するか、リストから選択し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.3 PL/SQLレポート

「PL/SQLレポート」を使用して、プログラム・ユニット引数またはユニット行数を表示し、PL/SQLソース・コードを検索します。

内容は次のとおりです。

- プログラム・ユニット引数

- ユニット行数

- PL/SQLソース・コードの検索

4.8.3.1 プログラム・ユニット引数

プログラム・ユニット引数レポートを使用して、パッケージの入出力パラメータを表示します。

PL/SQLプログラム・ユニット引数を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「PL/SQLレポート」セクションで、「プログラム・ユニット引数」をクリックします。

5. レポートをフィルタ処理するには、提供されるフィールドに検索基準を入力するか、リストから選択し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.3.2 ユニット行数

「ユニット行数」レポートを使用して、各オブジェクトのコードの行数を表示します。このレポートは、大きいPL/SQLプログラム・ユニットの識別に使用します。

ユニット行数のレポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「PL/SQLレポート」セクションで、「ユニット行数」をクリックします。

5. レポートをフィルタ処理するには、オブジェクト名を入力し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.3.3 PL/SQLソース・コードの検索

PL/SQLソース・コードを検索ページを使用して、PL/SQLコード内のテキストを検索します。このレポートは、削除する表またはファンクションへの参照の検索に使用します。また、このページを使用して、コード・スニペットのみを再コールできるときにコードを検索することもできます。

PL/SQLソース・コードを検索するには、次のステップを実行します。

1. ワークスペースのホームページで「ユーティリティ」アイコンをクリックします。

2. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

3. 「PL/SQLレポート」セクションで、「PL/SQLソース・コードを検索」をクリックします。

4. レポートにフィルタを適用するには、次のステップを実行します。

1. 開始/終了行に、検索する行の範囲を入力します。

2. 「設定」をクリックします。

3. レポートをフィルタ処理するには、オブジェクト名を入力し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

5. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.4 例外レポート

「例外レポート」を使用して、索引付けされていない外部キーおよび主キー、索引、トリガーのない表が表示されます。

例外レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「例外レポート」」セクションで、表示するレポートをクリックします。

- 主キーなしの表

- 索引なしの表

- 索引付けされていない外部キー

- トリガーなしの表

5. レポートをフィルタ処理するには、テーブル名を入力し、「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

4.8.5 すべてのオブジェクト・レポート

すべてのオブジェクト・レポートを使用して、選択したスキーマのオブジェクトを表示します。

すべてのオブジェクト・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「オブジェクト・レポート」をクリックします。
オブジェクト・レポート・ページが表示されます。

4. 「すべてのオブジェクト・レポート」セクションで、表示するレポートをクリックします。

- すべてのオブジェクト: 現在のスキーマのすべてのオブジェクトをリストします。作成日と最後にDDL(データ定義言語)が実行された時期が表示されます。

- 無効なオブジェクト: データベース内の無効なオブジェクトをオブジェクト・タイプごとに表示します。

- オブジェクト作成カレンダ: すべてのオブジェクトを、各データベース・オブジェクトの作成日を基に、カレンダ形式で表示します。

- タイプ別オブジェクト数: データベース・オブジェクトの数を選択したスキーマのタイプごとに表示します。

- データ・ディクショナリ: このデータベースのデータ・ディクショナリを表示します。
Oracleデータ・ディクショナリは、データベースを参照するために読取り専用で使用する表およびビューのセットです。たとえば、データ・ディクショナリにはデータベースの論理構成と物理構成の情報が格納されています。

また、データ・ディクショナリには有効なOracle Databaseユーザー、データベース内の表の整合性制約、スキーマ・オブジェクトに割り当てられた領域の合計および使用領域に関する情報も格納されます。

5. 「すべてのレポート」で、レポートのフィルタ処理を実行できます。

1. オブジェクト・タイプを選択します。

2. オブジェクト名を入力します。

3. 「実行」をクリックします。詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. 別のスキーマのレポートを表示するには、ページの右上の「スキーマ」リストからスキーマを選択します。

参照:
データ・ディクショナリについては、Oracle Database概要を参照してください

4.9 データベースの監視

データベース監視ページで使用可能なレポートには、データベース・セッション、システム統計、SQL文および長時間操作に関するデータベース全体のビューが表示されます。これらのレポートを使用すると、パフォーマンスの悪いSQLを識別したり、データベースのワークロードについてより深く理解することができます。

データベース監視ページのアイコンにアクセスするには、データベース管理者ロールを付与されたアカウントが必要です。

内容は次のとおりです。

- セッション

- システム統計について

- 上位のSQLについて

- 長時間操作について

4.9.1 セッション

セッションとは、ユーザーとOracleのデータベース・インスタンスの接続のことです。セッションは、ユーザーが接続してから、ユーザーが切断またはデータベース・アプリケーションを終了するまで存続します。

セッション・ページへアクセスするには、データベース管理者権限が必要です。

セッション・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データベース監視」をクリックしてください。

4. 「セッション」をクリックします。

5. 入力を求められた場合は、適切なデータベース管理者のユーザー名とパスワードを入力して「ログイン」をクリックします。
セッション・ページが表示されます。

6. レポートを表示するには、ページ上部にある次のタブのいずれかを選択します。

- セッション

- ロック

- 待機

- I/O

- SQL

- オープン・カーソル

次のセクションでは、各レポートについて説明します。

4.9.1.1 「セッション」レポート

「セッション」レポートにはデータベースの現行セッションについての情報が表示されます。ビューを絞り込むには、ページ上部にある次のコントロールを使用します。

- 検索:検索基準を入力して「実行」をクリックします。検索の詳細は、「検索」ラベルをクリックします。

- ステータス: ステータスを選択して「実行」をクリックします。

- 表示: 表示する列数を選択して「実行」をクリックします。

- 行: レポートに表示する行数を選択して「実行」をクリックします。

セッションの詳細を表示するには、セッションID(SID)をクリックします。セッションの詳細ページが表示されます。現行セッションを削除するには、セッションの詳細ページにナビゲートして「セッションの中断」をクリックします。

4.9.1.2 「ロック」レポート

「ロック」レポートには、他のセッションをブロックしているロックが存在するセッションのレポートが表示されます。表示される行数を制御するには、「行」リストから選択して「実行」をクリックします。

4.9.1.3 「待機」レポート

「待機」レポートには各セッションの待機イベントが表示されます。ビューを絞り込むには、ページ上部にある次のコントロールを使用します。

- 検索:検索基準を入力して「実行」をクリックします。検索の詳細は、「検索」ラベルをクリックします。

- ステータス: ステータスを選択して「実行」をクリックします。

- 表示: 表示する列数を選択して「実行」をクリックします。

- 行: レポートに表示する行数を選択して「実行」をクリックします。

セッションの詳細を表示するには、セッションID(SID)をクリックします。セッションの詳細ページが表示されます。現行セッションを削除するには、「セッションの中断」をクリックします。

4.9.1.4 「I/O」レポート

I/Oレポートには、各セッションのI/Oの詳細が表示されます。ビューを絞り込むには、ページ上部にある次のコントロールを使用します。

- 検索:検索基準を入力して「実行」をクリックします。検索の詳細は、「検索」ラベルをクリックします。

- 行: レポートに表示する行数を選択して「実行」をクリックします。

セッションの詳細を表示するには、セッションID(SID)をクリックします。セッションの詳細ページが表示されます。現行セッションを削除するには、「セッションの中断」をクリックします。

4.9.1.5 「SQL」レポート

SQLレポートには、各セッションの現行のSQL文または最後に実行されたSQL文の詳細が表示されます。ビューを絞り込むには、ページ上部にある次のコントロールを使用します。

- 検索:検索基準を入力して「実行」をクリックします。検索の詳細は、「検索」ラベルをクリックします。

- ステータス: ステータスを選択して「実行」をクリックします。

- 表示: 表示する列数を選択して「実行」をクリックします。

- 行: レポートに表示する行数を選択して「実行」をクリックします。

セッションの詳細を表示するには、セッションID(SID)をクリックします。セッションの詳細ページが表示されます。現行セッションを削除するには、「セッションの中断」をクリックします。

4.9.1.6 オープン・カーソル

「オープン・カーソル」レポートには、各セッションのオープン・カーソル数の詳細が表示されます。ビューを絞り込むには、ページ上部にある次のコントロールを使用します。

- 検索:検索基準を入力して「実行」をクリックします。検索の詳細は、「検索」ラベルをクリックします。

- ステータス: ステータスを選択して「実行」をクリックします。

- 行: レポートに表示する行数を選択して「実行」をクリックします。

特定のオープン・カーソル数の詳細を表示するには、「オープン・カーソル数」列の下の数字のリンクをクリックします。

セッションの詳細を表示するには、セッションID(SID)をクリックします。セッションの詳細ページが表示されます。現行セッションを削除するには、「セッションの中断」をクリックします。

4.9.2 システム統計について

システム統計ページには、次の統計が表示されます。

- 物理I/O:物理I/Oは、ディスク・アクセスが必要なI/Oです。このレポートには、物理的な読取りおよび書込みに関するディスク・アクセス統計が表示されます。

- 論理I/O: 論理I/Oは、メモリーまたはディスク内で十分なI/Oです。一貫性読取りまたは現行モードの読取りであるバッファ読取りの合計が表示されます。Redoは、変更に関する情報を含むSGA内のバッファです。

- メモリー統計: データベースのメモリー消費が表示されます。

- 時間統計:データベースで消費される様々な時間が表示されます。

- SQLカーソル統計: データベース内のカーソルについての統計が表示されます。

- トランザクション統計: 実行されたトランザクション数が表示されます。

システム統計ページを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データベース監視」をクリックしてください。

4. 「システム統計」をクリックします。

5. 入力を求められた場合は、適切な管理者のユーザー名とパスワードを入力して「ログイン」をクリックします。
システム統計ページが表示されます。

システム統計ページの追加コントロールには、次のものがあります。

- レポートのリフレッシュ: 「システム統計」レポートをリフレッシュします。

- 統計を保存: 現在のレポートを保存します。

- 現在の値と保存された値のデルタの表示: 実際の統計値を表示するか、保存された値と現在の値の差分を表示するには、このチェック・ボックスをクリックします。

参照:
『Oracle Databaseパフォーマンス・チューニング・ガイド』

4.9.3 上位のSQLについて

上位のSQL文とは、最も多く実行されるSQL文、その他のSQL文よりも多くのシステム・リソースを使用するSQL文、またはその他のSQL文よりも頻繁にシステム・リソースを使用するSQL文を表します。

上位SQLページを使用して、パフォーマンスの悪いSQLを識別します。

上位SQLページを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データベース監視」をクリックしてください。

4. 「上位SQL」をクリックします。

5. 入力を求められた場合は、適切な管理者のユーザー名とパスワードを入力して「ログイン」をクリックします。
上位SQLページが表示されます。表示を絞り込むには、ページ上部の検索フィールドおよびリストを使用し、「実行」をクリックします。各フィールドまたはリストの詳細は、ラベルをクリックします。

6. SQL計画ページにアクセスするには、 「ビュー」アイコンをクリックします。
図view_icon.gifの説明

SQL計画ページが表示され、次のセクションが含まれます。

- 問合せ計画: 色分けされた実行計画が含まれています。索引付けされていない列は赤で表示されることに注意してください。

- SQLテキスト: SQL文の全文が表示されています。

- 索引: 問合せの表のすべての索引が表示されます。索引が問合せに使用されている場合は、チェックマークが付いています。

- 表の列: すべての問合せの表またはビューのすべての列が表示されます。

4.9.4 長時間操作について

長時間操作ページには、6秒(絶対時間)より長く実行されている様々な操作のステータスが表示されます。現在、これらの操作には多くのバックアップおよびリカバリ機能、統計収集、および問合せ実行が含まれており、さらに多くの操作がOracleのリリースごとに追加されます。

長時間操作ページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「データベース監視」をクリックしてください。

4. 「長時間操作」をクリックします。

5. 入力を求められた場合は、適切な管理者のユーザー名とパスワードを入力して「ログイン」をクリックします。

6. 参照:
Oracle DatabaseリファレンスのV$SESSION_LONGOPS

4.10 ごみ箱を使用した、削除されたオブジェクトの表示およびリストア

ごみ箱を使用して、削除したデータベース・オブジェクトを表示およびリストアできます。表を削除する場合、表に関連付けられた領域はすぐには削除されません。Oracle Databaseは表の名前を変更し、表および関連オブジェクトをごみ箱に置きます。ごみ箱内のオブジェクトは、あとで回復できます。

内容は次のとおりです。

- ごみ箱内のオブジェクトの管理

- オブジェクトを表示せずにごみ箱を空にする

注意:
ごみ箱機能は、Oracle Database 10g以上のデータベースを実行している場合にのみ使用可能です。

参照:
『Oracle Database 2日でデータベース管理者』の「バックアップおよびリカバリの実行」

4.10.1 ごみ箱内のオブジェクトの管理

削除されたオブジェクト・ページでごみ箱内のオブジェクトを表示できます。オブジェクトを選択してオブジェクトの詳細ページを表示すると、該当するボタンをクリックしてオブジェクトをパージまたはリストアできます。

ごみ箱内のオブジェクトを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ごみ箱」をクリックします。

4. 「削除されたオブジェクト」をクリックします。
削除されたオブジェクト・ページが表示されます。

5. 詳細は、『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の対話モード・レポートのカスタマイズに関するセクションを参照してください。

6. レポートにフィルタを適用するには、オブジェクト・タイプを選択し、「元の名前」フィールドにオブジェクト名を入力して、「実行」をクリックします。

7. オブジェクトの詳細を表示するには、オブジェクト名をクリックします。
オブジェクトの詳細ページが表示されます。

8. 現行オブジェクトをリストアするには、「オブジェクトをリストア」をクリックします。

9. 現行オブジェクトを完全に削除するには、「オブジェクトの消去」をクリックします。

4.10.2 オブジェクトを表示せずにごみ箱を空にする

オブジェクトを表示せずにごみ箱を空にするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ごみ箱」をクリックします。

4. 「ごみ箱を空にする」をクリックします。
ごみ箱を空にするページが表示されます。

5. 「ごみ箱を空にする」を再度クリックしてリクエストを確認します。

5 RESTfulサービスの使用

RESTfulサービスは、データベースへのアクセスに使用されるRESTfulサービスの宣言仕様を有効にします。これらのサービスは、Oracle Application Expressリスナーとともに動作し、これらのサービスを使用できるようにします。この項では、RESTfulサービスを作成、編集および削除する方法について説明します。

注意:
インスタンス管理者がこのApplication Expressインスタンスに対してRESTfulサービスを無効にしている場合、このインスタンスでRESTfulサービスが使用できないため、RESTfulサービス・アイコンが表示されません。『Oracle Application Express管理ガイド』のSQLワークショップの構成に関する説明を参照してください。

内容は次のとおりです。

- RESTの概要

- RESTfulサービスについて

- RESTfulサービスの要件

- RESTfulサービスへのアクセス

- RESTfulサービス・モジュールの例(oracle.example.hr)について

- RESTfulサービス・モジュールの管理

- リソース・テンプレートの管理

- リソース・ハンドラの管理

5.1 RESTの概要

Representational State Transfer (REST)は、World Wide Webのような分散ハイパーメディア・システムのためのソフトウェア・アーキテクチャのスタイルの1つです。RESTの原則に準拠するサービスは、RESTfulと呼ばれます。RESTの詳しい説明はこのマニュアルの対象外ですが、次に、RESTfulサービスの特性を示します。

- データは一連のリソースとしてモデル化されます。リソースはURLで識別されます。

- リソースの操作には、一連の小さな操作が使用されます(PUT、POST、GET、DELETEなど)。

- リソースは、複数の形式で表示できます(たとえば、ブログは、HTML形式およびRSS形式で表示できます)。

- サービスはステートレスですが、クライアントが関連リソースにアクセスできるように、返される表示で、通常はハイパーテキスト・リンクによって関連リソースを示す必要があります。

5.2 RESTfulサービスについて

RESTfulサービスによって、他のアプリケーションがアクセスできるWebサービスにアプリケーションが公開され、データを交換します。たとえば、RESTfulサービスを構成して、特定の部門のすべての従業員名を返すことができます。RESTfulサービスのデータ交換は、Representational State Transfer (REST)アーキテクチャ・スタイルに従います。

アプリケーションで提供する各Webサービスに対して、RESTfulサービス・モジュールを構成する必要があります。このモジュールは、よく使うテンプレートを共通のUniversal Resource Identifier (URI)接頭辞でグループ化したものです。このWebサービスで公開する同一のリソース・テンプレートの接頭辞に関連付けられている各メソッドに対して、リソース・ハンドラを定義する必要があります。たとえば、データを返すメソッドとデータを格納するメソッドを指定するには、それぞれの操作に対してリソース・ハンドラを定義する必要があります。

RESTfulサービスを作成する場合、実行するリクエスト、レスポンスおよび操作の構造について、次の情報を指定する必要があります。

- サービスで提供する一連のリソースを特定するURIテンプレート

- 実行するSQL問合せまたはPL/SQLブロックとともにサービスでサポートされる1つ以上のHTTPメソッド。GET、DELETE、POSTおよびPUTの4つのHTTPメソッドがあります。1つのHTTPメソッドに指定できるハンドラは1つのみです。たとえば、empinfoリソース・ハンドラには、GETを使用した1つのリソース・ハンドラのみ、およびPUTを使用した1つのリソース・ハンドラのみを指定できます。

- 問合せブロックのパラメータにバインドする必要があるHTTPヘッダーの値

- Webサービスに必要なパラメータ

- Webサービスに必要な入力のタイプ

- レスポンスの書式

参照:
RESTful Webサービス・モジュールの例は、「RESTfulサービス・モジュールの例(oracle.example.hr)について」を参照してください。

この項では、RESTfulサービスの構成方法について説明します。アプリケーションでWebサービスを使用するには、RESTful Web参照を構成する必要があります。『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』のWebサービスの実装に関する説明を参照してください。

5.3 RESTfulサービスの要件

RESTfulサービス・ユーティリティが使用可能になり、適切に機能するためには、次の要件を満たす必要があります。

- インスタンス管理者は、このApplication Expressインスタンスで、RESTfulサービスを有効にする必要があります。『Oracle Application Express管理ガイド』を参照してください。

- Oracle Application Expressリスナーのバージョン2.0以上を使用する必要があります。埋込みPL/SQLゲートウェイを使用するOracle XML DB HTTPサーバーおよびmod_plsqlを使用するOracle HTTPサーバーでは、この機能はサポートされません。Oracle Application Expressリスナー・インストレーションおよび開発者ガイドを参照してください。

5.4 RESTfulサービスへのアクセス

RESTfulサービスにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページにログインします。

2. 「SQLワークショップ」をクリックします。

3. 「RESTfulサービス」をクリックします。
図r_service.gifの説明

RESTfulサービスのホームページが表示されます。

5.5 RESTfulサービス・モジュールの例(oracle.example.hr)について

Application Expressワークスペースには、デフォルトで、RESTfulサービス・モジュールの例(oracle.example.hr)が含まれます。このモジュールは、emp表から従業員情報を取得して表示する複数の方法を実装するリソース・テンプレートおよびリソース・ハンドラの例を示します。oracle.example.hrモジュールにアクセスするには、「RESTfulサービスへのアクセス」を参照してください。

参照:
その他のRESTfulサービスの例については、Learning Libraryを参照してください。Oracle by Example(OBE)、デモ、チュートリアルなどの無料オンライン・トレーニング・コンテンツを検索します。次のURLでOracle Learning Libraryにアクセスしてください。
http://www.oracle.com/technetwork/tutorials/index.html

図hr_example.gifの説明

oracle.example.hrモジュールは、複数のリソース・テンプレートで構成されています。各リソース・テンプレートは、それぞれ異なった方法で、情報を取得して返される結果を書式設定します。

図oracle_ex_temp.gifの説明

次に、各GETリソース・ハンドラを起動した際に、各oracle.example.hrリソース・テンプレートで予期される結果を示します。

- empinfo/: 従業員のemp表から、従業員情報がCSV形式で返されます。「CSV形式での結果セットの返却(empinfo/)」を参照してください。

- employees/{id}: 従業員のemp表から、指定されたidに関する従業員情報が返されます。中括弧は、URIの一部として送信されるパラメータを示します。「パラメータに基づくデータの取得(employees/{id})」を参照してください。

- employees/: 従業員のemp表から、ページ区切りサイズが7に設定されたJSON形式で従業員情報が表示されます。最初、前および次へのリンクを使用して、結果を参照できます。「ページ区切りセットを使用したJSON形式での結果セットの取得(employees/)」を参照してください。

- employeesfeed/: 従業員のemp表から、従業員情報がフィードとして表示されます。「フィードとしての結果セットの返却(employeesfeed/)」を参照してください。

- employeesfeed/{id}: 従業員のemp表から、指定されたidに関する従業員情報がフィードとして表示されます。中括弧は、URIの一部として送信されるパラメータを示します。「パラメータに基づくデータの取得(employees/{id})」および「フィードとしての結果セットの返却(employeesfeed/)」も参照してください。

- empsec/{empname}: 指定された従業員名(empname)に関する従業員情報がJSONで返されて表示されます。中括弧は、URIの一部として送信されるパラメータを示します。「パラメータに基づくデータの取得(employees/{id})」も参照してください。

- empsecformat/{empname}: 指定された従業員名(empname)に関する従業員情報が、PL/SQLブロックの実行に基づいて返されて書式設定されます。中括弧は、URIの一部として送信されるパラメータを示します。「PL/SQLブロックに基づく結果セットの返却(empsecformat/{empname})」を参照してください。

5.5.1 CSV形式での結果セットの返却(empinfo/)

oracle.example.hrモジュールには、CSV形式でデータを返すRESTfulサービスを示すempinfo/リソース・テンプレートが含まれます。この例では、emp表の従業員データはすべて、SQL問合せを使用して返されます。

CSV形式でデータを取得するRESTfulサービス・モジュールの例を構築してテストするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「作成」をクリックします。

3. 「名前」に、my.example.demoと入力します。

4. 「URI」に、demo/と入力します。これは、このRESTfulサービスへのアクセスに使用されるUniform Resource Identifier (URI)のベースです。

5. 「リソース・テンプレートの追加」で、「URIテンプレート」にempinfo/と入力します。

6. 「リソース・ハンドラの追加」で、「方法」に「GET」を選択します。
リソース・ハンドラの設定が表示されます。

7. 次の選択およびエントリを行います。

- ソース・タイプ: 「問合せ」を選択します。SQL問合せを実行し、選択したフォーマットに応じて、JavaScript Object Notation (JSON)形式またはCSV形式に結果セットを変換します。このオプションは、HTTPメソッドのGETを選択した場合にのみ使用できます。

- 書式: 「CSV」を選択します。

- ソース: 次を入力します。

select * from emp

図emp_info.gifの説明

8. 「モジュールの作成」をクリックします。
RESTfulサービス・モジュールのページが表示されます。

9. empinfo/で、GETリソース・ハンドラをクリックします。

10. 「テスト」をクリックします。
オープン・ダイアログが表示され、リソース・ハンドラのソースSQL問合せの実行結果を含むCSVファイルを開くか、保存することができます。

11. 「ファイルを保存」を選択して、「OK」をクリックします。

12. 保存したCSVファイルの内容は、Microsoft Excelなどのエディタで開いて表示できます。
CSVファイルには、emp表のすべてのデータが含まれます。

図empinfo_results.gifの説明

注意:
結果が正しくない場合は、empinfo GETリソース・ハンドラとoracle.example.hr empinfo GETリソース・ハンドラを比較します。

13. 「変更の適用」をクリックします。

5.5.2 パラメータに基づくデータの取得(employees/{id})

oracle.example.hrモジュールには、指定されたidに基づく1行分のデータをJSON形式で返すRESTfulサービスを示すemployees/{id}リソース・テンプレートが含まれます。

指定されたパラメータに基づいて結果を返すリソース・テンプレートのその他の例は、oracle.example.hrサービス・モジュールのemployeesfeed/{id}、empsec/{empname}およびempsecformat/{empname}リソース・テンプレートを参照してください。

パラメータに基づいて従業員データを取得するリソース・テンプレートを追加してテストするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・テンプレートの追加先とするRESTfulサービス・モジュールをクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 左のパネル下部で、「テンプレートの作成」をクリックします。
「リソース・テンプレート」オプションが右側に表示されます。

4. 「URIテンプレート」に、employees/{id}と入力します。

5. 「作成」をクリックします。
employees{id}リソース・テンプレートが左のパネルに表示されます。

6. employees{id}リソース・テンプレートの下で、「ハンドラの作成」をクリックします。
「リソース・ハンドラ」オプションが表示されます。

7. 次の選択およびエントリを行います。

- 方法: 「GET」を選択します。

- ソース・タイプ: 「1行問い合せる」を選択します。1行分のデータをJSON形式で返すSQL問合せを1回実行します。このオプションは、HTTPメソッドのGETを選択した場合にのみ使用できます。

- セキュア・アクセスが必要: 「いいえ」を選択します。

- ページ区切りサイズ: 空白にします。ここでは、1つのレコードのみが取得されるため、ページ区切りを設定する必要はありません。

- ソース: 次を入力します。

select * from emp  where empno = :id

図employees_id.gifの説明

8. 「作成」をクリックします。
GETハンドラが左のパネルのemployees/{id}リソース・テンプレートの下に表示されます。

9. 「バインド変数の設定」をクリックします。

10. 「バインド変数値」に、7876と入力します。

11. 「テスト」をクリックします。
従業員IDが7876である従業員レコードに関する結果を示すダイアログが表示されます。

図employees_id_res.gifの説明

注意:
結果が正しくない場合は、employees/{id} GETリソース・ハンドラとoracle.example.hr employees/{id} GETリソース・ハンドラを比較します。

5.5.3 ページ区切りセットを使用したJSON形式での結果セットの取得(employees/)

oracle.example.hrモジュールには、JSON形式でデータを戻すRESTfulサービスを示すemployees/リソース・テンプレートが含まれます。この例では、ページ区切りを、結果で返される行数よりも小さい値に設定して実行します。

JSON形式で結果を返すリソース・テンプレートのその他の例は、oracle.example.hrサービス・モジュールのempsec/{empname}リソース・テンプレートを参照してください。

JSON形式でデータを取得してページ区切りを実行するリソース・テンプレートを追加してテストするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・テンプレートの追加先とするRESTfulサービス・モジュールをクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 左のパネル下部で、「テンプレートの作成」をクリックします。
「リソース・テンプレート」オプションが右側に表示されます。

4. 「URIテンプレート」に、employees/と入力します。

5. 「作成」をクリックします。
employees/リソース・テンプレートが左のパネルに表示されます。

6. employees/リソース・テンプレートの下で、「ハンドラの作成」をクリックします。
「リソース・ハンドラ」オプションが表示されます。

7. 次の選択およびエントリを行います。

- 方法: 「GET」を選択します。

- ソース・タイプ: 「問合せ」を選択します。

- 書式: 「JSON」を選択します。

- セキュア・アクセスが必要: 「いいえ」を選択します。

- ページ区切りサイズ: 7と入力します。

- ソース: 次を入力します。

select empno "$uri", empno, ename
from (
select emp.*
, row_number() over (order by empno) rn
from emp
) tmp
where rn between :row_offset and :row_count

図r_emp.gifの説明

8. 「作成」をクリックします。
GETハンドラが左のパネルのemployees/リソース・テンプレートの下に表示されます。

9. 「テスト」をクリックします。
JSONで結果が表示されます。各アイテムのuri:{$ref}によって、リンクに指定されたIDに関するemployees/{id} RESTfulサービスが起動されることに注意してください。

図employees_rslt.gifの説明

注意:
結果が正しくない場合は、employees/ GETリソース・ハンドラとoracle.example.hr employees GETリソース・ハンドラを比較します。

10. empno 7369に関するリンクで、最初のuri:{$ref}リンクをクリックします。
7369に関する個別の従業員レコードが表示されます。

11. ブラウザで「戻る」ボタンをクリックします。
JSONで元の結果が表示され、7人の従業員がリストされます。

12. next{$ref}リンクをクリックして、データの次のページにナビゲートします。
次の7行が、最初、前および次のページへのリンクとともに表示されます。

5.5.4 フィードとしての結果セットの返却(employeesfeed/)

oracle.example.hrモジュールには、emp表からempnoおよびenameの値を返し、それらの値をフィードとして表示するRESTfulサービスを示すemployeesfeed/リソース・テンプレートが含まれます。

フィード・リソース・ハンドラは、SQL問合せを実行し、結果をJSON Feed形式に変換します。フィードの各アイテムには、リソースのサマリーと、リソースの完全形式へのハイパーリンクが含まれます。結果セットの各行の最初の列は、その行の一意の識別子である必要があり、path/to/feed/{id}という形式のハイパーリンクを生成するために使用されます(最初の列の値が{id}の値として使用されます)。その行の他の列は、リソースを要約するとみなされ、フィードに含まれます。リソースの完全形式のリソース・テンプレートも、別途定義する必要があります。

フィードとして結果を返すリソース・テンプレートのその他の例は、oracle.example.hrサービス・モジュールのemployeesfeed/{id}リソース・テンプレートを参照してください。

フィードとして返されるデータを表示するリソース・テンプレートを追加してテストするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・テンプレートの追加先とするRESTfulサービス・モジュールをクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 左のパネル下部で、「テンプレートの作成」をクリックします。
「リソース・テンプレート」オプションが右側に表示されます。

4. 「URIテンプレート」に、employeesfeed/と入力します。

5. 「作成」をクリックします。
employeesfeed/リソース・テンプレートが左のパネルに表示されます。

6. 従業員のリソース・テンプレートの下で、「ハンドラの作成」をクリックします。
「リソース・ハンドラ」オプションが表示されます。

7. 次の選択およびエントリを行います。

- 方法: 「GET」を選択します。

- ソース・タイプ: 「フィード」を選択します。

- セキュア・アクセスが必要: 「いいえ」を選択します。

- ページ区切りサイズ: 25と入力します。

- ソース: 次を入力します。

select empno, ename from emp  order by deptno, ename

図employeesfeed.gifの説明

8. 「作成」をクリックします。
GETリソース・ハンドラが左のパネルのemployeesfeed/リソース・テンプレートの下に表示されます。

9. 「テスト」をクリックします。
結果には、emp表の各従業員に関するフィードが表示されます。

図employeesfeed_res.gifの説明

注意:
結果が正しくない場合は、employeesfeed/ GETリソース・ハンドラとoracle.example.hr employeesfeed GETリソース・ハンドラを比較します。

5.5.5 PL/SQLブロックに基づく結果セットの返却(empsecformat/{empname})

oracle.example.hrモジュールには、PL/SQLブロックによって書式設定されたSQL問合せの結果を返すRESTfulサービスを示すempsecformat/{empname}リソース・テンプレートが含まれます。

PL/SQLブロックを使用して結果を書式設定するリソース・テンプレートを追加してテストするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・テンプレートの追加先とするRESTfulサービス・モジュールをクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 左のパネル下部で、「テンプレートの作成」をクリックします。
「リソース・テンプレート」オプションが右側に表示されます。

4. 「URIテンプレート」に、empsecformat/{empname}と入力します。

5. 「作成」をクリックします。
empsecformat/{empname}リソース・テンプレートが左のパネルに表示されます。

6. empsecformat/{empname}リソース・テンプレートの下で、「ハンドラの作成」をクリックします。
「リソース・ハンドラ」オプションが表示されます。

7. 次の選択およびエントリを行います。

- 方法: 「GET」を選択します。

- ソース・タイプ: 「PL/SQL」を選択します。

- セキュア・アクセスが必要: 「いいえ」を選択します。

- ページ区切りサイズ: 空白にします。

- ソース: 次を入力します。

DECLARE
prevdeptno   number;
deptloc      varchar2(30);
deptname     varchar2(30);
CURSOR getemps IS select * from emp
where ((select job from emp where ename = :empname)  IN ('PRESIDENT', 'MANAGER'))
or deptno = (select deptno from emp where ename = :empname)
order by deptno, ename;
BEGIN
sys.htp.htmlopen;
sys.htp.headopen;
sys.htp.title('Departments');
sys.htp.headclose;
sys.htp.bodyopen;

for emprecs in getemps
loop

if emprecs.deptno != prevdeptno or prevdeptno is null then
select dname, loc into deptname, deptloc
from dept where deptno = (select deptno from emp where ename = emprecs.ename);
if prevdeptno is not null then
sys.htp.print('</ul>');
end if;
sys.htp.print('Department ' || deptname || ' located in ' || deptloc || '<p/>');
sys.htp.print('<ul>');
end if;

sys.htp.print('<li>' || emprecs.ename || ', ' || emprecs.job || ', ' || emprecs.sal || '</li>');

prevdeptno := emprecs.deptno;

end loop;
sys.htp.print('</ul>');
sys.htp.bodyclose;
sys.htp.htmlclose;
END;

図empsecformat.gifの説明

8. 「作成」をクリックします。
GETリソース・ハンドラが左のパネルのempsecformat/{empname}リソース・テンプレートの下に表示されます。

9. 「バインド変数の設定」をクリックします。

10. empnameパラメータに、ADAMSと入力します。

11. 「テスト」をクリックします。
Adamsに関する書式設定された結果が表示されます。

図empsecformat_res.gifの説明

注意:
結果が正しくない場合は、empsecformat/{empname} GETリソース・ハンドラとoracle.example.hr empsecformat/{empname} GETリソース・ハンドラを比較します。

5.6 RESTfulサービス・モジュールの管理

RESTfulサービス・モジュールは、よく使うテンプレート(リソース・テンプレートと呼ばれる)を共通のUniform Resource Identifiers (URI)接頭辞でグループ化したものです。URI接頭辞の指定はオプションです。RESTfulサービス・モジュールに接頭辞が定義されている場合は、その接頭辞がすべてのリソース・テンプレートの前に付きます。複数のリソース・テンプレートのパターンが1つのリクエストURIに一致する場合は、優先度の値を使用してリソース・テンプレートが選択されます。このような場合、優先度の値が最も高いリソース・テンプレートが選択されます。

内容は次のとおりです。

- RESTfulサービス・モジュールの作成

- RESTfulサービス・モジュールの編集

- RESTfulサービス・モジュールの削除

- RESTfulサービス権限の管理

- RESTfulサービス・モジュールのエクスポート

- RESTfulサービス・モジュールのインポート

5.6.1 RESTfulサービス・モジュールの作成

RESTfulサービス・モジュールを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「作成」をクリックします。

3. 適切なフィールドに入力し、適切なオプションを選択します。必須フィールドには、赤いアスタリスク(*)が付いています。特定のオプションの詳細は、そのオプションのアイテム・ヘルプを参照してください。

4. RESTfulサービス・モジュールの設定で、次を指定します。

- 名前(必須): RESTfulサービス・モジュールの名前を指定します。

- URI接頭辞: URIテンプレートの接頭辞を指定します。

- 使用可能な起点: リソース・テンプレートへのアクセスが許可される起点のカンマ区切りリストを指定します。

- ステータス: このサービスを使用可能にする場合は「公開」を、しない場合は「未公開」を選択します。

- ページ区切りサイズ: ページ区切りウィンドウのサイズを指定します。データベース問合せの場合、これは返される行の数です。

- 必要な権限: このサービス・モジュールへのアクセスに必要なユーザー権限を選択します。

5. このモジュールにリソース・テンプレートを追加するには、「リソース・テンプレートの追加」で次を指定します。

- URIテンプレート: Uniform Resource Identifiersを識別するURIテンプレートを入力します。URIテンプレートは、次に示すように、URIを記述する単純な構文です。

example/{id}

- 優先度: リソース・テンプレートの評価順序を指定します。高い数値から先に評価されます。

- エンティティ・タグ: リソースのETag HTTPヘッダーの生成方法を指定します。詳細は、アイテム・ヘルプを参照してください。

- エンティティ・タグ問合せ: カスタム・エンティティ・タグの生成に使用される1つの列と1つの行を返すSQL SELECT文を指定します。このオプションは、「エンティティ・タグ」に「問合せ」を選択した場合にのみ表示されます。

6. リソース・テンプレートにリソース・ハンドラを追加するには、「リソース・ハンドラの追加」で次を指定します。

- 方法: リソース・ハンドラに使用するHTTPメソッドを指定します。オプションには、「GET」、「DELETE」、「POST」、「PUT」があります。詳細は、アイテム・ヘルプを参照してください。

- ソース・タイプ: 選択したHTTPメソッドのソース実装を選択します。オプションには、「問合せ」、「1行問い合せる」、「PL/SQL」、「フィード」、「メディア・リソース」があります。

- 書式: 結果を返す方法を定義します。オプションには、「JSON」、「CSV」があります。

- ソース: 選択したHTTPメソッドを処理するSQL問合せまたはPL/SQLブロックを指定します。

注意:
追加のリソース・ハンドラを定義するには、リソース・ハンドラの作成ウィザードを完了してから、作成したリソース・ハンドラを編集します。

7. 「作成」をクリックします。
RESTfulサービス・モジュールのページが表示されます。

5.6.2 RESTfulサービス・モジュールの編集

RESTfulサービス・モジュールには、関連するリソース・テンプレートおよびリソース・ハンドラを含むことができます。特定のRESTfulサービス・モジュールの編集プロセス時に、関連する任意のリソース・テンプレートおよびリソース・ハンドラに変更を行うことができます。

RESTfulサービス・モジュールを編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 編集するモジュールの名前をクリックします。
RESTfulサービス・モジュールの編集ページが表示されます。

図r_edit.gifの説明

注意:
リソース・テンプレートおよびリソース・ハンドラを表示、編集および作成するには、左のペインにあるRESTfulサービスのツリーを使用します。

3. RESTfulサービス・モジュールの設定を編集するには、「RESTfulサービス・モジュール」の下で、右のペインのフィールドを変更します。詳細は、「RESTfulサービス・モジュールの作成」を参照してください。

4. リソース・テンプレートを編集するには、次のステップを実行します。

1. 左のパネルにあるRESTfulサービスのツリーで、編集するリソース・テンプレートを選択します。リソース・テンプレートのオプションが右のパネルに表示されます。

2. 変更を加えます。詳細は、「リソース・テンプレートの追加」を参照してください。

3. 「変更の適用」をクリックします。

5. リソース・ハンドラを編集するには、次のステップを実行します。

1. RESTfulサービスのツリーで、編集するリソース・ハンドラを選択します。リソース・ハンドラのオプションが右のパネルに表示されます。

2. 変更を加えます。詳細は、「リソース・ハンドラの追加」を参照してください。

3. 「変更の適用」をクリックします。

6. 「変更の適用」をクリックします。

5.6.3 RESTfulサービス・モジュールの削除

RESTfulサービス・モジュールを削除すると、モジュールとともに、このモジュールに関連するすべてのリソース・テンプレートおよびリソース・ハンドラが削除されます。

RESTfulサービス・モジュールを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 削除するモジュールの名前をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「削除」をクリックします。

4. 「OK」をクリックして処理を確認します。
「RESTfulサービス」ホームページが表示されます。

5.6.4 RESTfulサービス権限の管理

RESTful Webサービス・モジュールにアクセスする権限は、Application Expressユーザー・グループに属するApplication Expressユーザーに限定することができます。

RESTfulサービス権限の割当てによってRESTfulサービス・モジュールを保護するには、次のステップを実行します。

1. Application Express管理を使用してApplication Expressユーザー・グループを定義します。『Oracle Application Express管理ガイド』のグループを使用したApplication Expressユーザーの管理に関する説明を参照してください。

2. 1つ以上のユーザー・グループに基づくRESTfulサービス権限を作成します。「RESTfulサービス権限の作成」を参照してください。

3. この権限で保護されるRESTful Webサービス・モジュールを指定します。「RESTful Webサービス・モジュールへの権限の割当て」を参照してください。

内容は次のとおりです。

- RESTful Webサービス・モジュールへの権限の割当て

- RESTfulサービス権限の作成

- RESTfulサービス権限の編集

- RESTfulサービス権限の削除

5.6.4.1 RESTful Webサービス・モジュールへの権限の割当て

RESTful Webサービス・モジュールに権限を割り当てる方法は複数あります。

- RESTful Webサービス・モジュールの作成時または編集時に、モジュールに権限を指定できます。「RESTfulサービス・モジュールの作成」および「RESTfulサービス・モジュールの編集」を参照してください。

- RESTfulサービス権限の作成時または編集時に、この権限によって保護される1つ以上のモジュールを指定できます。「RESTfulサービス権限の作成」および「RESTfulサービス権限の編集」を参照してください。

注意:
RESTfulサービス権限を削除すると、その権限によって保護されていたすべてのRESTfulサービス・モジュールが保護されなくなります。「RESTfulサービス権限の削除」を参照してください。

5.6.4.2 RESTfulサービス権限の作成

RESTfulサービス権限を作成して、1つ以上のRESTful Webサービス・モジュールに対するアクセスを特定のユーザーに限定できます。RESTfulサービス権限には、1つ以上のユーザー・グループに属するユーザーを含むことができます。この権限によって保護されるRESTful Webサービス・モジュールでは、RESTfulサービス・モジュール・ページの「必要な権限」に、権限の名前が表示されます。

RESTfulサービス権限を作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「タスク」で、「RESTfulサービス権限」リンクをクリックします。
RESTfulサービス権限ページが表示されます。

3. 「作成」をクリックします。
RESTfulサービス権限の詳細ページが表示されます。

4. 「名前」に、権限を示す名前を入力します。

5. 「ラベル」に、権限を示すラベル値を入力します。

6. 「割当て済グループ」に、この権限の割当て先とするユーザー・グループを選択します。

7. 「説明」に、この権限の説明を入力します。

8. 「保護されたモジュール」で、矢印を使用して、この権限の割当て先とするモジュールを選択します。

9. 「作成」をクリックします。
RESTfulサービス権限ページが表示されます。

適切なモジュールに権限が割り当てられたことを確認するには、次のステップを実行します。

1. ブレッドクラムで「RESTfulサービス」をクリックします。
RESTfulサービス・ページが表示されます。

2. 保護されている「RESTfulサービス・モジュール」をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「必要な権限」に、作成したRESTfulサービス権限が表示されることを確認します。

4. この権限に割り当てられたすべてのモジュールが保護されていることを確認するには、これらの検証ステップを繰り返します。

5.6.4.3 RESTfulサービス権限の編集

RESTfulサービス権限は、変更できます。保護された特定のモジュールに対する変更は、影響を受けるモジュールのRESTfulサービス・モジュール・ページで、「必要な権限」設定に反映されます。

RESTfulサービス権限を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「タスク」で、「RESTfulサービス権限」リンクをクリックします。
RESTfulサービス権限ページが表示されます。

3. 「RESTfulサービス権限」をクリックします。
RESTfulサービス権限の詳細ページが表示されます。

4. 変更を加えます。

5. 「変更の適用」をクリックします。
RESTfulサービス権限ページが表示されます。

5.6.4.4 RESTfulサービス権限の削除

RESTfulサービス権限は、削除できます。権限を削除すると、その権限によって保護されていたすべてのRESTfulサービス・モジュールは、他の権限が再割当てされるまで保護されなくなります。

RESTfulサービス権限を削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「タスク」で、「RESTfulサービス権限」リンクをクリックします。
RESTfulサービス権限ページが表示されます。

3. 「RESTfulサービス権限」をクリックします。
RESTfulサービス権限の詳細ページが表示されます。

4. 「削除」をクリックします。
RESTfulサービス権限ページが表示されます。

5.6.5 RESTfulサービス・モジュールのエクスポート

RESTfulサービス・モジュールのメタデータは、SQLスクリプト形式でファイルにエクスポートできます。エクスポートされたファイルは、同じインスタンスまたは互換性のある他のApplication Expressインスタンスにインポートできます。「RESTfulサービス・モジュールのインポート」を参照してください。

RESTfulサービス・モジュールをエクスポートするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「タスク」で、「エクスポート」リンクをクリックします。
RESTfulサービスのエクスポート・ページが表示されます。

3. 「RESTfulサービス」で、次のいずれかを実行します。

- 1つのモジュールをエクスポートするには、そのモジュール名を選択します。

- すべてのモジュールをエクスポートするには、「すべてのサービス」を選択します。

4. 「エクスポート」をクリックします。
開始ダイアログが表示されます。

5. エクスポート・オプションを選択します。

6. 「OK」をクリックします。

5.6.6 RESTfulサービス・モジュールのインポート

SQLスクリプト形式でファイルにエクスポートされたRESTfulサービス・モジュールのメタデータは、インポートできます。インポートするモジュールは、同じインスタンスまたは互換性のある他のApplication Expressインスタンスにエクスポートされている必要があります。「RESTfulサービス・モジュールのエクスポート」を参照してください。

注意:
インポートするモジュールに、このワークスペースに存在するRESTfulサービス名が含まれる場合は、既存のRESTfulサービスが削除され、インポートするモジュールの定義で置き換えられます。

RESTfulサービス・モジュールをインポートするには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 「タスク」で、「インポート」リンクをクリックします。
RESTfulサービスのインポート・ページが表示されます。

3. 「ファイルのインポート」で、インポート・ファイルをブラウズして選択します。

4. 「ファイルのキャラクタ・セット」で、インポート・ファイルで使用するキャラクタ・セットを選択します。

5. 「インポート」をクリックします。
RESTfulサービス・ページが表示されます。

5.7 リソース・テンプレートの管理

リソース・テンプレートは、URIをグループ化して、特定のRESTfulサービス・モジュールに関連付ける方法です。リソース・テンプレートには、1つ以上のリソース・ハンドラを含むことができます。1つのHTTPメソッドに指定できるリソース・ハンドラは1つのみです。たとえば、リソース・テンプレートには、1つのGETメソッドや1つのDELETEメソッドのみを指定できます。

内容は次のとおりです。

- リソース・テンプレートの追加

- リソース・テンプレートの編集

- リソース・テンプレートの削除

5.7.1 リソース・テンプレートの追加

RESTfulサービス・モジュールにリソース・テンプレートを追加するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・テンプレートを作成するRESTfulサービスをクリックします。

3. 「RESTfulサービス」ツリーで、「テンプレートの作成」をクリックします。
リソース・テンプレートの設定が右のパネルに表示されます。

4. 適切なフィールドに入力し、適切なオプションを選択します。必須フィールドには、赤いアスタリスク(*)が付いています。特定のオプションの詳細は、そのオプションのアイテム・ヘルプを参照してください。

5. 次を指定します。

- URIテンプレート: Uniform Resource Identifiersを識別するURIテンプレートを入力します。URIテンプレートは、次に示すように、URIを記述する単純な構文です。

example/{id}

- 優先度: テンプレートの評価順序を指定します。高い数値から先に評価されます。

- エンティティ・タグ: リソースのETag HTTPヘッダーの生成方法を指定します。詳細は、アイテム・ヘルプを参照してください。

- エンティティ・タグ問合せ: カスタム・エンティティ・タグの生成に使用される1つの列と1つの行を返すSQL SELECT文を指定します。このオプションは、「エンティティ・タグ」に「問合せ」を選択した場合にのみ表示されます。

6. 「作成」をクリックします。

5.7.2 リソース・テンプレートの編集

リソース・テンプレートを編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 編集するリソース・テンプレートが属するモジュールの名前をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「RESTfulサービス」ツリーで、編集するリソース・テンプレートをクリックします。
選択したリソース・テンプレートは「RESTfulサービス」ツリーでハイライトされ、対応するリソース・テンプレートの設定が右のパネルに表示されます。

4. 必要な変更を行います。詳細は、「リソース・テンプレートの追加」を参照してください。

5. 「変更の適用」をクリックします。

5.7.3 リソース・テンプレートの削除

リソース・テンプレートを削除すると、テンプレートとともに、このテンプレートに関連するすべてのリソース・ハンドラが削除されます。

リソース・テンプレートを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. 更新するモジュールの名前をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「RESTfulサービス」ツリーで、削除するリソース・テンプレートをクリックします。
リソース・テンプレートの設定が右のパネルに表示されます。

4. 「削除」をクリックします。

5. 「OK」をクリックして処理を確認します。
RESTfulサービス・モジュールが表示されます。

5.8 リソース・ハンドラの管理

リソース・ハンドラは、特定のHTTPメソッドを処理するための問合せまたは無名PL/SQLブロックです。リソース・テンプレートには複数のリソース・ハンドラを定義できますが、HTTPメソッドに定義できるリソース・ハンドラは1つのみです。

リソース・ハンドラのパラメータを手動で定義すると、リソース・ハンドラのHTTPヘッダーにバインドすることも、URIテンプレート・パラメータを特定のデータ型にキャストすることもできます。URIテンプレートで宣言されたパラメータは、リソース・ハンドラに暗黙的に渡されます。たとえば、生成される表示内容をローカライズするには、リソース・ハンドラがHTTPのAccept-Languageヘッダーの値を知る必要があります。

内容は次のとおりです。

- リソース・ハンドラの追加

- リソース・ハンドラの編集

- リソース・ハンドラの削除

5.8.1 リソース・ハンドラの追加

リソース・テンプレートにリソース・ハンドラを追加するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・ハンドラの追加先とするRESTfulサービスをクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 左のパネルの関連するリソース・テンプレートの下で、「ハンドラの作成」をクリックします。
リソース・ハンドラの設定が右のパネルに表示されます。

4. 適切なフィールドに入力し、適切なオプションを選択します。必須フィールドには、赤いアスタリスク(*)が付いています。特定のオプションの詳細は、そのオプションのアイテム・ヘルプを参照してください。

5. 「リソース・ハンドラ」で、次を指定します。

- 方法: リソース・ハンドラに使用するHTTPメソッドを指定します。詳細は、アイテム・ヘルプを参照してください。

- ソース・タイプ: リソースの生成に使用する計画タイプを指定します。詳細は、アイテム・ヘルプを参照してください。

- セキュア・アクセスが必要: HTTPSなど、セキュアなチャネルを介してリソースにアクセスするかどうかを指定します。セキュア・アクセスが必要な場合は、「はい」に設定します。

- ページ区切りサイズ: ページ区切りウィンドウのサイズを指定します。データベース問合せの場合、これは返される行の数です。

6. 「ソース」に、選択したHTTPメソッドを処理するSQL問合せまたはPL/SQLブロックを入力します。詳細は、ページ下部の「例」をクリックします。

7. リソース・ハンドラの動作をテストするには、次のステップを実行します。

1. 「変更の適用」をクリックします。

2. SQL問合せまたはPL/SQLブロックにバインド変数が含まれる場合は、テストの前に、「バインド変数の設定」をクリックしてバインド変数を定義します。

3. 「テスト」をクリックします。
新しいウィンドウに、RESTfulサービスを実行した結果がJSONで表示されます。テストに使用されるURLは、URI接頭辞およびURIテンプレートの値と、任意のパラメータで構成されます。

注意:
テスト結果の読取りを簡単にするには、ブラウザにJSON Viewerをインストールすることをお薦めします。

8. 「作成」をクリックします。
RESTfulサービス・モジュールのページが表示されます。

9. リソース・ハンドラにパラメータを追加するには、次のステップを実行します。

1. 「パラメータの作成」をクリックします。
「リソース・ハンドラ・パラメータ」パネルに、パラメータ設定が表示されます。

2. 「名前」に、特定のパラメータ名を入力します。

3. 「バインド変数名」に、SQL問合せまたはPL/SQLブロック内で使用されるパラメータのバインド変数名を入力します。

4. 「アクセス方法」で、HTTPメソッドを選択します。オプションには、「IN」、「IN/OUT」または「OUT」があります。「URIテンプレート」パラメータの設定は、「IN」のみです。ヘッダー・パラメータに「IN」の値を指定すると、HTTPリクエストにヘッダーが使用されます。「IN/OUT」の値を指定すると、その値がHTTPリクエストとレスポンスの両方に使用されます。「OUT」の値を指定すると、その値がHTTPレスポンスのみに使用されます。

5. 「ソース・タイプ」で、パラメータ・ソース・タイプを選択します。

6. 「パラメータ・タイプ」で、パラメータのデータ型を選択します。

7. 「作成」をクリックします。
リソース・ハンドラ・ページが表示され、右のパネル下部の「パラメータ」に、追加したパラメータが表示されます。

8. 追加する各パラメータについて、ここで説明したステップを繰り返します。

5.8.2 リソース・ハンドラの編集

リソース・ハンドラを編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・ハンドラが属するリソース・サービス・モジュールの名前をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「RESTfulサービス」ツリーで、編集するリソース・ハンドラをクリックします。
リソース・ハンドラの設定が右のパネルに表示されます。

4. 必要な変更を行います。詳細は、「リソース・ハンドラの追加」を参照してください。

5. 「変更の適用」をクリックします。
RESTfulサービス・モジュールのページが表示されます。

5.8.3 リソース・ハンドラの削除

リソース・ハンドラを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。

2. リソース・ハンドラが属するモジュールの名前をクリックします。
RESTfulサービス・モジュールのページが表示されます。

3. 「RESTfulサービス」ツリーで、削除するリソース・ハンドラをクリックします。
リソース・ハンドラの設定が右のパネルに表示されます。

4. 「削除」をクリックします。

5. 「OK」をクリックして処理を確認します。
RESTfulサービス・モジュールが表示されます。

索引

C  D  E  F  I  L  M  O  P  Q  R  S  T  U  V  W  X

C

コマンドの終了, SQLコマンド, 2.4.4

参照表の作成, 1.5.3

D

データ

データベースからのエクスポート, 4.2.4

ロード, 4.2

データベースへのロード, 4.2.3

アンロード, 4.2, 4.2.4

データ・ディクショナリ, 参照, 4.8.5 データ・ワークショップ, 4.2 データベース

データのロード, 4.2

監視, 4.9

データのアンロード, 4.2

データベース定義言語, DDL文の生成, 4.3 データベース・リンク

参照, 1.14.2

作成, 1.14.1

テスト, 1.14.2.1

データベース監視

I/O, 4.9.1.4

ロック, 4.9.1.2

長時間操作, 4.9.4

オープン・カーソル, 4.9.1.6

セッション, 4.9.1, 4.9.1.1

SQL, 4.9.1.5

上位SQL, 4.9.3

待機, 4.9.1.3

データベース監視, システム統計, 4.9.2 データベース・オブジェクト

パージ, 4.10

リストア, 4.10

データベース・セキュリティ

「列権限」レポート, 4.8.2

「ロール権限」レポート, 4.8.2

「システム権限」レポート, 4.8.2

DDL

概要, 4.3

生成, 4.3

E

実行計画

概要, 2.8

使用, 2.8, 2.8, 2.8.2

XMLのエクスポート・ウィザード, 4.2.4.2 データのエクスポート

使用可能なビューのまとめ, 4.2.1.1

F

関数

参照, 1.12.2

コンパイル, 1.12.4

作成, 1.12.1

ダウンロード, 1.12.5

削除, 1.12.6

編集, 1.12.3

I

データのインポート, メソッドのまとめ, 4.2.1.1

索引

参照, 1.7.2

作成, 1.7.1

無効化, 1.7.2, 1.7.2.1

削除, 1.7.3

再ビルド, 1.7.2, 1.7.2.1

統計, 1.7.2.1

I/Oレポート, 4.9.1.4

L

データのロード・ウィザード, 4.2.3.1

XMLのロード・ウィザード, 4.2.3.2

「ロック」レポート, 4.9.1.2

M

マテリアライズド・ビュー

参照, 1.15.2

作成, 1.15.1

依存オブジェクト, 1.15.2.1

削除, 1.15.3

権限付与のリスト, 1.15.2.1

データのレポート, 1.15.2.1

列でソート, 1.15.2.1

オブジェクト詳細の表示, 1.15.2.1

O

オブジェクト・ブラウザ

概要, 1.2

アクセス, 1.1

オブジェクトの作成, 1.4

「詳細」ペイン, 1.2

オブジェクトの非表示のコントロール, 1.3.2

「オブジェクト選択」ペインの非表示, 1.3.2

データベース・リンクの管理, 1.14

ファンクションの管理, 1.12

索引の管理, 1.7

マテリアライズド・ビューの管理, 1.15

パッケージの管理, 1.10

プロシージャの管理, 1.11

順序の管理, 1.8

表の管理, 1.5

トリガーの管理, 1.13

タイプの管理, 1.9

ビューの管理, 1.6

「オブジェクト選択」ペイン, 1.2

オブジェクトの検索, 1.3

シノニム, 1.16

オブジェクト・レポート

すべてのオブジェクト, 4.8.5

「すべてのオブジェクト」レポート, 4.8.5

「列権限」レポート, 4.8.2

データ・ディクショナリ, 4.8.5

例外レポート, 4.8.4

無効なオブジェクト, 4.8.5

オブジェクト・カレンダ, 4.8.5

タイプ別オブジェクト数, 4.8.5

PL/SQLソース・コードのレポート, 4.8.3.3

「プログラム・ユニット引数」レポート, 4.8.3.1

「ロール権限」レポート, 4.8.2

「システム権限」レポート, 4.8.2

「ユニット行数」レポート, 4.8.3.2

オブジェクト

パージ, 4.10

リストア, 4.10

「オープン・カーソル」レポート, 4.9.1.6 Oracleオプティマイザ

実行計画, 2.8.2

Oracleオプティマイザ, 実行計画, 2.8

P

パッケージ

コンパイル, 1.10.4

作成, 1.10.1

ダウンロード, 1.10.2.1, 1.10.5

削除, 1.10.6

編集, 1.10.2.1, 1.10.3

検索, 1.10.2.1

権限付与, 1.10.2.1

オブジェクトの依存性, 1.10.2.1

パッケージ本体, 1.10.2.1

関連エラー, 1.10.2.1

表示, 1.10.2

プロシージャ

参照, 1.11.2

コンパイル, 1.11.4

作成, 1.11.1

ダウンロード, 1.11.5

削除, 1.11.6

編集, 1.11.3

手動編集, 1.11.3.1

検索, 1.11.2.1

Q

クエリー・ビルダー

説明, 4.1.1

アクセス, 4.1.1.1

結合の自動作成, 4.1.5.3

結合の手動作成, 4.1.5.2

オブジェクトのフィルタ適用, 4.1.2.1

設計ペインでのオブジェクトの非表示, 4.1.3.3

「オブジェクト選択」ペイン, 4.1.2.2

設計ペインでのオブジェクトの削除, 4.1.3.3

ペインのサイズ変更, 4.1.3.2.1

「保存されたSQL」タブ, 4.1.6.2

オブジェクトの検索, 4.1.2.1

サポートされる列の型, 4.1.3.1

表の処理, 4.1.5.3

処理の表示, 4.1.5.3

R

ごみ箱

パージ, 4.10

検索, 4.10

使用, 4.10

オブジェクトの表示, 4.10

レポート

データ・ディクショナリ, 4.8.5

データベース・オブジェクト, 4.8.5

例外レポート, 4.8.4

PL/SQLソース・コード, 4.8.3.3

プログラム・ユニット引数, 4.8.3.1

「ユニット行数」レポート, 4.8.3.2

Representational State Transfer (REST), 5.1 リソース・ハンドラ

追加, 5.8.1

削除, 5.8.3

編集, 5.8.2

リソース・テンプレート

追加, 5.7.1

削除, 5.7.3

編集, 5.7.2

管理, 5.7

RESTfulサービス

概要, 5.2

oracle.example.hrの概要, 5.5

アクセス, 5.4

作成, 5.6.1

削除, 5.6.3

編集, 5.6.2

例, 5.5

エクスポート, 5.6.5

インポート, 5.6.6

管理, 5.6

権限の管理, 5.6.4

リソース・ハンドラの管理, 5.8

リソース・テンプレートの管理, 5.7

要件, 5.3

使用, 5

結果, 3.2.1

S

スクリプト

エディタでの作成, 3.3.1

エディタからの削除, 3.5.2

SQLスクリプト・ページからの削除, 3.5.1

実行, 3.7

SQLスクリプト・ページからの実行, 3.7.2

エディタでの実行, 3.7.1

エクスポート, 3.2.1

エクスポート, 3.9

インポート, 3.9

結果, 3.2.1

SQLスクリプト・エディタ, 3.4

他のアカウントへのアップロード, 3.2.1

SQLスクリプトへのアップロード, 3.3.2

リポジトリ割当て制限の表示, 3.10

「セキュリティ」レポート

「列権限」レポート, 4.8.2

オブジェクト権限付与, 4.8.2

ロール権限, 4.8.2

システム権限, 4.8.2

順序

変更, 1.8.2.1

参照, 1.8.2

作成, 1.8.1

依存オブジェクト, 1.8.2.1

削除, 1.8.3

関連付けられた権限付与, 1.8.2.1

「セッション」レポート, 4.9.1.1 セッション, 中断, 4.9.1.1 SQLコマンド

コマンドの終了, 2.4.4

実行計画, 実行, 2.8.2

ホームページ, 2.3

「実行計画」の実行, 2.8

トランザクションのサポート, 2.4.2

「SQL」レポート, 4.9.1.5 SQLスクリプト

アクセス, 3.2

エディタでのスクリプトの作成, 3.3.1

エディタからのスクリプトの削除, 3.5.2

「SQLスクリプト」ホームページからのスクリプトの削除, 3.5.1

SQLスクリプト・ページからのスクリプトの実行, 3.7.2

エディタでのスクリプトの実行, 3.7.1

スクリプトのエクスポート, 3.9

スクリプトのインポート, 3.9

スクリプト・エディタ, 3.4

SQLスクリプト・ページ, 3.2.1

スクリプトのアップロード, 3.3.2

割当て制限の表示, 3.10

スクリプト結果の表示, 3.8.1

SQLスクリプト・ページ

「スクリプト結果の管理」へのアクセス, 3.2.1

割当て制限の表示, 3.2.1

タスク・リスト, 3.2.1

SQLスクリプト・ページのタスク・リスト

エクスポート・スクリプト, 3.2.1

スクリプトのアップロード, 3.2.1

SQL*Plusコマンドのサポート, 2.4.3 SQL*Plusコマンド, 非サポート, 2.4.3 シノニム

作成, 1.16.1

削除, 1.16.3

表示, 1.16.2

T

タブ区切りファイル

ロード, 4.2.3.1

表

列の追加, 1.5.3

参照, 1.5.2

制約, 1.5.2.1

コピー, 1.5.3

作成, 1.5.1

列の削除, 1.5.3

削除, 1.5.4

編集, 1.5.3

ユーザー・インタフェース・デフォルトのエクスポート, 4.5.5

スプレッドシートへのデータのエクスポート, 1.5.2.1

権限付与, 1.5.2.1

関連付けられた索引, 1.5.2.1

行の挿入, 1.5.2.1

列の変更, 1.5.3

すべての行を削除, 1.5.3

名前変更, 1.5.3

列名の変更, 1.5.3

行数のレポート, 1.5.2.1

列でソート, 1.5.2.1

統計, 1.5.2.1

ユーザー・インタフェースのデフォルト値, 1.5.2.1

データの表示, 1.5.2.1

テキスト・ファイル, ロード, 4.2.3.1 トランザクションのサポート, 2.4.2 トリガー

参照, 1.13.2

コンパイル, 1.13.4

作成, 1.13.1

ダウンロード, 1.13.5

削除, 1.13.6

編集, 1.13.3

タイプ

参照, 1.9.2

作成, 1.9.1

削除, 1.9.3

関連付けられた権限付与, 1.9.2.1

シノニムのリスト, 1.9.2.1

U

テキストへのアンロード・ウィザード, 4.2.4.1

XMLへのアンロード・ウィザード, 4.2.4.2

ユーティリティ

概要, 4

スキーマの比較, 4

DDLの生成, 4

データのロード, 4

データベースの監視, 4

削除したオブジェクトのリストア, 4

データのアンロード, 4

データベースの詳細の表示, 4

オブジェクト・レポートの表示, 4

ユーティリティ, データ・ディクショナリ, 4.8.5

V

ビュー

参照, 1.6.2

コンパイル, 1.6.4

作成, 1.6.1

削除, 1.6.5

編集, 1.6.3

関連付けられた権限付与, 1.6.2.1

参照元のオブジェクト, 1.6.2.1

データのレポート, 1.6.2.1

ユーザー・インタフェースのデフォルト値, 1.6.2.1

W

「待機」レポート, 4.9.1.3

ウィザード

タブ区切りデータのコピー・アンド・ペースト, 4.2.3.1

表のコンテンツのエクスポート, 4.2.4.1

テキスト・ファイルのエクスポート, 4.2.4.1

XMLのエクスポート, 4.2.4.2

テキストのインポート, 4.2.3.1

XMLのインポート, 4.2.3.2

X

XML文書

エクスポート, 4.2.4.2

ロード, 4.2.3.2

Copyright © 2003, 2013, Oracle and/or its affiliates. All rights reserved.