FireDAC.Comp.Script.TFDScript.SQLScripts

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

property SQLScripts: TFDSQLScripts read FSQLScripts write SetSQLScripts;

C++

__property TFDSQLScripts* SQLScripts = {read=FSQLScripts, write=SetSQLScripts};

プロパティ

種類 可視性 ソース ユニット
property published
FireDAC.Comp.Script.pas
FireDAC.Comp.Script.hpp
FireDAC.Comp.Script TFDScript

説明

SQL スクリプトのコレクションです。


SQLScripts プロパティを使用して、SQL スクリプトを外部 OS ファイルではなくアプリケーション メモリ内に格納し、管理することができます。

コレクション内の各項目には、スクリプトを識別するための Name プロパティと、実際にスクリプトを含んでいる SQL プロパティがあります。スクリプトは名前で参照することができます。インデックスがゼロの項目がメイン(ルート)スクリプトで、そこから実行が開始します。

SQL スクリプトの読み込みメカニズムは、OnGetText イベント ハンドラを使ってオーバーライドすることができます。あるいは、SQLScriptFileName プロパティを使って外部 OS ファイルから SQL スクリプトを送信することもできます。SQLScriptFileName プロパティの方が SQLScripts プロパティよりも優先度は上です。

ExecuteFile メソッドおよび ExecuteScript メソッドによって、既存の SQLScripts の内容がクリアされることに注意してください。

 with FDScript1.SQLScripts do begin
   Clear;
   with Add do begin
     Name := 'root';
     SQL.Add('@first');  // explicitly call 'first' script
     SQL.Add('@second'); // explicitly call 'second' script
   end;
   with Add do begin
     Name := 'first';
     SQL.Add('create table t1 (...);');
     SQL.Add('create table t2 (...);');
   end;
   with Add do begin
     Name := 'second';
     SQL.Add('create procedure p1 (...);');
     SQL.Add('create procedure p2 (...);');
   end;
 end;
 FDScript1.ValidateAll;
 FDScript1.ExecuteAll;

関連項目