ユースケース

レコードを挿入する際、親レコードに依存する子レコードに関する詳細を入力する必要がある状況は度々発生します。

例えばCRM システムを使う場合には、Invoices を入力するには最低1つの明細行が必要です。請求書の行項目は複数のフィールドを持つことができるため、こうしたInvoices の仕様は、データをリレーショナルテーブルとして提供する際に問題となります。データを読み込む際、外部キーで接続されたInvoice とInvoiceLineItem テーブルをモデル化するのは容易です。しかし挿入の際には、CRM システムはInvoice およびInvoiceLineItems を1つの操作で作成する必要があります。

こうした問題を解決するために、CData のツールは親コレクションカラム上に子コレクションカラムを提供します。これらのカラムは、親および子レコード両方の情報を持つINSERT ステートメントを発行する際に使用することができます。

例えば、Invoice テーブルにInvoiceLineItems というシングルカラムがあるとします。 挿入の際には、InvoiceLineItems テーブルに挿入する必要があるレコードの詳細を、Invoice レコードのInvoiceLineItems カラムに渡すことができます。

次のセクションでは、この方法を説明します。

親 / 子レコードを挿入する方法

一時（#TEMP）テーブル

データを入力する最も簡易な方法は、connector がメモリに格納する#TEMP テーブル、または一時テーブルを使用することです。

#TEMP テーブルは以下の構文で参照してください。

TableName#TEMP

#TEMP テーブルは接続中はメモリに格納されます。

そのため、これらのテーブルを使用するには挿入の発行間で接続を閉じることはできず、各クエリで異なる接続を使用する環境では一時テーブルは使用できません。

単一の接続内では、テーブルはバルク挿入が成功するまでメモリに残り、成功した時点でメモリから消去されます。

例：

INSERT INTO InvoiceLineItems#TEMP (ReferenceNumber, Item, Quantity, Amount) VALUES ('INV001', 'Basketball', 10, 9.99)
INSERT INTO InvoiceLineItems#TEMP (ReferenceNumber, Item, Quantity, Amount) VALUES ('INV001', 'Football', 5, 12.99)

InvoiceLineItems テーブルに書き込みが行われた後で、Invoice テーブルへの挿入中に#TEMP テーブルが参照されます。

INSERT INTO Invoices (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', 'InvoiceLineItems#TEMP')

内部ではconnector が#TEMP テーブルから値を読み込みます。

ReferenceNumber は、どのInvoice に明細が紐付けられているかを特定するのに使用されています。これは、各Invoice に別々の明細が記載されている状況で、#TEMP テーブルにバルク挿入で書き込みが行われ、使用される可能性があるためです。 これで#TEMP テーブルをバルク挿入で使用することができます。例：

INSERT INTO Invoices#TEMP (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', 'InvoiceLineItems#TEMP')
INSERT INTO Invoices#TEMP (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV002', 'Jane Doe', 'InvoiceLineItems#TEMP')
INSERT INTO Invoices SELECT ReferenceNumber, Customer, InvoiceLines FROM Invoices#TEMP

この場合、2つの異なるInvoice を挿入しています。ReferenceNumber によって、どのLines がどのInvoice に入力されるかを決定します。

Note：ここで示したテーブルとカラムは、connector が一般にどのように動作するかを示す一例です。特定のテーブルおよびカラム名は、connector 内で異なることがあります。

Example for WooCommerce

For a working example of how temp tables can be used for bulk insert in WooCommerce, please see the following:

// Insert into Products table
INSERT INTO Products#TEMP (Name) values ('test010')
INSERT INTO Products#TEMP (Name) values ('test110')

Insert INTO Products (Name) SELECT Name FROM Products#TEMP


// Insert into Products table
INSERT into ProductCategories#TEMP (Id,Name) values (17,'Uncategorized')

INSERT INTO Products#TEMP (Name,CategoriesAggregate) values ('name1',ProductCategories#TEMP)

Insert into Products (Name,CategoriesAggregate) SELECT Name,CategoriesAggregate from Products#TEMP


// Insert into Products table
INSERT into ProductCategories#TEMP (ReferenceNumber,Id,Name) values (1,17,'Uncategorized')
INSERT into ProductCategories#TEMP (ReferenceNumber,Id,Name) values (2,18,'Categorized')

INSERT INTO Products#TEMP (ReferenceNumber,Name,CategoriesAggregate) values (1,'name1',ProductCategories#TEMP)
INSERT INTO Products#TEMP (ReferenceNumber,Name,CategoriesAggregate) values (2,'name2',ProductCategories#TEMP)

Insert into Products (ReferenceNumber,Name,CategoriesAggregate) SELECT ReferenceNumber,Name,CategoriesAggregate from Products#TEMP

//Update Products table
INSERT INTO Products#TEMP (Id,Name) values (264,'test010')
INSERT INTO Products#TEMP (Id,Name) values (265,'test020')

Update Products (Id,Name) SELECT Id,Name from Products#TEMP

// Delete from Products Table
INSERT INTO Products#TEMP (Id) values (264)
INSERT INTO Products#TEMP (Id) values (265)

Delete from Products Where exists SELECT Id from Products#TEMP