クライアントインターフェイスガイド > ADO.NET経由でのTDVサーバーへの接続 > Visual StudioでのTDVへの接続の追加と構成
 
Visual StudioでのTDVへの接続の追加と構成
公開されたTDVデータサービスと通信するには、ADO.NETドライバーに、接続を作成するためのホスト、ポート、ユーザー、パスワード、およびドメインの適切なプロパティを提供します。
接続を作成および構成するには
1. [表示]メニューから[サーバーエクスプローラー]を選択して、VisualStudioサーバーエクスプローラーペインを開きます。
2. [データ接続]ノードを右クリックし、[接続の追加]オプションを選択して、[OK]をクリックします。
3. データソースとしてTIBCOData VirtualizationServerを選択します。
TDVが表示されない場合は、ドライバーがインストールされていないか、ドライバーを認識するためにVisualStudioを再起動する必要があります。
4. [続行]をクリックして、選択したデータソースの接続情報を入力します。
フィールド
説明
Host(ホスト)
TDVサーバーのホスト名またはIPオクテット。同じローカルコンピューターでVisualStudioとTDVサーバーを使用する場合は、localhostを使用します。
Port(ポート)
JDBCまたはODBCオープンポート(デフォルト:9401)またはSSL保護ポート(デフォルト:9403)の番号を使用します。 SSLを使用するには、サーバー証明書を個別にインストールする必要があります。
ユーザー名
TDVユーザー名。
Password(パスワード)
TDVパスワード。
Domain(ドメイン)
このデータソースが属するTDVドメイン。通常、そのドメインは、ローカルで定義されたユーザーとのインストールでは複合です。
情報源
データソースとは、データサービスノードで公開されているTDVデータベース名を指します。
カタログ
接続に使用するカタログを指定します。
注:認証ステータスはトークンの存在とKerberos認証サーバーとの通信に応じてネゴシエートされるため、[ユーザー名]、[パスワード]、および[ドメイン]フィールドはKerberosまたはNTLM認証には使用されません。
5. [接続のテスト]をクリックして、TDVデータソースに接続できることを確認します。
6. [詳細]をクリックします。
7. [詳細プロパティ]パネルを使用して、接続、デバッグ、およびセキュリティの設定を構成します。
 
注: SSLセキュリティは、以下で説明するSecurity Encrypt、KeyStoreFile、およびKeystorePassパラメーターを使用して構成されます。
パラメータ
値の説明
詳細
アクセストークン
OAuth2認証に使用される認証トークン。トークンは特定の形式で表されます-
<ヘッダー>。<ペイロード>。<署名>。
トークンの各部分はJSON形式です。
アクセストークンは、ID/パスワードの資格情報の代わりに使用され、有効期間と特権が制限されます。
AccessTokenType
AccessTokenのタイプ。 JWT(JSON Web Token)は、デフォルトでサポートされている形式です。 JWTトークンは自己完結型のJSONフォームであり、フェデレーションに最適です。
ConnectTimeout
クライアントが接続の確立または失敗を待機する秒数。値0は、タイムアウトを無効にします。
FetchBytes
バッチサイズに基づいてバッチに対してフェッチする行の最大数(バイト単位)。 fetchBytesを非常に大きな数に設定すると、サーバーでメモリ不足エラーが発生する可能性があります。 fetchBytesに設定された値は、JDBCクライアントとTDVサーバーで使用されるメモリに影響を与えるため、構成されたヒープサイズに基づいて値を設定する必要があります。
FetchRows
一度にTDVからフェッチされる行の最大数。
注: FetchRowsとFetchBytesの間に関係はありません。 dbchannelはレコードを取得すると、フェッチされた行とフェッチされたバイトの数を計算します。フェッチされた行の数がfetchRowsより大きい場合、またはフェッチされたバイトの数がfetchBytesより大きい場合、dbchannelは行のフェッチを停止し、フェッチされたすべてのレコードを返します。
RequestTimeout
クライアントがTDVサーバーが要求を返すのを待つ秒数。 0の値は、タイムアウトを無効にします。
セッションタイムアウト
サーバーでのセッションの非アクティブのタイムアウト。この設定により、TDVサーバーは、サーバーに通知されずにクライアントとの接続が失われた場合にセッションを維持する必要がある期間を示します。
SessionToken
サーバーへの認証に使用されるセッショントークンの場所。
クラスター
EnableReconnectOnError
デフォルト値(false)は、接続オブジェクトが停止した場合に例外になります。 trueに設定すると、接続が切断されたときに、ドライバーは同じサーバーへの新しい接続を作成しようとします。アクティブクラスタリングを使用している場合は、この値をtrueに設定して、接続に失敗すると、サーバーへの接続の別の試行が自動的に開始されるようにします。
PingInterval
TDV ADO.NETドライバーを使用すると、サーバーにコマンドを送信した後にTDVステータスを評価するようにpingメカニズムを構成できます。ドライバーがサーバーに要求を送信した後、PingIntervalは指定された間隔で繰り返しping検証を開始します。 pingによるステータスの検証は、サーバーが接続ステータスの検証にかかる長い応答時間を回避するのに役立ちます。たとえば、コマンドが発行された直後に接続が失われた可能性がある場合などです。 PingIntervalは、連続するpingステータスチェック間の秒数です。デフォルト値は0で、ping検証を無効にします。
PingTimeoutWindow
これは、PingIntervalの値以上である必要があります。これは、pingタイムアウトが失敗することを意味します。共通コマンドがサーバーに送信された時点から、ドライバーは継続的なpingコマンドをサーバーに送信します。 PingTimeoutWindowの後でまだpingが失敗する場合は、例外がスローされ、接続が閉じられます。それ以外の場合、ドライバーは待機してサーバーにpingコマンドを送信し、サーバーのステータスを確認します。デフォルト値は0です。これは、このオプションが使用されていないことを意味します。
接続
このセクションのプロパティは、Visual StudioでのTDVへの接続の追加と構成で設定された値です。カタログ、データソース名、ドメイン、ホスト、ポート、およびユーザーの値は、その画面に入力された値から入力され、ここで変更できます。
デバッグ
ErrorLoggingEnabled
ADO.NETドライバーログを有効にします。
StatusInterval
指定された時間間隔(秒単位)でスレッドと接続ステータスをログに記録します。
TraceFolder
トレースファイルを保存するための絶対ディレクトリ。トレースファイル名は「CsOdbcDebug _」+<DSN名>+「。log」です。デフォルトのフォルダはC:\または$COMPOSITE_HOMEです。
TraceLevel
有効な値は、off、fatal、error(これがデフォルトです)、debug、warn、info、debug、およびallです。
クライアント側のログ設定の有効な値は、off、fatal、error(default)、warn、info、debug、all、stdoutです。
UNIXベースのプラットフォームでは、ログファイルCsOdbcDebug.logは、環境変数COMPOSITE_HOMEで指定されたディレクトリに作成されます。
プーリング
ConnectionLifeTime
ConnectionLifeTime=0に設定すると、各接続は使用されるとすぐに閉じられます。接続を接続プールに戻して接続を再利用する場合は、接続プールを使用するときに、「connectionlifetime」値をゼロより大きい値に設定します。
ConnectionLifeTimeの単位は2番目です。たとえば、ConnectionLifeTime=60000は60000秒を意味します
MaxPoolSize
同じプールで同時に開かれる接続の最大数を設定します。最大値に達し、使用可能な接続が利用できない場合、接続が使用可能になるまで、後続の要求はキューに入れられます。
MinPoolSize
新しいリクエストのために新しい接続を再作成する時間コストを回避するために、非アクティブであっても維持される接続の最小数を設定します。
プーリング
trueの場合、非アクティブな接続は保存され、必要に応じて再利用されます。
セキュリティ
Encrypt(暗号化)
正しいか間違っているか。 SSLセキュリティに使用されます。 Trueに設定すると、SSLセキュリティが有効になります。デフォルトはFalseです。
Integrated_Authentication
'(Disabled)'、 'Kerberos'、 'NTLM'の3つの値で統合認証方式を指定しました。
Kerberos SPN
サービスインスタンスをサービスログオンアカウントに関連付けるためにKerberos認証によって使用されるサービスプリンシパル名(SPN)。これにより、クライアントがアカウント名を持っていない場合でも、アカウントのサービス認証が可能になります。
KeyStoreFile
SSLセキュリティに使用されます。検証に使用するキーストアファイルを指定します。ファイルはPKCS#12形式です。デフォルトのキーストアは、apps/ADO.NET/ Security/cis_ado_keystore.pfxにあります。これには、クライアント証明書と秘密キーが含まれています。
KeyStorePass
SSLセキュリティに使用されます。 KeyStoreFileのパスワードを指定します。デフォルト値は「changeit」です。
User_Tokens
配信用にパッケージ化できる認証値。
TlsVersion
TLSバージョン情報。
ValidateRemoteCert
正しいか間違っているか。デフォルトはFalseです。
ValidateRemoteHostname
正しいか間違っているか。デフォルトはFalseです。
8. OKを2回クリックして、構成を完了します。
接続プロファイル設定を定義すると、TDVデータソースへの新しく作成された接続がVisual Studio ServerExplorerに表示されます。標準のサーバーエクスプローラーインターフェイスを使用して、TDVデータソースを操作できます。