SQL コードのインポート

InterSystems SQL のインポート

以下のいずれかの %SYSTEM.SQL.SchemaOpens in a new tab メソッドを使用して、InterSystems SQL コードをテキスト・ファイルからインポートできます。

• ImportDDL()Opens in a new tab は汎用の SQL インポート・メソッドです。このメソッドは、バックグラウンド (非インタラクティブ) プロセスとして実行されます。InterSystems SQL をインポートするには、3 つ目のパラメータとして “IRIS” を指定します。

• Run()Opens in a new tab は InterSystems SQL インポート・メソッドです。このメソッドは、ターミナルからインタラクティブに実行されます。ターミナルでは、インポート・テキスト・ファイルの場所や、Errors.log ファイルと Unsupported.log ファイルを作成する場所などの情報を指定するように求められます。

次の例では、InterSystems IRIS SQL コード・ファイル・パス名 mysqlcode.txt をインポートして、そのファイルにリストされている SQL コマンドを現在のネームスペース内で実行します。

  DO $SYSTEM.SQL.Schema.ImportDDL("c:\InterSystems\mysqlcode.txt",,"IRIS")

既定では、ImportDDL() は 2 つ目のパラメータで指定されたとおりに、エラー・ログ・ファイルを作成します。この例では、2 つ目のパラメータを省略して、既定で mysqlcode_Errors.log という名前のファイルが SQL コード・ファイルと同じディレクトリ内に作成されます。このログ・ファイルは、ファイルに書き込む内容がない場合でも作成されます。

ターミナルから ImportDDL() を実行すると、次の例に示すように、まず入力ファイルがリストされ、次にエラー・ログ・ファイル、その次にインポートされた各 SQL コマンドがリストされます。

Importing SQL Statements from file: c:\InterSystems\mysqlcode.txt
 
Recording any errors to principal device and log file: c:\InterSystems\mysqlcode_Errors.log

 SQL statement to process (number 1):
     CREATE TABLE Sample.NewTab (Name VARCHAR(40))
      Preparing SQL statement...
      Executing SQL statement...
  DONE
 
  SQL statement to process (number 2):
     CREATE INDEX NameIDX ON Sample.NewTab (Name)
      Preparing SQL statement...
      Executing SQL statement...
  DONE
 
Elapsed time: 7.342532 seconds

SQL コマンドでエラーが発生した場合、ターミナルに以下の例のようなエラーが表示されます。

SQL statement to process (number 3):
       INSERT INTO Sample.MyStudents (StudentName,StudentDOB) SELECT Name,
       DOB FROM Sample.Person WHERE Age <= '21'
    Preparing SQL statement...
ERROR #5540: SQLCODE: -30 Message:  Table 'SAMPLE.PERSON' not found
       Pausing 5 seconds - read error message!  (Type Q to Quit)

5 秒以内に終了しない場合、ImportDDL() は次の SQL コマンドを実行します。エラー・ログ・ファイルにエラーがタイムスタンプ、ユーザ名、ネームスペース名と共に記録されます。

  CREATE TABLE Sample.MyStudents (StudentName VARCHAR(32),StudentDOB DATE)
GO
  CREATE INDEX NameIdx ON TABLE Sample.MyStudents (StudentName)
GO
  INSERT INTO Sample.MyStudents (StudentName,StudentDOB) SELECT Name,
  DOB FROM Sample.Person WHERE Age <= '21'
GO
  INSERT INTO Sample.MyStudents (StudentName,StudentDOB) 
          VALUES ('Jones,Mary',60123)
GO
  UPDATE Sample.MyStudents SET StudentName='Smith-Jones,Mary' WHERE StudentName='Jones,Mary'
GO
  DELETE FROM Sample.MyStudents WHERE StudentName %STARTSWITH 'A'
GO

コード移行 ： 非 InterSystems SQL のインポート

他のベンダで使用されている SQL フォーマットに従った SQL コードをインポートできます。他のベンダのコードは、InterSystems SQL コードに変換されて実行されます。以下のメソッドが用意されています。

• ImportDDL()Opens in a new tab は汎用の SQL インポート・メソッドです。このメソッドは、バックグラウンド (非インタラクティブ) プロセスとして実行されます。このメソッドの使用法に関する一般的な情報は、"InterSystems SQL のインポート" を参照してください。

  特定フォーマットの SQL をインポートするには、そのフォーマットの名前を 1 つ目のパラメータとして指定します (FDBMS、Informix、InterBase、MSSQLServer (または MSSQL)、MySQL、Oracle、または Sybase)。

  次の例では、MSSQL コード・ファイル mssqlcode.txt をインポートして、そのファイルにリストされている SQL コマンドを現在のネームスペース内で実行します。

    DO $SYSTEM.SQL.Schema.ImportDDL($lb("C:\temp\somesql.sql","UTF8"),,"MSSQL")

  

  3 つ目のパラメータが MSSQL、Sybase、Informix、または MySQL の場合、最初のパラメータは SQL コード・ファイル・パス名または 2 要素の %List (最初の要素が SQL コード・ファイル・パス名で 2 つ目の要素が使用する入出力変換テーブル) です。

• 次のタイプの SQL をインポートするための個別のインタラクティブ・メソッドが %SYSTEM.SQL.SchemaOpens in a new tab で用意されています ： LoadFDBMS()Opens in a new tab、LoadInformix()Opens in a new tab、LoadInterBase()Opens in a new tab、LoadMSSQLServer()Opens in a new tab、LoadOracle()Opens in a new tab、および LoadSybase()Opens in a new tab。これらのメソッドは、ターミナルからインタラクティブに実行されます。ターミナルでは、インポート・テキスト・ファイルの場所や、Errors.log ファイルと Unsupported.log ファイルを作成する場所などの情報を指定するように求められます。

• ImportDDLDir()Opens in a new tab を使用すると、同じディレクトリ内の複数のファイルから SQL コードをインポートできます。このメソッドは、バックグラウンド (非インタラクティブ) プロセスとして実行されます。このメソッドは、Informix、MSSQLServer、および Sybase をサポートしています。すべてのインポート対象ファイルには .sql という拡張子接尾語が付加されている必要があります。

• ImportDir()Opens in a new tab を使用すると、同じディレクトリ内の複数のファイルから SQL コードをインポートできます。このメソッドでは、ImportDDLDir() より多くのオプションが用意されています。このメソッドは、バックグラウンド (非インタラクティブ) プロセスとして実行されます。このメソッドは、MSSQLServer と Sybase をサポートしています。許可されるファイル拡張子接尾語のリストを指定できます。