入力ストリームは出力ストリームにコピーされます。

Bulk API 要求を使用する場合、AllOrNone プロパティは使用できません。

デフォルトで使用されるSalesforce API のバージョンは33.0 です。

AutoCache が設定されている場合、本製品 は、CacheLocation オプションで指定されているキャッシュにSELECT クエリの結果を自動的にキャッシュします。CacheLocation は、シンプルなファイルベースのキャッシュへのパスを定義します。

以下のセクションでは、AutoCache の仕組みと制限について説明します。いくつかのキャッシュシナリオでは、CData Sync ツールの方がより自動化されたオプションになります。

AutoCache の仕組み

AutoCache セットでSELECT ステートメントを実行すると、本製品 はリモートデータにクエリを実行し結果を保持します。既存の行は上書きされます。つまり、SELECT ステートメントは、キャッシュのクエリではなくキャッシュの作成および更新に使用されます。

ノンクエリ要求（UPDATE/INSERT/DELETE ステートメントなど）は、リモートデータに対しても実行されます。これらのステートメントは、AutoCache の設定値に関係なく、キャッシュ内のデータは何も変更されません。

キャッシュされたデータをクエリするには、 #CACHE を テーブル名に追加します。次に例を示します。

SELECT * FROM [Account#CACHE]

AutoCache を使用するタイミング

軽量のキャッシュが必要なシナリオでは、AutoCache は設定を簡素化します。例えば、レポートを持続させるのに効果的です。Offline をtrue に設定すると、オフラインの状態でもレポートのローカルコピーにアクセスできます。 これらのプロパティを一緒に使用する例については、キャッシュ：ベストプラクティス を参照してください。

AutoCache の機能は、同じテーブル（1つまたは複数）の複数のレポートでより制限されます。AutoCache は、テーブルメタデータではなく結果セットのメタデータを持続するため、テーブルメタデータを先に取得する必要があります。CacheMetadata を使って、最初の接続で完全なデータモデルのメタデータを取得するか、CACHE ステートメント を使って、個々のテーブルのメタデータを取得できます。

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

以下のシナリオでは、次のような代替案を検討してください。

• キャッシュされたデータを管理するための管理ソリューションが必要な場合：AutoCache の主な制限は、自動化の程度です。AutoCache は、後のオフライン利用のためにデータを暗黙的にキャッシュする最も簡単で便利な方法です。しかし、キャッシュの維持およびクエリは、依然として明示的である必要があります。

• RDBMS を使用する必要がある場合：AutoCache はデフォルトデータベースでのみ使用可能です。より多くの同時書き込みをサポートする必要がある場合、または既存のインフラストラクチャと統合する必要がある場合は、CacheConnection およびCacheDriver を使って代わりのデータベースドライバーを指定します。

キャッシュデータベースは CacheDriver およびCacheConnection プロパティに基づいて決定されます。CacheConnection は、キャッシュデータベースへの接続に必要な接続プロパティを定義します。

Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost:7437;user=sa;password=123456;databaseName=Cache'

JDBC ドライバーが用意されている任意のデータベースにキャッシュできます。本製品 はSQL Server、Derby およびJava DB、MySQL、 Oracle、およびSQLite に対してテスト済みです。

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

Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost:7437;user=sa;password=123456;databaseName=Cache'

AutoCache は設定されているが、キャッシュの場所が指定されていない場合、デフォルトのCacheLocation は、Location 設定で指定されているディレクトリにあるキャッシュフォルダー になります。

CacheLocation は単純なファイルベースキャッシュです。ほかのデータベースにキャッシュするには、 CacheConnection および CacheDriver プロパティを参照してください。

cache.db ファイルは、CacheConnection で指定された場所に作成されます。これが設定されていない場合は、CacheLocation に作成されます。

この値は、認証プロセス中にSalesforce がリダイレクトするURL です。

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

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

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

FirewallServer が指定されている場合は、FirewallUser およびFirewallPassword プロパティを使用して指定されたファイアウォールに接続し、認証を行います。

本製品 は、FirewallPort を、指定されたFirewallType に関連付けられたデフォルトのポートに設定します。 詳細については、FirewallType オプションの説明を参照してください。

このプロパティがドメイン名に設定されている場合は、DNS 要求が発行され、ドメイン名が対応するIP アドレスに変換されます。

有効な値は次のとおりです。

FirewallServer が指定されている場合は、FirewallUser およびFirewallPassword プロパティを使用してファイアウォールに接続し、認証を行います。

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

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

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

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

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

デフォルトで使用されるSalesforce APIバージョンは33.0なので、この属性はデフォルトでhttps://login.salesforce.com/services/Soap/c/33.0になります。

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

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

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

OAuth は、アプリケーションの登録を必要とします。登録するとき、コンシューマキーとも呼ばれるクライアントID、およびクライアントシークレットが提供されます。OAuth サーバーに接続するには、OAuthClientId およびOAuthClientSecret を指定する必要があります。

OAuth は、アプリケーションの登録を必要とします。登録するとき、コンシューマシークレットとも呼ばれるクライアントID、およびクライアントシークレットが提供されます。OAuth サーバーに接続するには、OAuthClientId およびOAuthClientSecret を指定する必要があります。

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

OAuth で認証する場合はUser、Password、およびSecurityToken を入力しないでください。

OAuth セッションの有効期限が切れてOAuthAccessToken が無効になるまでの秒数。これは、組織のセキュリティ設定のセッション期限切れ時間と同じにしてください。

InitiateOAuth にGETANDREFRESH またはREFRESH が設定されている場合、本製品 が設定ファイルにOAuth を保存するため、ユーザーが手動でOAuth 接続プロパティに接続する必要はありません。デフォルトOAuthSettingsLocation は、%AppData%\CData フォルダ内にある設定ファイルです。

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

Other プロパティは、データソース固有の接続パラメータで使用される名前と値のペアのセミコロン区切りリストです。

キャッシュの設定

統合およびフォーマット

このフィールドは、User およびSecurityToken とともに、サーバーに対する認証に使用されます。

この値は、BASIC、DIGEST、NONE、NTLM、NEGOTIATE、PROPRIETARY のいずれかです。

これは、デフォルトのシステムプロキシ設定を使用するかどうかを示します。カスタムプロキシ設定を使用するには、ProxyAutoDetect をFALSE に設定します。これは他のプロキシ設定より優先されます。

ProxyServer が指定されている場合は、ProxyUser およびProxyPassword プロパティを使用してファイアウォールに接続し、認証を行います。

詳細については、ProxyServer フィールドの説明を参照してください。

このプロパティがドメイン名に設定されている場合は、DNS 要求が発行され、ドメイン名が対応するアドレスに変換されます。

この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。

ProxyServer が指定されている場合は、ProxyUser およびProxyPassword オプションを使用してファイアウォールに接続し、認証を行います。

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

QueryCache を使用すると、クエリの結果をインメモリにキャッシュし、そのキャッシュを期限切れになるまで使用することができます。同じクエリまたは似たクエリ（下記参照）が頻繁に実行される場合は、QueryCache を設定することで、パフォーマンスを向上させることができます。インメモリクエリキャッシュは複数の接続で共有されます。したがって、複数の接続が使用される場合でもパフォーマンスには有利に働きます。

QueryCache のキャッシュマネージャーは、キャッシュにある結果をまったく同じクエリに対してのみ利用するのではなく、キャッシュされたクエリのデータの一部を表すクエリに対しても利用します。例えば、以下のクエリでは、クエリA の実行時に作成されたキャッシュが、クエリB とクエリC でも結果の取得に使用されます。

SELECT * from Account; // Query A
SELECT * from Account WHERE Name LIKE '%John'; // Query B
SELECT Id, Name from from Account LIMIT 10; // Query C

QueryCache を0に設定すると、インメモリキャッシュは無効になります。

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

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

このフィールドは、User およびPassword とともに、サーバーに対する認証に使用されます。これは、Salesforce.com でご自分のプロファイル情報から参照できます。

本製品 は、提供された認証資格情報に基づいて、Salesforce のログインセッションを作成します。このセッションは、タイムアウトになるまで、後続のクエリでも再利用されます。SessionTimeout プロパティを使用すると、本製品 によってログインセッションが維持される時間を制御できます。SessionTimeout を0に設定すると、ログインセッションを無効にできます。この場合、本製品 は要求ごとに認証を行います。

クライアント証明書のための証明書ストア名。

SSLClientCertType フィールドは、SSLClientCert により指定された証明書ストアの種類を指定します。 ストアがパスワードで保護されている場合は、SSLClientCertPassword でパスワードを指定します。

SSLClientCert は、SSLClientCertSubject フィールドと共にクライアント証明書を指定するために使われます。 SSLClientCert に値がある場合で、SSLClientCertSubject が設定されている場合は、証明書の検索が始まります。 詳しくは、SSLClientCertSubject フィールドを参照してください。

証明書ストアの指定はプラットフォームに依存します。

Windows の共通のユーザとシステム証明書ストアの指定は以下のとおりです。

Javaでは、証明書ストアは通常、証明書および任意の秘密キーを含むファイルです。

証明書ストアの種類がPFXFile の場合は、このプロパティにファイル名を設定します。 PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ（例えば、PKCS12証明書ストア）に設定する必要があります。

証明書ストアでパスワードが必要である場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。

証明書の件名は、証明書をロードするときにストア内の証明書を検索するために使用されます。

完全に一致するものが見つからない場合、ストアはプロパティの値を含む件名を検索します。

それでも一致するものが見つからない場合、プロパティは空白で設定され、証明書は選択されません。

"*" を設定すると、証明書ストアの1番目の証明書が選択されます。

証明書の件名は識別の名前フィールドおよび値のカンマ区切りのリストです。 例えば、"CN=www.server.com, OU=test, C=US, E=support@cdata.com"。共通のフィールドとその説明は以下のとおりです。

フィールド値にカンマが含まれている場合は、それを引用符で囲む必要があります。

このプロパティには次の値の一つを設定できます。

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。 コンピュータによって信頼されていない他の証明書はすべて拒否されます。 これは、完全なPEM 証明書、証明書を含むファイルへのパス、公開鍵、MD5 サムプリント、またはSHA1 サムプリントの形式を取ることができます。 これを指定しない場合は、任意の信頼された証明書が受け入れられます。 '*' を指定するとすべての証明書を受け付けます（セキュリティ懸念上、推奨されません）。

アイデンティティプロバイダーのログインURL。Salesforce において、［設定］→［管理］→［セキュリティのコントロール］→［シングルサインオン設定］→［SAML シングルサインオン設定］で希望する方法を選択してください。

セミコロンで区切られたアイデンティティプロバイダーへの接続に必要な追加プロパティ。例えばOneLogin はAPI key を要求し、このプロパティには'OneLogin API Key=<your API key>;' を入力します。

アイデンティティプロバイダーのためのSalesforce OAuth 2.0 トークンエンドポイント。Salesforce において、［設定］→［管理］→［セキュリティのコントロール］→［シングルサインオン設定］→［SAML シングルサインオン設定］で希望する方法を選択してください。

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

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

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

このフィールドは、Password およびSecurityToken とともに、Salesforce サーバーに対する認証に使用されます。

Salesforce Sandbox アカウントに接続するには、UseSandbox をTrueに設定して、Sandbox 名をユーザー名の末尾に追加します。例えば、自分のユーザー名が「user」、Salesforce のSandbox 名が「sandbox」の場合、指定されるUser は「user.sandbox」になります。

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

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