sa_copy_cursor_to_temp_table( 
cursor_name, 
table_name 
[ , first_row [, max_rows ] ]
) 

いくつかの整数カラムのカーソルが存在している場合を想定します。sa_copy_cursor_to_temp_table では、次の形式の文を使用して、テンポラリテーブルを作成します。

BEGIN
  CREATE LOCAL TEMPORARY TABLE TempTab (
      col1 INT,
      col2 INT,
  ...
rownum bigint primary key )
END;

sa_copy_cursor_to_temp_table では、カラムに col1、col2 などの名前を付け、名前の重複や、カーソルカラムの名前が適切に定義されていない場合 (たとえば、複雑な式の場合) の問題を回避します。

テンポラリテーブルが作成されると、オープンカーソルの内容が挿入されます。このとき、first_row に指定したロー番号まで移動し、max_rows に指定した数のローが挿入されます。テンポラリテーブルに内容が挿入された後、カーソルは元のロケーションに再配置されます。

なし。

カーソルからコピーすると、カーソルの独立性設定を使用してローがフェッチされます。これにより、ローがロックされ、カーソルからフェッチする場合と同じ、他の影響が発生する場合があります。

現在の接続の外部で同時に変更が加えられ、カーソルが実体化または独立性設定によって保護されていない場合、プロシージャーが完了した後でカーソルが別のローに配置される可能性があります。たとえば、直前に最新のローとなっていたローが削除された場合は、カーソルが元の位置の後のローに再配置されることがあります。

カーソルからのコピー中にエラーが発生した場合、カーソルは無効な状態になり、カーソルに対するそれ以降の操作はエラーで失敗します。

• sa_list_cursors システムプロシージャー
• sa_describe_cursor システムプロシージャー

次のバッチでは、myCursor というカーソルを作成し、Products テーブルからデータをロードします。その後、カーソルが開かれます (OPEN 文)。DROP 文では、myTempTable (すでに存在する場合) を削除します。sa_copy_cursor_to_temp_table を呼び出すと、myTempTable というテンポラリテーブルが作成され、そのテーブルに myCursor の内容がコピーされます。最後に、SELECT 文によって、カーソルからテンポラリテーブルにコピーされたデータが返されます。

begin 
  DECLARE myCursor CURSOR FOR 
      SELECT Id, Name, Description, Color, Quantity FROM Products;
  OPEN myCursor;
  DROP TABLE IF EXISTS myTempTable;
  CALL sa_copy_cursor_to_temp_table( 'myCursor','myTempTable' );
  CLOSE myCursor;
  SELECT * FROM myTempTable;
end