ThingWorx モデルとデータの最良事例 > データ管理 > 外部データベースへの接続
外部データベースへの接続
ThingWorx Platform では、DatabaseThingSQLThing の 2 つのエンティティによる外部データベースへの接続がサポートされています。両方のエンティティは JDBC (Java Database Connectivity) を使用してデータベースに接続するので、適切な JDBC ドライバーが ThingWorx Platform に追加されている必要があります。JDBC ドライバーは、拡張機能を介して、または Apache Tomcat デプロイメントで直接追加できます。
DatabaseThing は ThingWorx Platform でしばらくの間サポートされており、要件があまり複雑でないデータベースアクセスを引き続きサポートしています。
最近、複数のエンティティ間でのコンフィギュレーションと接続の共有をサポートするために SQLThing が追加されました。SQLThing を使用している場合、GenericJdbcPersistenceProviderPackage を使用して作成された永続化プロバイダによってコンフィギュレーションが管理され、ここで、JDBC 接続の詳細が設定されます。作成された永続化プロバイダは、1 つまたは複数の SQLThing エンティティのコンフィギュレーションで名前によって参照でき、すべてのエンティティで接続のプールが共有されます。
SQLThing コンフィギュレーションのチェックボックスを使用して、必要に応じて SQLThing は ThingWorx Platform トランザクションに参加できます。このサポートにより、同じ ThingWorx Platform トランザクションのほかの操作が失敗した場合に外部データベースへの変更のロールバックが可能になります。これにより、同じ JavaScript サービスから実行された複数の SQL サービスが外部データベース上の単一のトランザクションを使用するようになり、状況によってはこれが必要とされます。このような JavaScript ラッパーを呼び出すその他のサービスは同じプラットフォームトランザクションを共有しているので、データベースの変更がコミットされると影響を受けます。
名前
デフォルト値
注記
JDBC URL
jdbc:_DB_://localhost/
接続の取得元となるデータベースの JDBC URL。この URL で複数のスキーマを指定できます。
ユーザー名
dbuser
データベース接続を取得する際に使用されるユーザー名
パスワード
該当なし
データベース接続を取得する際に使用されるパスワード
初期接続プールサイズ
0
データベースに接続するための起動時に作成されるスレッドの数
接続取得の増分
1
プールが使い果たされた場合に取得される接続の数を指定します。
最大接続プールサイズ
100
プールが常に維持する接続の最大数
最小接続プールサイズ
0
プールが常に維持する接続の最小数
最大キャッシュ文
100
グローバル PreparedStatement キャッシュのサイズ
ドライバークラス
データベースの JDBC ドライバークラス
再試行の回数を取得
3
接続プールが新規接続の取得を試みる回数を定義します
取得再試行の遅延
10000
接続プールが取得を再試行するまで待つ時間 (ミリ秒)
チェックアウト再試行タイムアウト
1000000
プールが使い果たされた場合に getConnection の呼び出しを行うクライアントが接続がチェックインされるか取得されるまで待つミリ秒数
プール接続アイドル再テスト期間 (秒)
60
最大アイドル時間
0
接続が未使用のままプールされている秒数。この時間を経過すると接続が破棄されます。ゼロはアイドル接続が失効しないことを意味します。
最大接続期間
0
この時間 (秒数) より古い接続は破棄されてプールからパージされます。ゼロは最大期間が適用されないことを意味します。
ヘルパースレッド数
8
一般的に、低速な JDBC オペレーションは競合ロックを獲得しないヘルパースレッドによって実行されます。このようなオペレーションを複数のスレッドに分散させると、複数のオペレーションを同時に実行可能になり、パフォーマンスが大幅に向上します。
返されていない接続タイムアウト
0
アプリケーションが接続を取得したが、所定の期間内に接続を閉じることに失敗した場合、プールでその接続が破棄されます。ゼロはタイムアウトしないことを意味し、アプリケーション自らが接続を閉じることが求められます。
過剰接続の最大アイドル時間
300
最小プールサイズを超えた接続がプール内でアイドル状態を維持できる秒数。この時間を経過すると接続は破棄されます。ゼロはこれが適用されないことを意味し、過剰接続は破棄されません。
すべてのエンティティのロード中のフェッチサイズ
5000
SSL 接続モード
無効
SSL 接続を有効または無効にします。
SSL ルート証明書パス
SSL 接続モードが有効になっている場合の SSL 証明書へのパス
接続プール飽和警告の上限
85
これは役に立ちましたか?