データベースモジュール

データベース向けのこの技術固有モジュールは、特定のタスクを実行する標準モジュールです。Tosca Cloudは、以下のデータベースモジュールをサポートしています。

DB Open Connection : 1つまたは複数のデータベースに接続します。
DB Current Connection: 接続を更新します。
DB Close Connection: 接続を手動で閉じます。
DB Run SQL Statement: データベーステーブルのデータセットを管理します。
DB Expert module: データベースステートメントを管理します。

DB Open Connection

データベースへの接続を開きます。複数のデータベース接続を開くことができます。Tosca Cloud は、テスト用に直近に確立された接続を使用します。あるいは、Current Connectionモジュールを使用して別の接続を指定することもできます。

値	説明
接続名	開きたい接続の名称。これはオプションです。デフォルトでは、Tosca Cloud は、接続名としてDSN値を使用します。既に存在する接続名を入力した場合、Tosca Cloud は新しい接続を確立しません。
DSN	ODBCデータベースのデータソース名。 SQLite、MS SQL、または一般的なODBCデータベースに接続する場合は、接続文字列を使用してください。
DSN->User ID	接続を開くユーザーのID。
DSN->Password	ユーザーのパスワード。
接続文字列	SQLite、MS SQL、または一般的なODBCデータベースに接続するための接続文字列。
Connection string->Driver	SQLite、MSSQL、または一般的なODBCデータベースのいずれを使用しているかを指定します。これを行うには、Valueドロップダウンから該当する値を選択します。

DB Current Connection

直近に開いた接続とは異なる接続を使用することを指定します。

値	説明
Connection name	使用したい接続の名前。

DB Close Connection

デフォルトでは、Tosca Cloud は、実行が完了するとすべての接続を閉じます。

あるいは、DB Close Connectionモジュールを用いて手動で接続を閉じることもできます。この場合、データベース技術は、接続が開かれた際に作成されたリソースも削除します。

どの接続を閉じるかについて十分注意してください。後のテストケースで必要としない接続のみを閉じてください。

値	説明
Connection name	閉じたい接続の名前。

DB Run SQL Statement

1つまたは複数のデータベーステーブルのデータセットを操作します。最も最近開かれた接続のデータベースにアクセスします。DB Current Connectionモジュールで異なる接続を指定した場合、このモジュールはそのデータベースの代わりにアクセスします。

値	説明
SQL Statement	実行するSQL文。
Command Timeout	SQL文を中止し、失敗として報告するまでにTosca Cloudが待機すべき秒数です。デフォルトのタイムアウトは60秒です。値を0に設定した場合、無限に待機します。
Result Table	必要に応じて、テーブルプロパティRowsAffectedをバッファあるいは検証できます。このプロパティは、指定されたSQL文が影響を与えた行数を示します。ステートメントがいずれの行にも影響を与えなかった場合、値は0になります。SELECTステートメントの場合、値は-1です。あるいは、SQL文の結果をカンマ区切りのCSVファイルにエクスポートしたい場合、以下の手順を行います。 Result Tableの値として{EXPORTTOCSV[<absolute path to the CSV file>]}を入力します。アクションモードInsertまたはSelectを使用します。実行時にファイルが存在しない場合、Tosca Cloud が作成します。同じ名前のファイルがこのパスに既に存在する場合、Tosca Cloud は既存のファイルを上書きします。
Row / Row->Cell	操作する特定の行のセルを指定します。テーブル操作の読み取り専用アクションモードのいずれかを使用できます。InputおよびInsertアクションモードはサポートしていません。
Column / Column->Cell	操作する特定の列のセルを指定します。テーブル操作の読み取り専用アクションモードのいずれかを使用できます。InputおよびInsertアクションモードはサポートしていません。

DB Expert module

データベースステートメントを単一のモジュールで処理します。

値	説明
接続を開く	読み取り専用です。
Open Connection->Connection name	すでに接続を開いている場合は、使用する接続名。新しい接続を開くこともできます。この場合、接続名を次の接続識別子のいずれかとともに使用してください。 DSN、ユーザーID、パスワード接続文字列
Open Connection->DSN	ODBCデータベースのデータソース名。 SQLite、MS SQL、または一般的なODBCデータベースに接続する場合は、接続文字列を使用してください。
Open Connection->DSN->Password	ユーザーのパスワード。
Open Connection->Connection String	SQLite、MS SQL、または一般的なODBCデータベースに接続するための接続文字列。
Open Connection->Connection String->Driver	SQLite、MSSQL、または一般的なODBCデータベースのいずれを使用しているかを指定します。これを行うには、Valueドロップダウンから該当する値を選択します。
SQL Statement	実行するSQL文。
Command Timeout	システムがSQL文を中止し、失敗として報告するまでの待機時間（秒）。デフォルトのタイムアウトは60秒です。値0を設定すると、タイムアウトは無期限になります。
Result Table	必要に応じて、テーブルプロパティRowsAffectedをバッファあるいは検証できます。このプロパティは、指定されたSQL文が影響を与えた行数を示します。ステートメントがどの行にも影響しなかった場合、値は0になります。SELECTステートメントの場合、値は-1です。あるいは、SQL文の結果をカンマ区切りのCSVファイルにエクスポートしたい場合、以下の手順を行います。 Result Tableの値として{EXPORTTOCSV[<absolute path to the CSV file>]}を入力します。アクションモードInsertまたはSelectを使用します。実行時にファイルが存在しない場合、Tosca Cloud が作成します。同じ名前のファイルがこのパスに既に存在する場合、Tosca Cloud は既存のファイルを上書きします。
Row / Row->Cell	操作する特定の行のセルを指定します。システムはすべての読み取り専用テーブル操縦アクションモードをサポートしております。アクションモードInputおよびInsertはサポートしていません。
Column / Column->Cell	操作する特定の列のセルを指定します。システムはすべての読み取り専用テーブル操作アクションモードをサポートしています。アクションモードInputおよびInsertはサポートしていません。
Close connection	接続を閉じるかどうかを指定します。値Trueを指定すると、接続を閉じます。これはデフォルト値です。値Falseを指定すると、接続を開いたままにします。