Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

Caché SQL のインポート

Caché SQL のインポート

以下のいずれかのメソッドを使用して、Caché SQL コードをテキスト・ファイルからインポートできます。

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

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

次の例では、Caché SQL コード・ファイル mysqlcode.txt をインポートして、このファイルの SQL 文を現在のネームスペース内で実行します。

  DO $SYSTEM.SQL.DDLImport("CACHE","glenn","c:\temp\mysqlcode.txt",,1)

既定では、DDLImport() はエラー・ログ・ファイルを作成します。この例では、mysqlcode_Errors.log という名前のファイルが SQL コード・ファイルと同じディレクトリ内に作成されます。5 番目のパラメータは、サポートされていない文が列挙されたファイルを作成するかどうかを指定するブーリアン値です。既定値は 0 です。この例では、5 番目のパラメータが 1 に設定されているため、mysqlcode_Unsupported.log という名前のファイルが SQL コード・ファイルと同じディレクトリ内に作成されます。これらのログ・ファイルは、各ファイルに書き込む内容がない場合でも作成されます。

インポート・ファイル形式

SQL テキスト・ファイルは、.txt ファイルなどの書式なしファイルである必要があります。各 SQL 文はそれぞれ新しい行で始まる必要があります。1 つの SQL 文を複数の行に分けることができ、インデントが許可されています。既定では、各 SQL 文の後ろには、GO 文をそれぞれの行に記述する必要があります。

以下は、有効な Caché SQL インポート・ファイル・テキストの例です。

CREATE TABLE Sample.MyStudents (StudentName VARCHAR(32),
StudentDOB DATE)
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
INSERT OR UPDATE INTO Sample.MyStudents (StudentName,StudentDOB) VALUES ('Smith-Jones,Mary',60123)
GO
DELETE FROM Sample.MyStudents WHERE StudentName %STARTSWITH 'A'
GO
SELECT TOP 5 * FROM Sample.MyStudents
GO

DDLImport("CACHE")deos という 7 番目のパラメータを設定した場合は、このメソッドは、各 SQL 文の末尾に配置された、指定された文末区切り文字 (一般にセミコロン ;) を受け付けることができます (ただしこの区切り文字は必須ではありません)。既定では、文末区切り文字はサポートされません。SQL 文の後続行の “GO” 文は常にサポートされていますが、deos で文末区切り文字が指定されている場合は、この GO 文は必須ではありません。

サポートされている SQL 文

すべての有効な Caché SQL コードをインポートできるわけではありません。以下は、サポートされている Caché SQL コマンドのリストです。

  • CREATE TABLEALTER TABLEDROP TABLE

  • CREATE VIEWALTER VIEWDROP VIEW

  • CREATE INDEX (ビットスライスを除くすべてのインデックス・タイプ)

  • CREATE USERDROP USER

  • CREATE ROLE

  • GRANTREVOKE

  • INSERTUPDATEINSERT OR UPDATEDELETE

  • SET OPTION

  • SELECT (オプティマイザ・プラン・モード専用)

FeedbackOpens in a new tab