create connection string
指定されたデータベースへの接続文字列を生成します。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
variable | (任意)返された接続文字列を受け取るための変数の名前です。 | String | なし |
driver | (任意)現在の接続に指定されたODBCドライバの名前です。 | String | なし |
host | (Excel以外のDBMSソースにのみ使用) DBMSサーバーのホスト名またはIPアドレスです。 (任意で、インスタンス名をバックスラッシュで前置することもできます。例: myhost\myinstance) | String | なし |
port | (DBMSソース用のオプション; Excelでは使用しません) DBMSサーバーのポートです。 デフォルト値: MSSQLはポート1433を使用; MySQLはポート3306を使用します。 | String | なし |
database name | (任意)接続するデータベースの名前です。 | String | なし |
username | (任意)データベースにログインするためのユーザー名です。 | String | なし |
password | (任意)ユーザー名で指定されたデータベースアカウントのパスワードです。 | String | なし |
others | (任意)ホストDBMSに適用されるその他の接続文字列パラメーター、キーと値がセミコロンで区切られた形式です。 | 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
- このアクションは、一般的にテストがデータソースにアクセスできるようにする一連のアクションの一部として呼び出されます。(詳細については Testing with databases を参照してください)
- 接続文字列の性質、つまり、それに適用されるパラメーターは、それが対象とするデータソースの種類に固有です。接続文字列に関する詳細情報は、ウェブサイト www.connectionstrings.com から入手できます。
- MySQLデータベースに接続する場合:
- 関連する execute sql コールのいずれかが、そのコマンド引数に複数のクエリを含む場合、others 引数には設定
Option=67108864;
を含める必要があります。 - FreeTDS ODBC ドライバーを使用して Unicode をサポートする接続を作成する場合、others には
ClientCharset=UTF-8;
を含める必要があります。
- 関連する execute sql コールのいずれかが、そのコマンド引数に複数のクエリを含む場合、others 引数には設定
- データソース名(DSN)の使用がサポートされています。DSNは、以下のフォーマットで他の引数に指定できます:
- ユーザーおよびシステム DSN:
DSN=myDsn;
- ファイル DSN:
FILEDSN=c:\myDsnFile.dsn;
(詳細については (DSN) Windowsでのデータソース名(DSN)の作成 の作成を参照してください)
- ユーザーおよびシステム DSN:
- 引数 variable の変数が宣言されていない場合は、そのアクションはそれをグローバルとして作成します。
- 引数 variable が空の場合は、TestArchitect は「_result」という名前のグローバル変数に値を供給します。
- このアクションは修飾子 <ignore> をサポートしています。文字列
<ignore>
が引数の値として存在する場合、または引数に<ignore>
と評価する式を含まれている場合、アクションは実行中にスキップされます。