CData Python Connector for Amazon Athena

Build 24.0.9062

INSERT INTO SELECT ステートメント

Amazon Athena への1回の要求で複数の挿入処理を実行するには、INSERT INTO SELECT 構文を使用して、データの一時テーブルをAmazon Athena に挿入します。このとき、Amazon Athena に送信されるデータは、まず一時テーブルに入力されます。挿入するデータがすべて一時テーブルに入力されたら、そのテーブルがAmazon Athena のテーブルに渡されます。

一時テーブルへの入力

入力先の一時テーブルは動的なテーブルで、実行時に最初のデータをテーブルに入力するときに作成されます。一時テーブルは、その名前に「#」を付加して示されます。一時テーブルを使用してデータを挿入する場合、その一時テーブルには「[TableName]#TEMP」という形式で名前を付ける必要があります。「TableName」は、データを挿入するテーブルの名前です。 次に例を示します。

INSERT INTO [AwsDataCatalog].[sampledb].Customers#TEMP (TotalDue, MyCustomField__c) VALUES ('New Customers', '9000');
INSERT INTO [AwsDataCatalog].[sampledb].Customers#TEMP (TotalDue, MyCustomField__c) VALUES ('New Customers 2', '9001');
INSERT INTO [AwsDataCatalog].[sampledb].Customers#TEMP (TotalDue, MyCustomField__c) VALUES ('New Customers 3', '9002');

このコードでは、2つのデータカラムと3つのデータ行を含む「[AwsDataCatalog].[sampledb].Customers#TEMP」という名前の一時テーブルが作成されます。一時テーブルでは型を指定できないため、すべての値が文字列としてメモリに保存されます。これらの値の型は、[AwsDataCatalog].[sampledb].Customers テーブルに送信された後で正しい型に変換されます。

実際のテーブルへの挿入

一時テーブルにデータが入力されたら、Amazon Athena の実際のテーブルに対して挿入を実行します。そのためには、実際のテーブルへの挿入(INSERT)を実行し、一時テーブルから入力データを選択します。次に例を示します。

INSERT INTO [AwsDataCatalog].[sampledb].Customers (TotalDue, MyCustomField__c) SELECT TotalDue, MyCustomField__c FROM [AwsDataCatalog].[sampledb].Customers#TEMP
この例では、[AwsDataCatalog].[sampledb].Customers#TEMP テーブルのすべての内容が[AwsDataCatalog].[sampledb].Customers テーブルに渡されます。この結果、各要求で複数のINSERT を送信できるため、Amazon Athena に送信される要求の数が少なくて済み、多くのレコードを挿入する場合のパフォーマンスが向上します。

結果

クエリの結果は、一時テーブルLastResultInfo#TEMP に保存されます。次に一時テーブルが渡されてデータが変更されると、このテーブルはクリアされて、データが再挿入されます。LastResultInfo#TEMP テーブルはスキーマが事前定義されていないことに注意してください。データを読み取る前に、実行時にそのメタデータを確認する必要があります。

一時テーブルの存続時間

一時テーブルは、接続が開いている間だけ存続します。Amazon Athena への接続が閉じられると、LastResultInfo#TEMP テーブルを含むすべての一時テーブルがクリアされます。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062