PL/SQLからのオペレーティング・システム・コマンドの実行

Size: px

Start display at page:

Download "PL/SQLからのオペレーティング・システム・コマンドの実行"

れいがさかいざわ
5 years ago
Views:

1 PL/SQL からのオペレーティングシステムコマンドの実行 Oracle ホワイトペーパー 2008 年 7 月注 : 本書はオラクルの一般的な製品の方向性を示すことが目的ですまた情報提供を唯一の目的とするものでありいかなる契約にも組み込むことはできません下記の事項はマテリアルやコード機能の提供を確約するものではなくまた購買を決定する際の判断材料とはなりえませんオラクルの製品に関して記載されている機能の開発リリースおよび時期については弊社の裁量により決定いたします

2 PL/SQL からのオペレーティングシステムコマンドの実行はじめに... 3 ファイルシステムと SQL および PL/SQL の相互作用... 4 インストールオプション... 4 ソフトウェア要件... 4 SQL スクリプト... 4 インストール手順... 4 まとめ... 7 推奨資料... 8 PL/SQL からのオペレーティングシステムコマンドの実行 2

3 はじめに本書では Oracle データベースの開発者によるオペレーティングシステムまたは通常のファイルとの相互作用を可能にする PL/SQL パッケージの OS_COMMAND FILE_PKG および FILE_TYPE について説明しますオラクルはファイルシステムにアクセスするためだけに限定された機能を標準で提供していますがシェルコマンドやオペレーティングシステムのプロセスを実行する機能は提供していませんこのホワイトペーパーでは次の内容について説明します一般に Oracle エンジンを使用してシェルコマンドを実行する方法には次の 3 通りがあります 1. ネイティブ共有ライブラリをコーディングしそのライブラリを CREATE LIBRARY を使用して Oracle データベース内で参照し特定の機能に対する PL/SQL ラッパーを作成しますこれを行うには Oracle を実行しているプラットフォームの C コンパイラが必要です 2. シェルコマンドを実行できるオラクル提供のパッケージ DBMS_SCHEDULER を使用しますただし DBMS_SCHEDULER では STDIN および STDOUT にはアクセスできませんこれらにアクセスする必要がある場合は DBMS_SCHEDULER は選択肢から外します 3. Oracle8i 以降 Java SE 準拠の仮想マシンがデータベースカーネルに組み込まれているため他の任意の Oracle Java VM (JVM) で System.exec メソッドを使用してシェルコマンドを実行できます JDBC API を使用すると STDIN STDOUT のコンテンツまたは OS の戻り値を SQL エンジンに戻すことができます Java はプラットフォームに依存しないので 1 つのインストールスクリプトが全プラットフォームのジョブを実行しますこのホワイトペーパーでは 3 番目の方法であるデータベースで Java を使用する方法を中心に説明します PL/SQL からのオペレーティングシステムコマンドの実行 3

4 ファイルシステムと SQL および PL/SQL の相互作用インストールオプション次の 2 つのインストールオプションがあります 1. Java クラスとパッケージを SYS ユーザーとして作成しすべてのユーザーからアクセスできるようにする 2. Java クラスとパッケージを非権限ユーザースキーマに作成するいずれのケースでも呼び出すユーザーにはパッケージを使用するための適切な Java 権限が必要ですソフトウェア要件 1. Oracle Database 10g Release1 以降 2. データベースに Java がインストールされ有効になっている次のコマンドを SYS ユーザーとして実行しデータベースにインストールされている Java の詳細を確認してください sqlplus> select comp_name, version from dba_registry where comp_name like %JAVA% ; 3. 適切なサイズの java_pool_size( 最低 50MB) SQL スクリプトインストーラには以下のSQLスクリプトが含まれています 1. os_command_java.sql:sql または PL/SQL から OS コマンドを実行し SQL レイヤーからファイルシステムにアクセスするための Java クラスを作成します OS コマンドの実行は Java ファイルシステムインタフェースおよび System.exec コールを介しておこなわれます結果は JDBC クラスを介して SQL エンジンにわたされますそのためコール元は適切な Java 権限を保持している必要がありますファイルシステムにアクセスするためのクラスには java.io.file を使用してファイルの一般的な処理を行うためのメソッドがありますそれらのメソッドはオブジェクト型 FILE_TYPE を使用して PL/SQL からコールしますこの結果次の PL/SQL パッケージも作成されます FILE_PKG は 1 つまたは複数のファイルハンドルを取得するためのヘルパーパッケージであり OS_COMMAND はシェルコマンドを実行するためのパッケージです LOB_WRITER_PLSQL は純粋な PL/SQL および " 従来型 " のディレクトリオブジェクトとして LOB(CLOB BLOB) をオペレーティングシステムファイルに書き込むためのヘルパーパッケージです 2. grant_public.sql: パッケージおよび Java クラスを SYS ユーザーとして作成してありパブリックシノニムを作成して他のユーザーに実行権限を付与する場合はこのスクリプトを実行します 3. java_grants.sql:os コマンドを実行するための適切な Java 権限を付与します 4. sample_script.sql:zip ファイルのコンテンツを表の中に展開するデモを実行します 5. cleanup.sql: パッケージおよびクラスを削除しますインストール手順 1. インストーラをシステム上のディレクトリに解凍します PL/SQL からのオペレーティングシステムコマンドの実行 4

2. このホワイトペーパーではスキーマ "SCOTT" に Java クラスとパッケージを作成します SYS ユーザーとしてオペレーティングシステムコマンドを実行するための Java 権限を "SCOTT" に付与する必要がありますそのため SYS ユーザーとしてデータベースに接続します 3. 次のスクリプトおよび後述のコマンドを実行します sqlplus> @java_grants.

5 2. このホワイトペーパーではスキーマ "SCOTT" に Java クラスとパッケージを作成します SYS ユーザーとしてオペレーティングシステムコマンドを実行するための Java 権限を "SCOTT" に付与する必要がありますそのため SYS ユーザーとしてデータベースに接続します 3. 次のスクリプトおよび後述のコマンドを実行します sqlplus> grant create public synonym to scott; 4. scott としてデータベースに接続します sqlplus> connect scott/<password>; 5. 以下のスクリプトを順番に実行しますその結果必要なクラスとパッケージが作成されます 6. テキスト出力 (ls -la) を返すシェルコマンドを実行するには次のコマンドを実行します sqlplus> select os_command.exec_clob('/bin/ls -la /home/oracle') COMMAND from dual; 次のスクリーンショットのような結果が表示されます 7. ディレクトリを作成するには次のコマンドを実行します次のスクリーンショットのような結果が表示されます sqlplus> select os_command.exec('mkdir /home/oracle/testdir') from dual; PL/SQL からのオペレーティングシステムコマンドの実行 5

8. ディレクトリ内のファイルを仮想表として取得するには次のコマンドを実行します次のスクリーンショットのような結果が表示されます sqlplus> select * from table(file_pkg.get_file_list(file_pkg.get_file('/'))); 9. ZIP ファイルを展開してそのコンテンツを表にロードするには sample_scripts.

6 8. ディレクトリ内のファイルを仮想表として取得するには次のコマンドを実行します次のスクリーンショットのような結果が表示されます sqlplus> select * from table(file_pkg.get_file_list(file_pkg.get_file('/'))); 9. ZIP ファイルを展開してそのコンテンツを表にロードするには sample_scripts.sql を実行しますこのスクリプトを実行すると展開する ZIP ファイルの指定を求められます続いて ZIP のアーカイブを展開する一時ディレクトリが作成されそのコンテンツが表にロードされ最後に一時ディレクトリが削除されますスクリプトを実行する前に適切な権限を SYS から SCOTT に付与する必要があります次を参照してください sqlplus> connect / as sysdba; sqlplus> exec DBMS_JAVA.grant_permission('SCOTT', 'java.io.filepermission', '<<ALL FILES>>', 'read,write, execute, delete'); sqlplus> exec Dbms_Java.Grant_Permission('SCOTT', 'SYS:java.lang.RuntimePermission', 'writefiledescriptor', ''); sqlplus> exec Dbms_Java.Grant_Permission('SCOTT', 'SYS:java.lang.RuntimePermission', 'readfiledescriptor', ''); sqlplus> connect scott/<password>; 10. ZIP ファイルを展開しそのコンテンツを表にロードするためのシステム要件ごとに以下のコードを変更することもできます declare f file_type; fz file_type; r number; PL/SQL からのオペレーティングシステムコマンドの実行 6

7 begin --get a handle for the "tmp" directory f:=file_pkg.get_file('/tmp'); --create a new temporary directory where the zip archive is being --extracted into... make the filename unique using TIMESTAMP fz := f.create_dir( 'zipdir_temp_' user '_' to_char(systimestamp, 'YYYYMMDD_HH24MISS.SSSS') ); --extract the zipfile; the -qq switch is important here otherwise --the OS process will not come back r := os_command.exec('unzip -o -qq [/PATH/TO/ZIPFILE] -d ' fz.file_path); --if the result is 0 (=success) load the contents of the temporary directory --(recursively) with ONE (!) SQL INSERT command if r = 0 then insert into document_table ( select seq_documents.nextval id, e.file_path, e.file_name, file_pkg.get_file(e.file_path).get_content_as_clob('iso ') content from table(file_pkg.get_recursive_file_list(fz)) e ); end if; --finally delete the temporary directory and its contents fz := fz.delete_recursive(); end; / sho err まとめ本書ではオペレーティングシステムファイルと相互に作用するための PL/SQL メソッドについて説明しました他のすべての JVM と同様データベースカーネルに組み込まれている仮想マシンでは System.exec メソッドを使用してシェルコマンドを実行できますこの機能については例で説明しました PL/SQL からのオペレーティングシステムコマンドの実行 7

8 推奨資料 1. OTNのテクニカルホワイトペーパー ( 2. Oracle Database Programming Using Java and Web Services Kuassi Mensah 著 ( PL/SQL からのオペレーティングシステムコマンドの実行 8

9 PL/SQL からのオペレーティングシステムコマンドの実行 2008 年 7 月著者 :Priyanka Sharma 共著者 :Carsten Czarski Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores, CA U.S.A. 海外からのお問い合わせ窓口 : 電話 : ファクシミリ : オラクル社はインターネット上での活動を強化するソフトウェアを提供します Oracle はオラクル社の登録商標です本文書内で参照される各種製品とサービスの名称は Oracle Corporation の商標ですその他の製品とサービスの名称はそれぞれの会社の商標です Copyright 2002 Oracle Corporation All rights reserved. 9

Microsoft Windows向けOracle Database 12cでのOracleホーム・ユーザーの導入

Microsoft Windows向けOracle Database 12cでのOracleホーム・ユーザーの導入 Oracle ホワイトペーパー 2013 年 7 月 Microsoft Windows 向け Oracle Database 12c での Oracle ホームユーザーの導入はじめに Oracle Database 12c Release 1(12.1) 以降では Microsoft Windows 上のOracle Databaseでインストール時に指定したOracleホームユーザーの使用がサポートされています