SQL EXECUTE SCRIPT

4D v16.3

SQL

SQL EXECUTE SCRIPT


SQL EXECUTE SCRIPT ( scriptPath ; errorAction {; attribName ; attribValue} {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} )

引数	型	説明
scriptPath	テキスト	実行するSQLスクリプトが書かれたファイルの完全パス名
errorAction	倍長整数	スクリプト実行中にエラーが発生した場合のアクション
attribName	テキスト	使用する属性の名前
attribValue	テキスト	属性の値

説明

SQL EXECUTE SCRIPTコマンドを使用して、scriptPathで指定されたスクリプトファイルに書かれた一連のSQLステートメントを実行できます。このコマンドはローカルマシン (ローカルの4Dまたは4D Server上のストアドプロシージャ) でのみ実行できます。またこのコマンドはカレントデータベース (内部あるいはエクスターナルデータベース) に対して動作します。

Note: このコマンドは直接あるいはODBC経由で開かれた外部接続では使用できません。

scriptPath引数には実行するSQL文が書かれたテキストファイルの完全パス名を渡します。パス名は現在のシステムのシンタックスを使用して表現されなければなりません。scriptPathに空の文字列 ("") を渡すと、標準のファイルを開くダイアログボックスが表示され、実行するファイルをユーザが選択できます。

Note: SQL EXPORT DATABASEとSQL EXPORT SELECTIONコマンドは自動でこのスクリプトファイルを作成します。

errorAction 引数を使用して、スクリプト実行中にエラーが発生した場合の動作を設定できます。""テーマ中の以下の3つの定数を使用できます:

定数	型	値	コメント
SQL On error abort	倍長整数	1	エラーイベント時、4Dは即座にスクリプト実行を停止します。
SQL On error confirm	倍長整数	2	エラーイベント時、4Dはエラーを説明するダイアログを表示し、スクリプト実行を停止するか続行するかをユーザーが選択できます。
SQL On error continue	倍長整数	3	エラーイベント時、4Dはそれを無視し、スクリプトの実行を続行します。

attribNameとattribValue引数は組で渡さなければなりません。これらの引数はスクリプト実行のための特定の属性として使用されることを意図しています。現在のバージョンの4D では、一つの属性をattribNameに渡せます。""テーマの以下の定数を使用できます:

定数	型	値	コメント
SQL use access rights	文字列	SQL_Use_Access_Rights	スクリプトのSQLコマンドの実行中に適用されるアクセス権を制限するために使用します。この属性を使用する場合、attribValueには1または0を渡します: attribValue = 1: 4Dはカレントユーザーのアクセス権を使用します。 attribValue = 0 (または属性を指定しない場合): 4Dはアクセスを制限しません。デザイナー権限が使用されます。

(SET DATABASE PARAMETERのセレクター28や45で) 4Dログファイルが有効にされていると、SQLコマンドが実行されるごとに以下の情報が書き込まれます:

SQLコマンドのタイプ
コマンドの影響を受けるレコード数
コマンドの実行時間
エラーを検知するごとに:
- エラーコード
- 可能であればエラーテキスト

スクリプトが (エラーなく) 正しく実行されると、OK変数に1が設定されます。エラーが発生した場合、OKシステム変数に0が設定されるか、またはerrorAction引数に設定に基づき:

errorAction がSQL On error abort (値1) の場合、OKは0に設定されます。
errorActionがSQL On error confirm (値2) の場合、ユーザが処理を中断するとOKに0が、続行を選択すると1が設定されます。
errorActionがSQL On error continue (値3) の場合、OKは常に1が設定されます。

Note: 大量のデータ読み込みなど、メモリを消費するアクションを実行するためにこのコマンドを使用する場合、一時的にSQLオプションを無効にするために新しいSQLのALTER DATABASEコマンドの実行を検討できます。