入力ストリームは使用せず、すべて無視します。

AutoCache が設定されていると、本製品 はテーブルデータのキャッシュを選択したデータベースに自動的に保存します。デフォルトでは、本製品 はキャッシュをインクリメンタル更新します。前回の実行からの時間がCacheTolerance を超えた場合は、最後のSELECT クエリが実行された後の変更のみを取得します。キャッシュが更新された後、キャッシュデータに対してクエリが実行されます。 CacheQueryResult を追加設定すると、本製品 はSELECT クエリを実行したときにキャッシュを更新し、Eloqua データからライブ結果を返します。

SELECT 結果を明示的にキャッシュする

CacheQueryResult は、キャッシュのオフライン使用を維持しながら、リアルタイムでEloqua をクエリする手段です。SELECT ステートメントを実行するときには、CacheQueryResult を設定してキャッシュを更新します。AutoCache とCacheQueryResult セットでSELECT ステートメントを実行すると、本製品 はリモートデータにクエリを実行し結果をキャッシュします。既存の行は上書きされます。つまり、SELECT ステートメントは、キャッシュのクエリではなくキャッシュの作成および更新に使用されます。 データ操作コマンドはリモートデータに対しても実行されます。

キャッシュされたデータをクエリするには、Offline プロパティを設定します。キャッシュデータをオンライン接続でクエリする必要がある場合は、#CACHE をテーブル名に追加します。次に例を示します。

SELECT * FROM [Contact#CACHE]

キャッシュデータベースの設定

AutoCache が設定されている場合、本製品 はシンプルなファイルベースキャッシュにキャッシュします。次のプロパティを使って、場所またはキャッシュを別のデータベースに構成できます。

• CacheLocation：ファイルストアへのパスを指定します。
• CacheDriver およびCacheConnection：ドライバーをデータベースと接続文字列に指定します。

参照

• CacheTolerance：キャッシュ内の失効データに対する許容範囲を制御します。
• CacheQueryResult：キャッシュ内の対応するテーブルに返された各行を挿入または更新します。
• キャッシング：ベストプラクティス：このセクションでは、AutoCache とOffline を併用する例と、キャッシュストラテジーの決定に関する情報を提供します。
• CacheMetadata：このプロパティは、Eloqua メタデータから取得したテーブルスキーマを永続化することによって、ネットワークを横断するメタデータの量を減らします。メタデータは、すべての接続で取得する必要はなく、一度取得するだけです。
• REPLICATE ステートメント：AutoCache セットでSELECT ステートメントを実行すると、AutoCache は内部的にREPLICATE ステートメントを呼び出します。REPLICATE ステートメントは、最初にキャッシュされたテーブルを削除するのではなく、インクリメンタル更新を有効にします。
• CACHE ステートメント：CACHE ステートメントを使って、SELECT クエリを永続化し、キャッシュを管理（例えば、スキーマのリフレッシュ）ができます。

BatchSize を0 より大きい値に設定すると、バッチ処理はバッチ全体をBatchSize のバッチに分割します。 分割されたバッチは、個別にサーバーに送信されます。これは、サーバーに送信されるリクエストのサイズに制限がある場合に役立ちます。

BatchSize を0 に設定すると、指定されたバッチ全体が送信されます。

一括クエリの応答の可用性を確認するリクエスト間の時間間隔。UseBulkAPI が設定されると、本製品 はEloqua にクエリへの応答を準備するよう要求します。そして、サーバーを定期的にポーリングしてステータスを確認することで応答が準備完了になるのを待ちます。このプロパティは、ポーリングの頻度を制御します。

本製品 が一括クエリの応答を待機するタイムアウト（分単位）。デフォルト値は25分です。UseBulkAPI が設定されると、本製品 はEloqua にクエリへの応答を準備するよう要求します。そして、サーバーを定期的にポーリングしてステータスを確認することで応答が準備完了になるのを待ちます。このプロパティは、本製品 が応答を待つ合計時間を制御します。

このプロパティはTimeout とはまったく異なります。Timeout は、あらゆる応答の待ち時間を制御する非活動タイムアウトです。このプロパティは、一括クエリを実行するまでの合計待ち時間を制御します。 ;

キャッシュデータベースは、CacheDriver およびCacheConnection プロパティに基づいて決定されます。キャッシュデータベースを使用するには、両方のプロパティが必須です。以下に、一般的なキャッシュデータベースの設定例を示します。キャッシュデータベースのドライバーの設定方法についての詳細は、CacheDriver を参照してください。

CacheConnection プロパティで指定された接続文字列は、基底のCacheDriver に直接渡されます。 使用可能なプロパティについての詳細は、JDBC driver 固有のドキュメントを参照してください。アプリケーションのクラスパスにJDBC driver を含めてください。

Derby およびJava DB

本製品 はDerby へのキャッシュを簡略化します。CacheLocation プロパティを設定するだけで基本的な接続ができます。

あるいは、CacheProvider およびCacheConnection を使用してDerby への接続を手動で設定することもできます。 以下はDerby JDBC URL 構文です。

jdbc:derby:[subsubprotocol:][databaseName][;attribute=value[;attribute=value] ... ]

jdbc:derby:memory

SQLite

SQLite へキャッシュするにはSQLite JDBC ドライバーを使用できます。以下はJDBC URL の構文です。

jdbc:sqlite:dataSource

• Data Source：SQLite データベースファイルへのパス。または、:memoryの値を使ってインメモリにキャッシュします。

MySQL

インストールにはCData JDBC Driver for MySQL が含まれています。次にJDBC URL の例を示します。

jdbc:mysql:User=root;Password=root;Server=localhost;Port=3306;Database=cache

• Server：接続しようとするサーバーのIP アドレス、もしくはドメイン名。
• Port：サーバーが起動しているポート名。
• User：データベースへの認証のためのユーザー名。
• Password：データベースへの認証のためのパスワード。
• Database：データベース名。

SQL Server

Microsoft JDBC Driver for SQL Server のJDBC URL の構文は次のとおりです。

jdbc:sqlserver://[serverName[\instance][:port]][;database=databaseName][;property=value[;property=value] ... ]

jdbc:sqlserver://localhost\sqlexpress:1433;integratedSecurity=true

• Server：SQL Server を起動しているコンピューターのネットワークアドレス名。デフォルトインスタンスの代わりに名前付きインスタンスに接続する場合は、このプロパティを使ってホスト名およびインスタンスをバックスラッシュで区切って指定できます。
• Port：SQL Server が起動しているポート。
• Database：SQL Server データベース名。
• Integrated Security：現在のWindows アカウントを認証に使用する場合は、このオプションをtrue に設定します。接続でUser とPassword を設定する場合は、このオプションをfalse に設定します。

  統合セキュリティを使用するには、Windows システムパス上のフォルダにsqljdbc_auth.dll も追加する必要があります。このファイルは、Microsoft JDBC Driver for SQL Server インストールのauth サブフォルダにあります。アセンブリのビット数はJVM のビット数と一致する必要があります。

• User ID：SQL Server との認証に使われるユーザー名。統合セキュリティを使用していない場合にのみ必要です。
• Password：SQL Server との認証に使われるパスワード。統合セキュリティを使用していない場合にのみ必要です。

Oracle

以下はOracle JDBC Thin ドライバーの従来のJDBC URL シンタックスです。

jdbc:oracle:thin:[userId/password]@[//]host[[:port][:sid]]

jdbc:oracle:thin:scott/tiger@myhost:1521:orcl

• Data Source：Oracle データベースを識別する接続記述子。これは、TSN 接続記述子、接続記述子を決定するOracle Net Services 名、またはバージョン11g以降ではEasy Connect ネーミング（任意のポート名およびサービス名を持つOracle サーバーのホスト名）になります。

• Password：Oracle データベースへの認証のためのパスワード。
• User Id：Oracle データベースへの認証のためのユーザーID。

PostgreSQL

以下は公式のPostgreSQL JDBC ドライバーのJDBC URL 構文です。

jdbc:postgresql:[//[host[:port]]/]database[[?option=value][[&option=value][&option=value] ... ]]

jdbc:postgresql:postgres

• Host：PostgreSQL データベースをホストしているサーバーのアドレス。
• Port：PostgreSQL データベースをホスティングしているサーバーに接続する際のポート。
• Database：データベース名。
• Username：PostgreSQL データベースの認証用に提供されたユーザーId。"user" パラメータを使ってJDBC URL に指定できます。
• Password：PostgreSQL データベースへの認証のためのパスワード。

CData JDBC drivers を含むJDBC ドライバーが用意されている任意のデータベースにキャッシュできます。

キャッシュデータベースは、CacheDriver およびCacheConnection プロパティに基づいて決定されます。 CacheDriver は、データのキャッシュに使用するJDBC ドライバークラスの名前です。

CacheDriver JAR をクラスパスに追加する必要があります。

次の例は、いくつかの主要なデータベースにキャッシュする方法を示しています：JDBC URL 構文および一般的な接続プロパティの詳細については、CacheConnection を参照してください。

Derby およびJava DB

本製品 はDerby 設定を簡略化します。Java DB は、Derby のOracle ディストリビューションです。JAR はJDK に同梱されています。JAR、derby.jar は、JDK インストールフォルダのdb サブフォルダに格納されています。ほどんどのキャッシュシナリオでは、derby.jar をクラスパスに追加した後、次のものだけを指定する必要があります。

jdbc:eloqua:CacheLocation='c:/Temp/cachedir';User=user;Password=password;Company=MyCompany

jdbc:eloqua:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';User=user;Password=password;Company=MyCompany

SQLite

以下はSQLite JDBC ドライバーのJDBC URL です。

jdbc:eloqua:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';User=user;Password=password;Company=MyCompany

MySQL

以下はCData JDBC Driver for MySQL のJDBC URL です。

  jdbc:eloqua:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';User=user;Password=password;Company=MyCompany
  

SQL Server

次のJDBC URL はMicrosoft JDBC Driver for SQL Server を使用しています。

jdbc:eloqua:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';User=user;Password=password;Company=MyCompany

Oracle

以下はOracle Thin Client のJDBC URL です。

jdbc:eloqua:Cache Driver=oracle.jdbc.driver.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';User=user;Password=password;Company=MyCompany

PostgreSQL

次のJDBC URL は公式のPostgreSQL JDBC ドライバーを使用しています。

jdbc:eloqua:CacheDriver=org.postgresql.Driver;CacheConnection='jdbc:postgresql://localhost:5433/postgres?user=postgres&password=admin';User=user;Password=password;Company=MyCompany

CacheLocation は単純なファイルベースキャッシュです。本製品 はJava DB、Oracle のDerby データベースのディストリビューションを使用しています。Java DB にキャッシュするには、Java DB JAR をクラスパスに追加する必要があります。JAR、derby.jar はJDK に同梱され、JDK インストールの［db］サブフォルダに配置されています。

CacheLocation のデフォルトは、Location 設定によって指定されたディレクトリです。

参照

• AutoCache：後のオフライン使用のために、キャッシュを暗黙的に作成および維持するために設定します。
• CacheMetadata：Eloqua カタログをCacheLocation で維持するために設定します。

このプロパティを設定してクエリを実行すると、Eloqua カタログのテーブルメタデータが設定されている場合にはCacheLocation で指定されたファイルストアに、設定されていない場合にはホームディレクトリにキャッシュされます。テーブルのメタデータの取得は、テーブルがはじめてクエリされた際に一度だけ行われます。

CacheMetadata を使用するタイミング

本製品 は、はじめてテーブルやビューを発見したときから2時間の間、メタデータをインメモリに自動的に保管します。そのため、CacheMetadata は一般的には必要ありません。CacheMetadata は、大量のメタデータを扱う場合でメタデータオペレーションのコストが高い場合や、短い接続を大量に行う場合などに役立ちます。

CacheMetadata を使用しないタイミング

• 変化しやすいメタデータを扱う場合：テーブルのメタデータは、はじめにテーブルへの接続がなされた時に一度しか取得されません。それ以降の、新規、変更、削除されたカラムを取得するには、メタデータキャッシュを削除してリビルドする必要があります。よって、メタデータが頻繁に変更される場合には、インメモリキャッシュを使う方が便利です。
• データベースにキャッシュする場合：CacheMetadata はCacheLocation でのみ使用可能です。CacheDriver およびCacheConnection プロパティで他のデータベースへのキャッシュが可能です。黙示的なキャッシュにはAutoCache を使ってください。もしくは、REPLICATE ステートメント or CACHE ステートメント で明示的なキャッシュが可能です。

CacheQueryResult およびAutoCache が設定されている場合、SELECT クエリで返された行はキャッシュデータベースにキャッシュされます。本製品 は、キャッシュをストリーミング形式で処理します。返されたResultSet オブジェクトから行を読み込むと、各行が元の結果セットからキャッシュデータベースに取り込まれます。 これでライブデータが2度クエリされることがなくなります。返されたResultSetから読み込まれない行は、キャッシュ内で更新されませんのでご注意ください。

キャッシュ内の失効データに対する許容範囲の秒数。これは、AutoCache が使用されている場合のみ有効です。本製品 は、許容インターバルが過ぎると、新しいレコードがないかデータソースをチェックしに行きます。それ以外は、キャッシュから直接データを返します。

認証プロセス中、OAuth 認証サーバーはユーザーをこのURLにリダイレクトします。この値をアプリケーションに指定したコールバックURL と同じ値に設定します。

このフィールドは、ユーザーにEloqua サーバーへの認証を提供するために使用されます。

接続の最大有効期間（秒単位）。その時間が経過すると、接続オブジェクトは削除されます。デフォルトは0で、接続の有効期間に制限がないことを示します。

true に設定すると、接続が開かれたときにEloqua への接続が作成されます。このプロパティは、さまざまなデータベースツールで［接続のテスト］機能を利用できるようにします。

この機能はNOOP コマンドとして作用します。Eloqua に接続できることを確認するために使用され、この初期接続からは何も維持されません。

このプロパティをfalse に設定すると、パフォーマンスが向上する場合があります（接続が開かれる回数に依存します）。

バルクデータがサーバーに格納される時間の長さ（時間単位）。有効な値は、1時間から2週間です。デフォルト値は24時間です。

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。

本製品 はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。

このプロパティは、本製品 がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトで本製品 は、システムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

次のオプションが利用可能です。

1. OFF：OAuth フローが完全にユーザーにより操作されることを示します。認証にはOAuth アクセストークンが必要です。
2. GETANDREFRESH：OAuth フローが完全に本製品 により操作されることを示します。現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。トークンが存在する場合には必要に応じてリフレッシュされます。
3. REFRESH：本製品 がOAuthAccessToken のリフレッシュのみを操作することを示します。ユーザーは本製品 によりブラウザを通じて認証することをプロンプトされることはありません。OAuthAccessToken とOAuthRefreshToken の最初の取得はユーザーが行う必要があります。

本製品 のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。 Location プロパティは、定義をカスタマイズしたり（カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

スキーマファイルは、本製品 アセンブリと一緒にデプロイされます。また、Location は、これらのスキーマファイルを含むフォルダーをポイントしている必要があります。 このフォルダーの場所は、実行可能ファイルの場所からの相対パスにすることができます。

ログファイルに記録される内容を細かく制御するには、Verbosity を参照してください。

Whether or not to use case sensitive match in data card mapping. Only has an effect if MapDataCardsRelationShip is set.

Comma-separated list of the relationships between the Custom Object tables and the Entity tables. The format of these relationships is '<custom_object>.<source_field>=<entity_type>.<entity_field>'. For example: Custom_MyCustomObject.Email_Address=Contact.C_EmailAddress

ログファイルの最大バイトサイズ（例：10MB）を指定する文字列。サイズリミットを超えると、新しいログが同じフォルダ内に作成され、日にちと時間が末尾に追加されます。リミットのデフォルトは100MB です。100kB より小さい値を設定した場合、100kB がリミットとなります。

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

OAuth を使用して接続するには、OAuthAccessToken プロパティが使用されます。認証プロセスにおいてOAuth サーバーからOAuthAccessToken が取得されます。このプロパティは、サーバーに依存するタイムアウトがあり、要求の間で再利用することができます。

アクセストークンは、ユーザー名とパスワードの代わりに使用されます。サーバー上で維持することで、認証情報が保護されます。

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId 値、およびクライアントシークレットOAuthClientSecret が提供されます。

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId が提供されます。また、コンシューマーシークレットと呼ばれるクライアントシークレットも提供されます。クライアントシークレットをOAuthClientSecret プロパティに設定します。

OAuthRefreshToken プロパティは、OAuth 認証時にOAuthAccessToken のリフレッシュに使われます。

InitiateOAuth がGETANDREFRESH またはREFRESH に設定されている場合、本製品 がOAuth 値を保存するため、ユーザーが手動でOAuth 接続プロパティを入力する必要がなくなり、接続やプロセス間でクレデンシャルを共有できるようになります。デフォルトOAuthSettingsLocation は、%AppData%\CData フォルダ内にある設定ファイルです。 ファイルパスを指定する代わりに、メモリストレージを使用することもできます。メモリの場所は、'memory://' で始まる値とそのクレデンシャルのセット（例：memory://user1）の一意の識別子を使用して指定します。識別子は何でも構いませんが、ユーザーに固有のものでなければなりません。ファイルベースのストレージとは異なり、プロセスが再開されたときに接続を設定できるように、メモリストレージとの接続を閉じるときは手動でクレデンシャルを格納する必要があります。OAuth プロパティ値は、sys_connection_props システムテーブルへのクエリで取得できます。複数の接続で同じクレデンシャルを使用している場合は、プロパティは最後に閉じられる接続から読み取られます。

OAuth 認可URL から返された検証コード。これは、ヘッドレスシステムのようにブラウザを起動できないシステム上で使用できます。

ヘッドレスマシンでの認証

OAuthVerifier の値を取得するには、「はじめに」を参照してください。

OAuthVerifier に加えてOAuthSettingsLocation を設定します。接続すると、本製品 はOAuth 認証トークンのOAuthVerifier を交換し、暗号化して、指定されたファイルに保存します。 交換を自動化するには、InitiateOAuth をGETANDREFRESH に設定します。

OAuth 設定ファイルが生成されたら、接続プロパティからOAuthVerifier を削除してOAuthSettingsLocation セットで接続できます。

OAuth トークン値を自動的にリフレッシュするには、OAuthSettingsLocation を設定し、さらにInitiateOAuth をREFRESH に設定します。

Offline がTRUE に設定されている場合、すべてのクエリは、ライブデータソースではなくキャッシュに対して実行されます。 このモードでは、INSERT、UPDATE、DELETE、CACHE などのクエリは許可されません。

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

キャッシュの設定

統合およびフォーマット

Pagesize プロパティは、クエリの実行時にEloqua から返されるページあたりの結果の最大数に影響を与えます。値を大きくすると、1ページにより多くの結果が返されますが、タイムアウト例外を発生する可能性も生じます。Eloqua がサポートするページサイズの最大値は1000です。

このフィールドは、Eloqua サーバーに対して認証をするために使われます。

接続が閉じられるまで、プール内に残ることができる許容されたアイドル時間。デフォルトは60秒です。

プールの最大接続数。デフォルトは100です。このプロパティを無効にするには、プロパティ値を0以下に設定します。

プール内の最小接続数。デフォルトは1です。

接続が利用可能になるまで待機する最大秒数。新しい接続のリクエストが使用可能な接続を待ちこの時間を超過すると、エラーが返されます。デフォルトでは、新規リクエストは使用可能な接続を永久に待機します。

この値は、ProxyServer およびProxyPort で指定されるHTTP プロキシに認証するために使われる認証タイプを指定します。

本製品 は、デフォルトでsystem proxy settings を使い、追加での設定が不要です。他のプロキシへの接続をする場合には、ProxyServer およびProxyPort に加え、ProxyAutoDetect をfalse に設定します。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

認証タイプは、次のどれかになります。

• BASIC：本製品 はHTTP BASIC 認証を行います。
• DIGEST：本製品 はHTTP DIGEST 認証を行います。
• NEGOTIATE：本製品 は認証において有効なプロトコルに応じて、NTLM もしくはKereros トークンを取得します。
• PROPRIETARY：本製品 はNTLM もしくはKerberos トークンを発行しません。このトークンを、HTTP リクエストのAuthorization ヘッダーに含める必要があります。

デフォルトで、本製品 はsystem HTTP プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。

HTTP プロキシへの接続には、ProxyServer を参照してください。

SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

本製品 は、追加設定なしにデフォルトでsystem proxy settings を使います。この接続のプロキシ例外を明示的に構成するには、ProxyAutoDetect をfalse に設定して、ProxyServer およびProxyPort を設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

このプロパティは、NTLM(Windows)、Kerberos、もしくはHTTP 認証をサポートするHTTP プロキシサーバーに認証するために使われます。HTTP プロキシを指定するためには、ProxyServer およびProxyPort を設定します。認証タイプを指定するためにはProxyAuthScheme を設定します。

HTTP 認証を使う場合、さらにHTTP プロキシにProxyUser およびProxyPassword を設定します。

NTLM 認証を使う場合、Windows パスワードにProxyUser およびProxyPassword を設定します。Kerberos 認証には、これらを入力する必要があります。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

デフォルトで、本製品 はsystem プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。

HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、本製品 はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。

SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。

デフォルトで、本製品 はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。有効な値は次のとおりです。

ProxyUser および ProxyPassword オプションは、ProxyServer で指定されたHTTP プロキシに対して接続および認証するために使用されます。

ProxyAuthScheme で使用可能な認証タイプを選択することができます。HTTP 認証を使う場合、これをHTTP プロキシで識別可能なユーザーのusername に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでusername に設定します。

user@domain
domain\user

Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。 この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。 "*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。

このプロパティがtrue に設定されている場合、本製品 はSELECT クエリのみ許可します。INSERT、UPDATE、DELETE、およびストアドプロシージャクエリではエラーが返されます。

UseBulkAPI がAuto またはTrue に設定されている場合、本製品 はHTTP 500ステータスコード（サーバーの内部エラー）が原因で失敗したあらゆる要求のリトライを試みます。 このプロパティは、本製品 が失敗したBulk API 要求をリトライする最大回数を定義します。 デフォルトでは、本製品 は要求を5回リトライします。

UseBulkAPI がAuto またはTrue に設定されている場合、本製品 はHTTP 500ステータスコード（サーバーの内部エラー）が原因で失敗したあらゆる要求のリトライを試みます。 このプロパティは、失敗したBulk API 要求のリトライを試みる時間間隔を定義します。 デフォルト値は200 ミリ秒です。

RTK プロパティは、ビルドにライセンスを供与するために使用されます。 このプロパティの設定方法については、付属のライセンスファイルを参照してください。このランタイムキーは、OEM ライセンスを購入した場合にのみ使用できます。

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。 コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。 '*' を指定するとすべての証明書を受け付けます（セキュリティ懸念上、推奨されません）。

Used in OAuth authentication: This is an optional value that has meaning for your OAuth App.

SupportEnhancedSQL がtrue に設定されている場合、本製品 は、Eloqua にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。この方法で、本製品 はサポートされていない宣言、JOIN、および集計を実行することができます。

SupportEnhancedSQL がfalse に設定されている場合、本製品 は、SQL 実行をEloqua API でサポートされている範囲に制限します。

宣言の実行

本製品 は、どの句がデータソースでサポートされているかを決定し、クエリを充足する最小セットの行を取得するためにソースにクエリを送信します。そして、残りの行をローカルでフィルタリングします。フィルタリング処理がストリームされている場合、本製品 は大きなデータセットに対しても効率よいフィルタリングが可能です。

JOIN 実行

本製品 は、インメモリでのJOIN でさまざまな技術を使用します。本製品 は、メモリ使用量と同じテーブルを複数回読む要求をトレードオフします。

集計の実行

本製品 は、インメモリで集計を処理するために必要なすべての行を取得します。

これらのテーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、本製品 のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。次に例を示します。Tables=TableA,TableB,TableC

Timeout プロパティが0に設定されている場合は、操作がタイムアウトしません。処理が正しく完了するか、エラー状態になるまで実行されます。

Timeout の有効期限が切れても処理が完了していない場合は、本製品 は例外をスローします。

データの取得にBulk API を使用するかどうか。UseBulkAPI がTrue に設定されている場合は、本製品 は常にBulk API の使用を試みます。ただし、アクセス可能なテーブルおよびカラムにいくつか制限があります。詳しくは、データモデル を参照してください。

False に設定すると、本製品 はすべての要求にREST API を使用します。Auto に設定すると、本製品 は要求に最も適したAPI を使用します。 例えば、次のクエリを見てください。

SELECT * FROM Activity_EmailOpen

SELECT * FROM Activity_EmailOpen ContactId='...'

Bulk API を使うには、まず本製品 がEloqua にクエリへの応答を準備するよう要求を送ります。そして、サーバーを定期的にポーリングしてステータスを確認することで応答が準備完了になるのを待ちます。BulkPollingInterval およびBulkQueryTimeout は、それぞれ頻度と期間を制御します。

コネクションプーリングを有効にします。デフォルトはfalse です。 コネクションプールの使用に関する詳細は、 接続プール を参照してください。

このフィールドは、ユーザーにEloqua サーバーへの認証を提供するために使用されます。

テーブルとカラムに簡略名を使用するかどうかを決定するboolean。Eloqua オブジェクトでは、標準的なデータベースでは通常許可されない特殊文字が名前に含まれることがあります。 UseSimpleNames を使用すると、本製品 で従来のデータベースツールが使いやすくなります。

UseSimpleNames をtrue に設定すると、返されるテーブルとカラムの名前が簡略化されるため、 それらをより簡単に操作できるようになります。false に設定すると、テーブルとカラムがEloqua 内と同様に表示されます。

このプロパティは、本製品 がLogfile に報告する詳細レベルを決定します。1 から5 までのVerbosity レベルがサポートされています。以下で、これらについて説明します。

通常の実行では、Verbosity を2以上に設定しないでください。高い詳細レベルでは、大量のデータが記録されて、実行に遅れが生じる恐れがあります。

これらのビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、 本製品 のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。次に例を示します。Views=ViewsA,ViewsB,ViewsC