入力ストリームは使われません。ストリームフォーマットは選択不可です。

任意のSQLを実行 [SQL]

SELECT以外の任意のSQLを実行する場合に使用します。

SELECT文を発行 [SQL-Record]

SELECT文を実行する場合に使用します。

ストアド実行(結果なし) [Procedure]

結果セットを返さないストアドプロシージャを実行する場合に使用します。

ストアド実行(結果あり) [ProcedureRecord]

結果セットを返すストアドプロシージャを実行する場合に使用します。

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

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

デフォルトでは、Salesforce は削除されていない/アーカイブされていないレコードのみをSELECT クエリから返します。このプロパティをTrue に設定すると、本製品 はqueryAll エンドポイントを使用して、通常のレコード同様に削除済みまたはアーカイブ済みとしてマークされたレコードを返します。

• Basic：Basic ユーザー / パスワード認証を使用する場合に設定。
• OAuth：コードグラント種別でOAuth を実行する場合に設定。
• OAuthClient：クライアントグラント種別でOAuth を実行する場合に設定。
• OAuthPassword：パスワードグラント種別でOAuth を実行する場合に設定。
• OAuthJWT：JWT 証明書を使用してOAuth 認証を行う場合に設定。次の追加の接続プロパティが必要です。[OAuthJWTCert,/OAuthJWTCertType/OAuthJWTCertPassword/OAuthJWTCertSubject/OAuthJWTIssuer/OAuthJWTSubject]
• OAuthPKCE：標準OAuth2 フローのProof Key of Code Exchange（PKCE）拡張機能を使用するように設定。自身でPKCEVerifier を設定するか、ドライバーが自動的に生成します。
• OneLogin：OneLogin 経由でSSO 認証を実行する場合に設定。すべてのID プロバイダーでは、次の共通の接続プロパティが必要です。 [SSOLoginURL/SSOExchangeUrl]
• PingFederate：PingFederate 経由でSSO 認証を実行する場合に設定。すべてのID プロバイダーでは、次の共通の接続プロパティが必要です。 [SSOLoginURL/SSOExchangeUrl]
• OKTA：OKTA 経由でSSO 認証を実行する場合に設定。すべてのID プロバイダーでは、次の共通の接続プロパティが必要です。 [SSOLoginURL/SSOExchangeUrl]
• ADFS：ADFS 経由でSSO 認証を実行する場合に設定。すべてのID プロバイダーでは、次の共通の接続プロパティが必要です。 [SSOLoginURL/SSOExchangeUrl]
• AzureAD：AzureAD 経由でSSO 認証を実行する場合に設定。詳しくは、接続プロパティSSOProperties を参照してください。

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

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

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

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

関連項目

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

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

BULK API v1 でバルク処理を行うための同時実行モード。

一括クエリの応答の可用性を確認するリクエスト間の時間間隔。UseBulkAPI が設定されている場合、本製品 はSELECT クエリの実行時にSalesforce で非同期ジョブを開始します。そして、サーバーを定期的にポーリングしてステータスを確認することで応答が準備完了になるのを待ちます。このプロパティは、ポーリングの頻度を制御します。

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

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

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

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

Derby およびJava DB

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

あるいは、CacheDriver と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：データベース名。
• User name：PostgreSQL データベースの認証用に提供されたユーザーId。"user" パラメータを使ってJDBC URL に指定できます。
• Password：PostgreSQL データベースへの認証のためのパスワード。

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

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

Note：CacheDriver JAR ファイルをクラスパスに追加する必要があります。

例

Derby およびJava DB

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

jdbc:salesforce:CacheLocation='c:/Temp/cachedir';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

jdbc:salesforce:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

SQLite

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

jdbc:salesforce:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

MySQL

次はCData JDBC Driver for MySQL のJDBC URL です。

  jdbc:salesforce:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;
  

SQL Server

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

jdbc:salesforce:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

Oracle

次はOracle Thin Client のJDBC URL です。

jdbc:salesforce:Cache Driver=oracle.jdbc.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

PostgreSQL

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

jdbc:salesforce:CacheDriver=cdata.jdbc.postgresql.PostgreSQLDriver;CacheConnection='jdbc:postgresql:User=postgres;Password=admin;Database=postgres;Server=localhost;Port=5432;';AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

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

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Salesforce Data Provider" となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます：

関連項目

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

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

CacheMetadata を使用するタイミング

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

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

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

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

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

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

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

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

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

ALTER ステートメントに10を超えるカラムが存在する場合、ステートメントは複数のalter ステートメントに分割されます。これは、ALTER ステートメントには変更/追加されるカラムを最大10個まで含めることができるというAPI 制限を助長するためです。true の場合、個々のステートメントが失敗しても本製品 は他のステートメントの評価を継続します。false の場合、いずれかのステートメントが失敗した場合スキップではなくエラーとなります。

OKTA MFA で取得したトークンは期限が短く、通常は2時間後に有効期限が切れます。このとき、ドライバーは新しい接続で再発行すべき新規MFAPasscode のリクエストを発行します。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Salesforce Data Provider\\CredentialsFile.txt" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます。

Salesforce のレコードタイプ / 概念的エンティティをテーブルとして公開するかどうかを指定するboolean。

Salesforce の各オブジェクトは、そのレコードタイプを設定できます。例えば、Account オブジェクトは、Partner、Customer といったレコードタイプを持つことができます。

このプロパティがtrue に設定された場合、ドライバーはAccount_Partner、Account_Customer のようにレコードタイプごとに1つの追加テーブルを公開します。

このプロパティは、次のいずれかの値をとります：None、Delegated、Everything、Mine、MineAndMyGroups、My_Territory、My_Team_Territory、またはTeam。

このプロパティは、SOQL クエリに"USING SCOPE" キーワードを付加します。

このプロパティは、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 で指定されたプロキシに対しての認証に使われます。

Note：このプロパティがNONE 以外の値に設定されると、追加のAPI 呼び出しが実行されます。 Metadata API からすべてのカラムの説明を取得する場合は、このプロパティの値をColumns に設定します。
Metadata API からすべてのテーブルの説明を取得する場合は、このプロパティの値をTables に設定します。
Metadata API からすべてのテーブルとそれぞれのカラムの説明を取得する場合は、このプロパティの値をTablesAndColumns に設定します。

Salesforce Reports をビューとして公開するかどうか。 このプロパティをtrue に設定すると、TABULAR、SUMMARY、MATRIX タイプのSalesforce レポートをビューとして公開します。

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

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

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

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Salesforce Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

このプロパティを設定すると、認証が実行されたときやクエリが実行されたときなど、さまざまなタスクを実行する際に、本製品 がログファイルを生成します。指定したファイルが存在しない場合は作成されます。

接続文字列およびバージョン情報も記録されますが、機密情報を含む接続プロパティは自動的にマスクされます。

相対ファイルパスが指定された場合、ログファイルの場所は、Location 接続プロパティにあるパスに基づいて解決されます。

ログファイルに記録される内容をより細かく制御するには、Verbosity プロパティを調整してください。

ログ内容はいくつかのモジュールに分類されます。LogModules プロパティを使うことで、個々のモジュールを表示または非表示にすることができます。

新しいログファイルの作成前にログファイル1つの最大サイズを変更する方法については、MaxLogFileSize を参照してください。

生成されるログファイル数に上限を設定したい場合は、MaxLogFileCount を使用してください。

Java のログ出力

Java のログ出力もサポートされています。Java のログ出力を有効化するには、Logfile を次のように設定します：

Logfile=JAVALOG://myloggername

上記の例のように、JAVALOG:// がJava のログを使用するための必須プレフィックスで、独自のロガーで代用することになります。

次に、指定されたロガーのgetLogger メソッドが呼び出され、指定された値を使用してLogger インスタンスが作成されます。ログのインスタンスがすでに存在する場合は、既存のインスタンスを参照します。

Java のログ出力が有効になっている場合、Verbosity は特定のログレベルに対応します。

ログインで使用されるSalesforce サーバーへのURL。デフォルトはhttps://login.salesforce.com/services/Soap/c/60.0 です。これは、組織がカスタムログインエンドポイントを使用している場合にのみ変更してください。

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログ ページを参照してください。

サイズリミットを超えると、日付と時刻が末尾に追加された新しいログが同じフォルダ内に作成され、最も古いログファイルが削除されます。

サポートされている最小値は2です。0や負の値は、数に制限がないことを示します。

生成されるログファイルの最大サイズは、MaxLogFileSize で調整できます。

サイズリミットを超えると、日付と時刻が末尾に追加された新しいログが同じフォルダ内に作成されます。リミットのデフォルトは100 MB です。100 kB より小さい値を設定した場合、100 kB がリミットとなります。

生成されるログファイルの最大数は、MaxLogFileCount で調整できます。

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

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

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

OAuth アクセストークンを取得するURL。OAuth 1.0 では、このURL で認可されたリクエストトークンがアクセストークンと交換されます。

OAuth サービスの認可URL。このURL でユーザーはサーバーにログインしてアプリケーションにアクセス許可を与えます。OAuth 1.0 では、アクセス許可が付与されるとリクエストトークンが認可されます。

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

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

OAuthTokenTimestamp と併用して、アクセストークンの有効期限を決定します。

次のオプションが利用可能です：CODE,PASSWORD,CLIENT

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java Web Token の発行者。 OAuth クライアントID に設定します。

アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクトです。 OAuth アプリの使用を許可されたユーザーのユーザー名（E メールアドレス）を設定します。

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

OAuth で認証する場合はUser、Password、およびSecurityToken を入力しないでください。OAuthServerUrl 値はドライバーから自動的に取得されます。

InitiateOAuth がGETANDREFRESH またはREFRESH に設定されている場合、本製品 がOAuth 値を保存するため、ユーザーが手動でOAuth 接続プロパティを入力する必要がなくなり、接続やプロセス間でクレデンシャルを共有できるようになります。

ファイルパスを指定する代わりに、メモリストレージを使用することができます。メモリの場所は、'memory://' で始まる値とそのクレデンシャルのセット（例：memory://user1）の一意の識別子を使用して指定します。識別子は何でも構いませんが、ユーザーに固有のものでなければなりません。資格情報が接続間で永続化されるファイルベースのストレージとは異なり、メモリストレージは資格情報を静的メモリにロードし、資格情報はプロセスが継続している間は同じ識別子を使用して接続間で共有されます。そのプロセス外で資格情報を永続化するには、接続を閉じる前に資格情報を手動で保存する必要があります。これにより、プロセスが再開されたときに接続にそれらを設定することができます。OAuth プロパティ値は、sys_connection_props システムテーブルへのクエリで取得できます。複数の接続で同じ資格情報を使用している場合は、プロパティは最後に閉じた接続から読み取られます。

デフォルトの場所は"%APPDATA%\\CData\\Salesforce Data Provider\\OAuthSettings.txt" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます。デフォルト値は次のとおりです。

• Windows："register://%DSN"
• Unix："%AppData%..."
• Mac："%AppData%..."

DSN はオープン接続で使用される現在のDSN の名前です。

以下のテーブルは、OS 別の%APPDATA% 値の一覧です。

OAuthExpiresIn と併用して、アクセストークンの有効期限を決定します。

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

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

OAuthVerifier 値を取得するには、 を参照してください。

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

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

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

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

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

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

キャッシュの設定

統合およびフォーマット

User およびPassword を一緒に使用してサーバーで認証を行います。

PKCE 認証スキームにGetOAuthAuthorizationUrl ストアドプロシージャを実行することで生成されるProof Key for Code Exchange code verifier。これは、ヘッドレスシステムのようにブラウザを起動できないシステム上で使用できます。

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

PKCEVerifier 値を取得するには、 を参照してください。

OAuthSettingsLocation と共に、OAuthVerifier およびPKCEVerifier を設定します。接続すると、本製品 はOAuth 認証トークンのOAuthVerifier とPKCEVerifier を交換し、暗号化して、指定された場所に保存します。 交換を自動化するには、InitiateOAuth をGETANDREFRESH に設定します。

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

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

接続が閉じられるまで、プール内に残ることができる許容されたアイドル時間。デフォルトは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 もしくはKerberos トークンを取得します。
• PROPRIETARY： 本製品 はNTLM もしくはKerberos トークンを発行しません。このトークンを、HTTP リクエストのAuthorization ヘッダーに含める必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

NOTE:このプロパティがTrue に設定されている場合、使用されるプロキシは次のように決定されます。

• 本製品 は、JVM のプロパティ（http.proxy、https.proxy、socksProxy など）から検索を行います。
• JVM のプロパティが存在しない場合、本製品 はjava.home/lib/net.properties を検索します。
• java.net.useSystemProxies がTrue に設定されている場合、本製品 はSystemProxy を検索します。
• Windows では、プロキシ設定はレジストリのインターネットオプション、具体的にはレジストリキーHKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\ から読み込まれます。Windows 10以降では、Windows の設定にあるプロキシの設定に対応します。
  • これらの設定は、マシンの現在のユーザーにのみ適用されることに注意してください。アプリケーションをサービスとして実行している場合、本製品 はユーザー設定を読み込みません。代わりに、本製品 の接続プロパティでプロキシ設定を手動で行う必要があります。

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

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

本製品 は、追加設定なしにデフォルトでシステムのプロキシ設定を使います。この接続のプロキシ例外を明示的に構成するには、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 プロキシで識別可能なユーザーのユーザー名に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでユーザー名に設定します。

user@domain
domain\user

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

デフォルトでは、本製品 はSQL クエリを受け付けてSOQL に変換します。 このオプションが設定されている場合、本製品 は代わりにSOQL を直接受け付けてSalesforce に渡します。

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

コンテンツからBOM 文字(char)0xfeff を削除するかどうかを指定します。

Specifies whether to replace private use characters with a '?'

無効なUTF8 文字を'?' に置き換えるかどうかを指定します。

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

このフィールドは、User およびPassword とともに、サーバーに対して認証をするために使用できます。これは、組織が要求するように設定されている場合にのみ必要です。セキュリティトークンは、プロファイル情報に移動してセキュリティトークンをリセットすることで取得できます。パスワードがリセットされた場合は、セキュリティトークンもリセットする必要があります。

デフォルトでは、これはtrue に設定され、できるだけAPI にオフロードされます。ServerSideAggregation をfalse に設定すると、いくつかの問題が修正される場合があります。例えば、主キーフィールドではないフィールドで集計クエリを実行しようとしていて、返される行が2000を超える（EXCEEDED_ID_LIMIT エラーがスローされる）場合です。その場合、ServerSideAggregation をfalse に設定すると、タスクがクライアント側にオフロードされ、問題が解決されます。

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

このプロパティは、Salesforce 接続を作成して再利用する場合に便利です。このプロパティはSSO およびBasic 認証接続にのみ影響し、OAuth には使用されません。

カラムをリストする際に数式フィールドをスキップする必要がある場合は、true に設定します。

デフォルトでは、本製品 はSalesforce のレポート順でカラムをレポートします。 擬似カラムが有効な場合は、本製品 はそれらをカラムリストの最後に追加します。

このオプションを有効にすると、本製品 はすべてのカラム（疑似カラムを含む）を名前順にレポートします。

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

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

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

証明書は、システムのトラストストアに基づいてマシンによって信頼されていると検証されています。使用されるトラストストアは、システムに指定された'javax.net.ssl.trustStore' 値になります。このプロパティに値が指定されていない場合は、Java のデフォルトのトラストストア（例えば、JAVA_HOME\lib\security\cacerts）が使用されます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

CData JDBC Driver for Salesforce 2024J はここで指定されたURL を使用してSAML 応答を処理し、サービスの資格情報と交換します。 取得した資格情報はSSO 接続時の最後の情報であり、Salesforce との通信に使用されます。

ID プロバイダーのログインURL。

セミコロンで区切られたID プロバイダーへの接続に必要な追加プロパティ。SSOLoginURL と一緒に使われます。

SSO 設定については、 で詳しく説明します。

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

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

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

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

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

PickList フィールドをユーザーの言語に翻訳するかどうか。

このプロパティは、非同期Bulk API をSalesforce への読み出しと書き込みに使うかどうかを決定します。読み出しの場合、ドライバーは自動的に一括クエリジョブを作成して利用可能な結果を返します。JOIN または集計を使ったクエリはBulk API ではサポートされていないため、ドライバーはこれらのクエリに対してSOAP API を使用することに注意してください。完了したジョブまたは失敗したジョブは、自動的に閉じられます。

Salesforce に書き込みを行う場合は、各バッチ最大10000レコードを送信できます。これらのリクエストは非同期で処理され、ドライバーはSalesforce が結果を完全に処理するのを待ちません。次のテーブルをクエリして、ジョブおよび作成されたバッチについての情報を取得することができます。

SELECT * FROM [Info#TEMP]

これから返されたID 値は、GetJob、GetBatch、およびGetBatchResults とともに使用して、ジョブとバッチのステータスを確認することができます。

このプロパティがfalse に設定されている場合は、同時に複数のレコードを更新することが可能です。本製品 は、Web Serverces API を経由してバッチ処理を実行し、処理のステータスを同時に返します。JDBC Batch API を呼び出すと、本製品 はSalesforce への単一のリクエストに複数のリクエストをバッチでまとめます。

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

API 名の代わりにカラムの表示名を使用するかどうかを決定するboolean。

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

ユーザー定義ビューは、UserDefinedViews.json というJSON 形式のコンフィギュレーションファイルで定義されています。本製品 は、このファイルで指定されたビューを自動的に検出します。

また、複数のビュー定義を持ち、UserDefinedViews 接続プロパティを使用して制御することも可能です。このプロパティを使用すると、指定されたビューのみが本製品 によって検知されます。

このユーザー定義ビューのコンフィギュレーションファイルは、次のようにフォーマットされています。

• 各ルートエレメントはビューの名前を定義します。
• 各ルートエレメントには、query と呼ばれる子エレメントが含まれており、この子エレメントにはビューのカスタムSQL クエリが含まれています。

次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Account WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

"UserDefinedViews", C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json

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

このプロパティは、Tooling API を読み出しと書き込みに使うかどうかを決定します。

Verbosity レベルは、本製品 がLogfile にどの程度の詳細さで記載するかを決定します。1 から5 までのVerbosity レベルがサポートされています。より詳しい説明は、ログ ページに記載されています。

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

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

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

このプロパティは、本製品 がステータスを報告するバルクリクエストを待機するかどうかを決定します。デフォルトではこのプロパティはfalse で、INSERT、UPDATE、またはDELETE クエリはSalesforce に送信されるとすぐに完了します。true の場合、本製品 はINSERT、UPDATE、およびDETETE クエリが完了するまで待機します。

false の場合、データ変更クエリは高速になりますが、詳細なステータス情報は利用できなくなります。LastResultInfo#TEMP テーブルには、作成されたバッチがリストされますが、個々の行のステータスはリストされません。各行に関する情報は、各バッチに対してGetBatchResults ストアドプロシージャを実行した場合にのみ利用できます。

true の場合、データ変更クエリは低速になりますが、より詳細なステータス情報が利用可能になります。LastResultInfo#TEMP テーブルは、更新された各行のID、ステータス、および関連するエラーメッセージがリストされます。