connect database
データベース接続を開きます。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
connection string | データベース接続を開くために使用される文字列です。 | String | なし |
name | 接続名です。(以下の 事項を参照してください) | String | なし |
なし
以下の例は、テスト内からデータベースに接続し、使用するプロセスを示しています。 アクション create connection string で名前付き接続文字列を作成した後、このアクションによってその文字列がデータベースに接続するために使用されます。
variable driver host
create connection string Northwind_conn_strg SQL Server lgdn15031-w7d01
 
port database name username
>>> Northwind
 
password others
>>> Trusted_Connection=Yes
 
connection string name
connect database #Northwind_conn_strg Northwind_conn
 
name
use database Northwind_conn
 
command result
execute sql select ContactName from Customers where CustomerID='ABOUT' contactname_ds
- このアクションは、一般的にテストがデータソースにアクセスできるようにする一連のアクションの一部として呼び出されます。(詳細については データベースを使用したテスト を参照してください)
- 接続文字列の値は、アクション create connection string を呼び出すことで得ることができます。接続文字列の性質、つまりそれに適用されるパラメータは、それが対象とするデータソースの種類に固有です。接続文字列に関する詳細情報は、www.connectionstrings.com のウェブサイトから入手できます。
- このアクションを別々に呼び出すことで、異なるデータベースへの複数の同時接続を確立できます。ただし、任意の時点で use database 接続は1つだけです。
- MySQLデータベースに接続する場合:
- 関連する実行 execute sql のいずれかがコマンド引数に複数のクエリを含む場合、接続文字列に
Option=67108864;
を含める必要があります。 - FreeTDS ODBC ドライバーを使用して Unicode をサポートする接続を作成する場合、接続文字列に
ClientCharset=UTF-8;
が含まれている必要があります。
- 関連する実行 execute sql のいずれかがコマンド引数に複数のクエリを含む場合、接続文字列に
- 引数 name で指定する名前は、データベース接続に割り当てられ、テスト実行セット全体でグローバルに利用でき、ビルトインアクションである use database/disconnect database で使用することができます。
- このアクションは修飾子 <ignore> をサポートしています。文字列
<ignore>
が引数の値として存在する場合、または引数に<ignore>
と評価する式を含まれている場合、アクションは実行中にスキップされます。