実装ガイド › アダプタ設定の指定 › SQL インターフェース セクション

SQL インターフェース セクション

SQL アダプタは、SQL ステートメントを使用してデータベースからデータを取得するために使用できます。

SQL インターフェースは、以下に説明するように、データベースへの接続、およびデータの取得に使用されるクエリを定義します。

XML 構造：

	< DataSourceInterface >
		<ConnectionString ConnectionTimeout="60" QueryTimeout="30">
			<![CDATA[ Driver={Microsoft Access Driver (*.mDataBase)};DataBaseq=d:\Oblicore\database1.mdatabase; ]]>
			</ConnectionString>
		<QueryCollection>
		<Query QueryName="cases" InputFormat="cases" SleepTime="3600">
			<SelectStatement AutoCompleteQuery="yes">
			select dateclosed,callid,dateopened,companyname,priority,closedmn,responsemn
			from calls where dateclosed is not NULL
			</SelectStatement>
		<QueryKeyFields>
			<KeyField Name="dateclosed" Sort="asc"/>
			<KeyField Name="callid" Sort="desc"/>
			<SelectInitialValues>
				Select min(dateclosed) , 'min date' from calls
			</SelectInitialValues>
		</QueryKeyFields>
	</Query>
	<Query QueryName="contracts" InputFormat="contracts" SleepTime="3600">
	<ConnectionString>
		<Segment Type="text"
		Text=" Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; DataBaseq="/>
		<Segment Type="File">
		<File Path="d:\Oblicore " NamePattern="Availabilty_*.XLS>
		</Segment>
		<Segment Type="text" Text=";"/>
	</ConnectionString>
<SelectStatement AutoCompleteQuery="yes">….</SelectStatement>
<QueryKeyFields>…..</QueryKeyFields>
</Query>
</QueryCollection>
</DataSourceInterface>

• ConnectionString - ソース データベースにアクセスするための接続文字列。

  ConnectionString は DataSourceInterface エレメントおよび（または）Query エレメントに定義できます。 DataSourceInterface エレメントの ConnectionString 定義はデフォルトであり、ConnectionString 定義がないクエリにのみ使用されます。

  接続文字列は、1 つの文字列で定義することも、セグメントによって定義することもできます。 ConnectionString エレメントに Segment エレメントが含まれていない場合は、ConnectionString エレメントのテキストから接続文字列が取得されます。 1 つ以上の Segment 要素が含まれる場合は、その Segment 要素から接続文字列が連結されます。

  セグメントには 2 つのタイプがあります。 1 つ目のタイプはテキストで、接続文字列にそのまま連結されるテキストを含んでいます。 2 つ目のタイプはファイルで、ワイルドカードがある（またはない）ファイル名を含んでいます。 ファイル セグメントは、1 回のみ指定することができ、読み取りファイルの扱い方を定義するその他の属性が含まれています。

  • ConnectionTimeout - （オプション）。 接続がオープンされるまでの待機時間（秒単位）を示す正の整数値。 値 0 は、接続がオープンされるまで無制限に待機することを示します。 デフォルト値は 15 秒です。

    注： 一部のプロバイダはこの機能をサポートしていません。

  • QueryTimeout - （オプション）。 クエリの実行が完了するまでの待機時間（秒単位）を示す正の整数値。 値 0 は、実行が完了するまで無制限に待機することを示します。 デフォルト値は 30 秒です。

    注： 一部のプロバイダはこの機能をサポートしていません。

  • Segment - セグメントの属性を指定します。
  • Type - （オプション）［text、file］。セグメントのタイプ。
  • Text - テキスト セグメントのテキスト。
  • File - ファイルの属性を指定します。
  • Path - ソース データ ファイルの場所へのパス。
  • NamePattern - ソース データのファイル名を指定します。ワイルドカードを使用できます。
  • InitialFileName - （オプション）。 どのファイルから検索を開始するか、および検索するパターンを示します。
  • UsePath - （オプション）［yes、no］。「yes」に設定すると、ファイル パスが接続文字列に連結されます。
  • UseFileName - （オプション）［yes/no］。「yes」に設定すると、ファイル名が接続文字列に連結されます（Excel ファイルの場合に必要）。
  • UpdateSchemaFile - （オプション）［yes/no］。 「yes」に設定すると、アダプタは schema.ini ファイルを現在のファイル名で更新します。

    注： アダプタによる schema.ini ファイル（テキスト ファイル用のデータベース）の変更を許可する場合のみこの属性を使用します。

• QueryCollection - クエリのコレクション（1 つのアダプタに複数のクエリを定義できます）。
  • PreliminaryCheck - （オプション）［yes/no］。 データベースへの接続時に、アダプタがクエリをチェックします。 この属性を「no」に設定すると、アダプタは変更しないで実行することによりクエリをチェックします。その後、アダプタは返されたレコードに対して処理を行い、それらを再度読み取りません。 「yes」に設定すると、アダプタは SELECT ステートメントの各「where」文字列を「where 1=2 and」に置換した後にクエリを実行します。 このオプションは、アダプタがレコードに対する実行を開始する前にすべてのクエリを確認し、この最適化によってクエリ時間が大幅に短縮される場合に使用します。 注 - 一部のプロバイダはクエリ処理を最適化しません。クエリが正しい場合、実行時間はこの追加を行わない場合にかかる時間と同じです。
  • ExternalCommand - （オプション）。 アダプタが新しい読み取りサイクルを開始する前に実行される外部コマンド。
  • Command - 実行されるバッチ ファイルの名前。
  • SleepTime - コマンドを再度実行するまでの待機時間（秒単位）を示す正の整数値。
• Query - クエリの属性を指定します。
  • QueryName - クエリの名前。
  • IsActive - （オプション）［yes/no］。 「no」に設定すると、アダプタはこのファイルからレコードを読み取りません。
  • InputFormat - このクエリに関連付けられている入力フォーマット。 アダプタは InputFormat を使用してソース レコードからデータを抽出します。
  • SleepTime - アダプタが新しいデータの到着を待機するためにダウンする時間（秒）。
  • Critical - （オプション）［yes/no］。 「yes」に設定すると、クエリにエラーが見つかった場合、アダプタはただちに停止します。 オプション「no」を使用するのは、設定ファイルを変更せずに解決される既知のエラーの場合です。
  • TransactionMode - （オプション）［implicit/explicit］。 「explicit」に設定すると、アダプタはクエリを実行する前にデータベース トランザクションを開始します。 このオプションを使用すると、大きくて複雑なクエリでのいくつかの問題が解決されます。
  • RollbackSegementName - （オプション）。 アダプタが使用するロールバック セグメントを定義します。 定義しない場合は、データベースがロールバック セグメントを選択します。
• SelectStatement - ソース データベース上で実行される、選択されたステートメントを格納します。
  • AutoCompleteQuery - （オプション）［yes/no］。 「yes」に設定すると、アダプタが以下のように自動で WHERE ステートメントを指定したクエリに連結します。
  • キー フィールドを基準にして新しい値のみを取得する WHERE ステートメントを作成する。
  • キー フィールドを基準にしてステートメントの結果を並べる。
• QueryKeyFields - 次のデータ取得を開始するフィールドを定義します。
  • KeyField：
  • Name - クエリのフィールドから取得されるフィールドの名前。
  • Sort - （オプション）［asc/desc］。 データの並べ替え方法（昇順/降順）。
  • Function - （オプション）。 フィールド値を関数と組み合わせて使用（:fieldname）するために、特殊な関数でこのフィールドを操作する必要がある場合に、この属性を使用します。 たとえば、Oracle の日付関数をフィールド名 Ts と使用する場合は次のように指定します： Function="to_date(':ts','dd/mm/yyy')"
  • ValueLeftWrapper - （オプション）。 フィールドの値の前に文字を連結するには、この属性を使用します。 文字列フィールドおよび日付フィールドのデフォルトは「'」（アポストロフィ）です。
  • ValueRightWrapper - （オプション）。 フィールドの値の後に文字を連結するには、この属性を使用します。 文字列フィールドおよび日付フィールドのデフォルトは「'」（アポストロフィ）です。
  • NameLeftWrapper - （オプション）。 フィールド名の前に文字を連結するには、この属性を使用します。 デフォルトは NULL 文字列です。
  • NameRightWrapper - （オプション）。 フィールド名の後に文字を連結するには、この属性を使用します。 デフォルトは NULL 文字列です。
  • IsPrimaryKey - （オプション）［yes/no］。 「no」に設定すると、アダプタはクエリの自動 where ステートメントでこのキーを使用しません。
  • DefaultInitialValue - （オプション）。 SelectInitialValues クエリがレコードを返さなかった場合、アダプタはここからデフォルト値を取得します。 キー フィールドが複数ある場合は、すべてのキー フィールドにこの属性が必要となります。
  • SelectInitialValues - 最初の WHERE ステートメントの初期値を提供する SELECT ステートメント（制御ファイルが空の場合）。

    注： 値の順序は、この QueryKeyFields のフィールド エレメントと同じにして、各フィールドに結果を返す必要があります。