重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

TiDB を使用したJavaアプリケーション開発のベストプラクティス

このドキュメントでは、TiDB をより有効に活用するためのJavaアプリケーション開発のベストプラクティスを紹介します。バックエンドの TiDB データベースと対話する一般的なJavaアプリケーションコンポーネントに基づいて、開発中によく発生する問題の解決策も提供します。

Javaアプリケーションで TiDB データベースと対話する一般的なコンポーネントは次のとおりです。

ネットワークプロトコル: クライアントは標準MySQL プロトコルを介して TiDBサーバーと対話します。
JDBC API と JDBC ドライバー: Javaアプリケーションは通常、標準のJDBC (Javaデータベース接続) API を使用してデータベースにアクセスします。TiDB に接続するには、JDBC API を介して MySQL プロトコルを実装する JDBC ドライバーを使用できます。MySQL 用の一般的な JDBC ドライバーには、 MySQL コネクタ/JとMariaDB コネクタ/Jあります。
データベース接続プール: 要求されるたびに接続を作成するオーバーヘッドを削減するために、アプリケーションは通常、接続プールを使用して接続をキャッシュし、再利用します。JDBC 情報元では、接続プール API が定義されています。必要に応じて、さまざまなオープンソース接続プール実装から選択できます。
データアクセスフレームワーク: アプリケーションは通常、マイバティスや休止状態などのデータアクセスフレームワークを使用して、データベースアクセス操作をさらに簡素化および管理します。
アプリケーション実装: アプリケーションロジックは、データベースにどのコマンドをいつ送信するかを制御します。一部のアプリケーションでは、春のトランザクション側面を使用してトランザクションの開始およびコミットロジックを管理します。

Java application components

上の図から、 Javaアプリケーションが次のことを実行する可能性があることがわかります。

TiDB と対話するには、JDBC API 経由で MySQL プロトコルを実装します。
接続プールから永続的な接続を取得します。
MyBatis などのデータアクセスフレームワークを使用して、SQL ステートメントを生成および実行します。
Spring トランザクションを使用して、トランザクションを自動的に開始または停止します。

このドキュメントの残りの部分では、上記のコンポーネントを使用してJavaアプリケーションを開発するときに発生する問題とその解決策について説明します。

ODBC ドライバ

Javaアプリケーションは、さまざまなフレームワークでカプセル化されたできます。ほとんどのフレームワークでは、データベースサーバーと対話するために最下層で JDBC API が呼び出されます。JDBC の場合、次の点に重点を置くことをお勧めします。

JDBC API の使用選択
API実装者のパラメータ設定

JDBC API

JDBC API の使用方法については、 JDBC 公式チュートリアル参照してください。このセクションでは、いくつかの重要な API の使用方法について説明します。

準備APIを使用する

OLTP (オンライントランザクション処理) シナリオの場合、プログラムからデータベースに送信される SQL ステートメントは、パラメータの変更を削除すると使い果たされる可能性のある複数のタイプです。したがって、通常のテキストファイルからの実行ではなく準備された声明使用し、準備済みステートメントを再利用して直接実行することをお勧めします。これにより、TiDB で SQL 実行プランを繰り返し解析して生成するオーバーヘッドを回避できます。

現在、上位フレームワークの多くはSQL実行にPrepare APIを呼び出します。開発にJDBC APIを直接使用する場合は、Prepare APIを選択するように注意してください。

また、MySQL Connector/J のデフォルト実装では、クライアント側のステートメントのみが前処理され、クライアント側で?が置換された後、ステートメントがテキストファイルでサーバーに送信されます。そのため、Prepare API を使用するだけでなく、TiDBサーバーでステートメントの前処理を行う前に、JDBC 接続パラメータでuseServerPrepStmts = true設定する必要があります。詳細なパラメータ設定については、 MySQL JDBCパラメータを参照してください。

バッチAPIを使用する

バッチ挿入の場合は、 addBatch / executeBatch APIを使用できます。 addBatch()メソッドは、複数の SQL ステートメントを最初にクライアント上でキャッシュし、次にexecuteBatchメソッドを呼び出すときにそれらをまとめてデータベースサーバーに送信するために使用されます。

注記：
デフォルトの MySQL Connector/J 実装では、 addBatch()でバッチに追加された SQL ステートメントの送信時刻はexecuteBatch()が呼び出された時刻まで遅延されますが、実際のネットワーク転送中にステートメントは 1 つずつ送信されます。そのため、この方法では通常、通信オーバーヘッドの量は削減されません。
バッチネットワーク転送を行う場合は、JDBC 接続パラメータのrewriteBatchedStatements = true設定する必要があります。詳細なパラメータ設定については、バッチ関連パラメータを参照してください。

`StreamingResult`を使用して実行結果を取得します

ほとんどのシナリオでは、実行効率を向上させるために、JDBC はクエリ結果を事前に取得し、デフォルトでクライアントメモリに保存します。ただし、クエリが非常に大きな結果セットを返す場合、クライアントはデータベースサーバーに一度に返されるレコードの数を減らすように要求することが多く、クライアントのメモリが準備されて次のバッチを要求するまで待機します。

通常、JDBC には 2 種類の処理方法があります。

FetchSizeをInteger.MIN_VALUEに設定する、クライアントがキャッシュしないようにします。クライアントは、 StreamingResultを介してネットワーク接続から実行結果を読み取ります。
クライアントがストリーミング読み取りメソッドを使用する場合、クエリを実行するためにステートメントを引き続き使用する前に、読み取りを終了するかresultsetを閉じる必要があります。そうしないと、エラーNo statements may be issued when any streaming result sets are open and in use on a given connection. Ensure that you have called .close() on any active streaming result sets before attempting more queries.が返されます。
クライアントが読み取りを完了するかresultsetを閉じる前にクエリでこのようなエラーを回避するには、URL にclobberStreamingResults=trueパラメータを追加します。すると、 resultset自動的に閉じられますが、前のストリーミングクエリで読み取られる結果セットは失われます。
カーソルフェッチを使用するには、まず正の整数としてFetchSizeを設定する設定し、JDBC URL でuseCursorFetch=true設定します。

TiDB は両方の方法をサポートしていますが、実装が簡単で実行効率が優れているため、最初の方法を使用することをお勧めします。

MySQL JDBCパラメータ

JDBC は通常、実装関連の設定を JDBC URL パラメータの形で提供します。このセクションではMySQL Connector/J のパラメータ設定紹介します (MariaDB を使用する場合はMariaDBのパラメータ設定を参照してください)。このドキュメントではすべての設定項目を網羅することはできないため、主にパフォーマンスに影響を与える可能性のあるいくつかのパラメータに焦点を当てています。

このセクションでは、 Prepareに関連するパラメータを紹介します。

`useServerPrepStmts`

デフォルトではuseServerPrepStmtsはfalseに設定されています。つまり、Prepare API を使用する場合でも、「準備」操作はクライアントでのみ実行されます。サーバーの解析オーバーヘッドを回避するために、同じ SQL ステートメントで Prepare API を複数回使用する場合は、この構成をtrueに設定することをお勧めします。

この設定がすでに有効になっていることを確認するには、次の操作を実行します。

TiDB 監視ダッシュボードに移動し、クエリサマリー>インスタンス別の CPSを通じて要求コマンドタイプを表示します。
リクエスト内のCOM_QUERY COM_STMT_EXECUTEまたはCOM_STMT_PREPAREに置き換えられた場合、この設定はすでに有効になっていることを意味します。

`cachePrepStmts`

useServerPrepStmts=trueではサーバーがPrepared Statements を実行できますが、デフォルトでは、クライアントは実行ごとに Prepared Statements を閉じて再利用しません。つまり、「準備」操作はテキストファイルの実行ほど効率的ではありません。これを解決するには、 useServerPrepStmts=true設定した後、 cachePrepStmts=trueも構成することをお勧めします。これにより、クライアントは Prepared Statements をキャッシュできます。

この設定がすでに有効になっていることを確認するには、次の操作を実行します。

TiDB 監視ダッシュボードに移動し、クエリサマリー>インスタンス別の CPSを通じて要求コマンドタイプを表示します。
リクエスト内のCOM_STMT_EXECUTEの数がCOM_STMT_PREPAREの数よりはるかに多い場合、この設定はすでに有効になっていることを意味します。

また、 useConfigs=maxPerformanceを設定すると、 cachePrepStmts=trueを含む複数のパラメータが同時に設定されます。

`prepStmtCacheSqlLimit`

cachePrepStmtsを設定した後は、 prepStmtCacheSqlLimit設定にも注意してください (デフォルト値は256です)。この設定は、クライアントにキャッシュされる Prepared Statements の最大長を制御します。

この最大長を超える準備済みステートメントはキャッシュされないため、再利用できません。この場合、アプリケーションの実際の SQL の長さに応じて、この構成の値を増やすことを検討してください。

次の場合には、この設定が小さすぎないかどうかを確認する必要があります。

TiDB 監視ダッシュボードに移動し、クエリサマリー>インスタンス別の CPSを通じて要求コマンドタイプを表示します。
そして、 cachePrepStmts=true設定されていることがわかりますが、 COM_STMT_PREPAREまだCOM_STMT_EXECUTEとほぼ同じであり、 COM_STMT_CLOSE存在します。

`prepStmtCacheSize`

prepStmtCacheSizeキャッシュされた Prepared Statements の数を制御します (デフォルト値は25です)。アプリケーションで多くの種類の SQL ステートメントを「準備」する必要があり、Prepared Statements を再利用したい場合は、この値を増やすことができます。

この設定がすでに有効になっていることを確認するには、次の操作を実行します。

TiDB 監視ダッシュボードに移動し、クエリサマリー>インスタンス別の CPSを通じて要求コマンドタイプを表示します。
リクエスト内のCOM_STMT_EXECUTEの数がCOM_STMT_PREPAREの数よりはるかに多い場合、この設定はすでに有効になっていることを意味します。

バッチ書き込みを処理する場合は、 rewriteBatchedStatements=true設定することをお勧めします。 addBatch()またはexecuteBatch()を使用した後でも、JDBC はデフォルトで SQL を 1 つずつ送信します。次に例を示します。

pstmt = prepare("insert into t (a) values(?)");
pstmt.setInt(1, 10);
pstmt.addBatch();
pstmt.setInt(1, 11);
pstmt.addBatch();
pstmt.setInt(1, 12);
pstmt.executeBatch();

Batch方法が使用されていますが、TiDB に送信される SQL ステートメントは、個別のINSERTのステートメントのままです。

insert into t(a) values(10);
insert into t(a) values(11);
insert into t(a) values(12);

ただし、 rewriteBatchedStatements=true設定すると、TiDB に送信される SQL ステートメントは単一のINSERTステートメントになります。

insert into t(a) values(10),(11),(12);

INSERTのステートメントの書き換えは、複数の「values」キーワードの後の値を 1 つの SQL ステートメント全体に連結することであることに注意してください。3 INSERTステートメントに他の違いがある場合は、次のように書き換えることはできません。

insert into t (a) values (10) on duplicate key update a = 10;
insert into t (a) values (11) on duplicate key update a = 11;
insert into t (a) values (12) on duplicate key update a = 12;

上記のINSERT文を 1 つの文に書き直すことはできません。ただし、3 つの文を次のように変更すると、

insert into t (a) values (10) on duplicate key update a = values(a);
insert into t (a) values (11) on duplicate key update a = values(a);
insert into t (a) values (12) on duplicate key update a = values(a);

すると、書き換え要件が満たされます。上記のINSERTステートメントは、次の 1 つのステートメントに書き換えられます。

insert into t (a) values (10), (11), (12) on duplicate key update a = values(a);

バッチ更新中に 3 つ以上の更新が行われる場合、SQL ステートメントは書き換えられ、複数のクエリとして送信されます。これにより、クライアントからサーバーへの要求のオーバーヘッドが効果的に削減されますが、副作用として、より大きな SQL ステートメントが生成されます。例:

update t set a = 10 where id = 1; update t set a = 11 where id = 2; update t set a = 12 where id = 3;

また、クライアントのバグのため、バッチ更新中にrewriteBatchedStatements=trueとuseServerPrepStmts=trueを設定する場合は、このバグを回避するためにallowMultiQueries=trueパラメータも設定することをお勧めします。

パラメータを統合する

監視を通じて、アプリケーションが TiDB クラスターに対してINSERT操作のみを実行しているにもかかわらず、冗長なSELECTステートメントが多数あることに気付く場合があります。通常、これは、JDBC が設定を照会するためにいくつかの SQL ステートメント (例: select @@session.transaction_read_onlyを送信するために発生します。これらの SQL ステートメントは TiDB には役に立たないため、余分なオーバーヘッドを回避するためにuseConfigs=maxPerformanceを構成することをお勧めします。

useConfigs=maxPerformanceには、一連の構成が含まれています。MySQL Connector/J 8.0 および MySQL Connector/J 5.1 の詳細な構成については、それぞれmysql-コネクタ-j 8.0とmysql-コネクタ-j 5.1を参照してください。

設定後、監視をチェックして、 SELECTステートメントの数が減っていることを確認できます。

TiDB は、タイムアウトを制御するwait_timeoutとmax_execution_timeという 2 つの MySQL 互換パラメータを提供します。これら 2 つのパラメータは、それぞれJavaアプリケーションとの接続アイドルタイムアウトと接続中の SQL 実行のタイムアウトを制御します。つまり、これらのパラメータは、TiDB とJavaアプリケーション間の接続の最長アイドル時間と最長ビジー時間を制御します。両方のパラメータのデフォルト値は0で、デフォルトでは接続が無限にアイドル状態および無限にビジー状態 (1 つの SQL 文の実行に無限の期間) になることができます。

ただし、実際の本番環境では、アイドル接続や実行時間が長すぎる SQL ステートメントは、データベースやアプリケーションに悪影響を及ぼします。アイドル接続や実行時間が長すぎる SQL ステートメントを回避するには、アプリケーションの接続文字列でこれらの 2 つのパラメータを設定します。たとえば、 sessionVariables=wait_timeout=3600 (1 時間) とsessionVariables=max_execution_time=300000 (5 分) を設定します。

接続プール

TiDB (MySQL) 接続の構築は、TCP 接続の構築に加えて接続認証も必要となるため、比較的コストがかかります (少なくとも OLTP シナリオの場合)。そのため、クライアントは通常、再利用のために TiDB (MySQL) 接続を接続プールに保存します。

Javaには、 HikariCP 、 tomcat-jdbc 、 druid 、翻訳: 、 dbcpなど、多くの接続プール実装があります。TiDB では、使用する接続プールに制限がないため、アプリケーションに応じて好きな接続プールを選択できます。

接続数を設定する

接続プールのサイズは、アプリケーション自体のニーズに応じて適切に調整するのが一般的です。HikariCPを例に挙げます。

maximumPoolSize : 接続プール内の最大接続数。この値が大きすぎると、TiDB は無駄な接続を維持するためにリソースを消費します。この値が小さすぎると、アプリケーションの接続速度が遅くなります。したがって、この値は適切に設定してください。詳細については、プールのサイズについてを参照してください。
minimumIdle : 接続プール内のアイドル接続の最小数。主に、アプリケーションがアイドル状態のときに突然の要求に応答するためにいくつかの接続を予約するために使用されます。アプリケーションのニーズに応じて構成することもできます。

アプリケーションは、使用を終了した後、接続を返す必要があります。また、アプリケーションが対応する接続プール監視 ( metricRegistryなど) を使用して、接続プールの問題を適時に特定することも推奨されます。

プローブ構成

接続プールは、次のようにクライアントから TiDB への永続的な接続を維持します。

v5.4 より前では、TiDB はデフォルトでクライアント接続を積極的に閉じません (エラーが報告されない限り)。
v5.4 以降、TiDB はデフォルトで28800秒 (つまり8時間) 非アクティブになるとクライアント接続を自動的に閉じます。このタイムアウト設定は、TiDB および MySQL 互換のwait_timeout変数を使用して制御できます。詳細については、 JDBC クエリタイムアウトを参照してください。

さらに、クライアントと TiDB の間には、 LVS のやHAプロキシなどのネットワークプロキシが存在する場合があります。これらのプロキシは通常、特定のアイドル期間 (プロキシのアイドル構成によって決定) の経過後に、積極的に接続をクリーンアップします。プロキシのアイドル構成を監視することに加えて、接続プールはキープアライブのために接続を維持またはプローブする必要もあります。

Javaアプリケーションで次のエラーが頻繁に表示される場合:

The last packet sent successfully to the server was 3600000 milliseconds ago. The driver has not received any packets from the server. com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure

n milliseconds ago分のnが0または非常に小さい値である場合、通常は実行された SQL 操作によって TiDB が異常終了したためです。原因を見つけるには、TiDB の stderr ログを確認することをお勧めします。

nが非常に大きな値の場合 (上記の例では3600000など)、この接続は長時間アイドル状態だった後、中間プロキシによって閉じられた可能性があります。通常の解決策は、プロキシのアイドル構成の値を増やし、接続プールで次の操作を行うことです。

毎回接続を使用する前に接続が利用可能かどうかを確認してください
別のスレッドを使用して、接続が利用可能かどうかを定期的に確認します。
接続を維持するために定期的にテストクエリを送信する

異なる接続プールの実装では、上記の方法の 1 つ以上がサポートされる場合があります。対応する構成を見つけるには、接続プールのドキュメントを確認してください。

データアクセスフレームワーク

アプリケーションでは、データベースアクセスを簡素化するために、何らかのデータアクセスフレームワークを使用することが多いです。

マイバティス

マイバティス、人気のあるJavaデータアクセスフレームワークです。主に SQL クエリを管理し、結果セットとJavaオブジェクト間のマッピングを完了するために使用されます。MyBatis は TiDB と高い互換性があります。MyBatis は、これまでの問題により、ほとんど問題がありません。

このドキュメントでは、主に以下の構成に焦点を当てています。

マッパーパラメータ

MyBatis Mapper は次の 2 つのパラメータをサポートしています。

select 1 from t where id = #{param1}は Prepared Statement としてselect 1 from t where id =?に変換され、「準備」され、実際のパラメータは再利用に使用されます。このパラメータを前述の Prepare 接続パラメータと併用すると、最高のパフォーマンスが得られます。
select 1 from t where id = ${param2}テキストファイルとしてselect 1 from t where id = 1に置き換えられ、実行されます。このステートメントが異なるパラメーターに置き換えられて実行されると、MyBatis はステートメントを「準備」するための異なるリクエストを TiDB に送信します。これにより、TiDB が多数の Prepared Statements をキャッシュする可能性があり、この方法で SQL 操作を実行すると、インジェクションセキュリティリスクが発生します。

動的SQLバッチ

動的 SQL - foreach

複数のINSERTステートメントをinsert ... values(...), (...), ...の形式に自動的に書き換えることをサポートするために、前述のように JDBC でrewriteBatchedStatements=trueを構成することに加えて、MyBatis は動的 SQL を使用して半自動的にバッチ挿入を生成することもできます。次のマッパーを例に挙げます。

<insert id="insertTestBatch" parameterType="java.util.List" fetchSize="1">
  insert into test
   (id, v1, v2)
  values
  <foreach item="item" index="index" collection="list" separator=",">
  (
   #{item.id}, #{item.v1}, #{item.v2}
  )
  </foreach>
  on duplicate key update v2 = v1 + values(v1)
</insert>

このマッパーはinsert on duplicate key updateステートメントを生成します。 (?,?,?)に続く「値」の数は、渡されたリストの数によって決まります。最終的な効果はrewriteBatchStatements=true使用する場合と同様であり、クライアントと TiDB 間の通信オーバーヘッドも効果的に削減されます。

前述したように、準備済みステートメントの最大長がprepStmtCacheSqlLimitを超えるとキャッシュされなくなることにも注意する必要があります。

ストリーミング結果

前のセクションでは、JDBC で読み取り実行結果をストリームする方法が導入されています。JDBC の対応する構成に加えて、MyBatis で非常に大きな結果セットを読み取る場合は、次の点にも注意する必要があります。

マッパー構成で単一の SQL ステートメントにfetchSize設定できます (前のコードブロックを参照)。その効果は、JDBC でsetFetchSizeを呼び出すのと同じです。
結果セット全体を一度に取得しないようにするには、クエリインターフェイスをResultHandlerで使用します。
ストリーム読み取りにはCursorクラスを使用できます。

XML を使用してマッピングを構成する場合は、マッピングの<select>セクションでfetchSize="-2147483648" ( Integer.MIN_VALUE ) を構成することで読み取り結果をストリーミングできます。

<select id="getAll" resultMap="postResultMap" fetchSize="-2147483648">
  select * from post;
</select>

コードを使用してマッピングを構成する場合は、 @Options(fetchSize = Integer.MIN_VALUE)アノテーションを追加し、結果のタイプをCursorのままにして、SQL 結果をストリーミングで読み取ることができるようにすることができます。

@Select("select * from post")
@Options(fetchSize = Integer.MIN_VALUE)
Cursor<Post> queryAllPost();

`ExecutorType`

openSessionの中からExecutorType選択できます。MyBatis は 3 種類のエグゼキュータをサポートしています。

シンプル: 準備済みステートメントは実行ごとにJDBCに呼び出されます（JDBC構成項目cachePrepStmtsが有効になっている場合は、繰り返しの準備済みステートメントが再利用されます）
再利用: 準備済みステートメントはexecutorにキャッシュされるため、JDBC cachePrepStmtsを使用せずに準備済みステートメントの重複呼び出しを減らすことができます。
バッチ: 各更新操作 ( INSERT / DELETE / UPDATE ) は最初にバッチに追加され、トランザクションがコミットされるか、クエリがSELECT実行されるまで実行されます。JDBCレイヤーでrewriteBatchStatements有効になっている場合は、ステートメントの書き換えが試行されます。そうでない場合は、ステートメントが 1 つずつ送信されます。

通常、 ExecutorTypeのデフォルト値はSimpleです。 openSessionを呼び出す場合はExecutorTypeを変更する必要があります。バッチ実行の場合、トランザクションでUPDATEまたはINSERTステートメントはかなり速く実行されますが、データの読み取りやトランザクションのコミットの際には遅くなることが分かります。これは実際には正常なので、遅い SQL クエリのトラブルシューティングを行うときは、この点に注意する必要があります。

春のトランザクション

現実の世界では、アプリケーションは春のトランザクションと AOP の側面を使用してトランザクションを開始および停止する場合があります。

メソッド定義に@Transactionalアノテーションを追加することで、AOP はメソッドが呼び出される前にトランザクションを開始し、メソッドが結果を返す前にトランザクションをコミットします。アプリケーションに同様のニーズがある場合は、コード内に@Transactional見つけて、トランザクションがいつ開始され、いつ終了するかを判断できます。

埋め込みの特殊なケースに注意してください。その場合、Spring は伝搬構成に基づいて異なる動作をします。

その他

このセクションでは、問題のトラブルシューティングに役立つJavaの便利なツールをいくつか紹介します。

トラブルシューティングツール

Javaアプリケーションで問題が発生し、アプリケーションロジックがわからない場合は、JVM の強力なトラブルシューティングツールを使用することをお勧めします。一般的なツールをいくつか紹介します。

jstack

jstackは Go の pprof/goroutine に似ており、プロセスがスタックした問題を簡単にトラブルシューティングできます。

jstack pidを実行すると、対象プロセス内のすべてのスレッドの ID とスタック情報を出力できます。デフォルトではJavaスタックのみが出力されます。JVM 内の C++ スタックも同時に出力したい場合は、 -mオプションを追加します。

jstack を複数回使用することで、スタックした問題 (たとえば、Mybatis で Batch ExecutorType を使用しているためにアプリケーションのビューからクエリが遅いなど) やアプリケーションのデッドロックの問題 (たとえば、アプリケーションが送信前にロックをプリエンプトしているために SQL ステートメントを送信しないなど) を簡単に見つけることができます。

さらに、 top -p $ PID -HまたはJavaスイスナイフは、スレッド ID を表示する一般的な方法です。また、「スレッドが CPU リソースを大量に占有し、何を実行しているのかわからない」という問題を特定するには、次の手順を実行します。

スレッド ID を 16 進数に変換するにはprintf "%x\n" pid使用します。
対応するスレッドのスタック情報を見つけるには、jstack 出力に移動します。

jmapとmat

Go の pprof/heap とは異なり、 jmapプロセス全体のメモリスナップショットをダンプし (Go ではディストリビューターのサンプリング)、そのスナップショットを別のツールマットで分析できます。

mat を使用すると、プロセス内のすべてのオブジェクトの関連情報と属性を確認できるほか、スレッドの実行ステータスを観察することもできます。たとえば、mat を使用して、現在のアプリケーションに存在する MySQL 接続オブジェクトの数や、各接続オブジェクトのアドレスとステータス情報を確認できます。

デフォルトでは、mat は到達可能なオブジェクトのみを処理することに注意してください。若い GC の問題をトラブルシューティングする場合は、到達不可能なオブジェクトを表示するように mat 構成を調整できます。また、若い GC の問題 (または多数の短命オブジェクト) のメモリ割り当てを調査するには、 Java Flight Recorder を使用する方が便利です。

痕跡

通常、オンラインアプリケーションではコードの変更はサポートされていませんが、問題を特定するためにJavaで動的なインストルメンテーションを実行することが望まれることがよくあります。そのため、btrace または arthas trace を使用するのがよい選択肢です。これらを使用すると、アプリケーションプロセスを再起動せずにトレースコードを動的に挿入できます。

フレームグラフ

Javaアプリケーションでフレームグラフを取得するのは面倒です。詳細については、 Java Flame Graphs の紹介: みんなに火を!参照してください。

結論

このドキュメントでは、データベースと対話する一般的なJavaコンポーネントに基づいて、TiDB を使用したJavaアプリケーションの開発に関する一般的な問題と解決策について説明します。TiDB は MySQL プロトコルと高い互換性があるため、MySQL ベースのJavaアプリケーションのベストプラクティスのほとんどは TiDB にも適用されます。

TiDB コミュニティ Slack チャンネルにご参加いただき、TiDB を使用してJavaアプリケーションを開発する際の経験や問題について、幅広い TiDB ユーザーグループと共有してください。

TiDB を使用したJavaアプリケーション開発のベスト プラクティス

Javaアプリケーションのデータベース関連コンポーネント

ODBC ドライバ

JDBC API

準備APIを使用する

バッチAPIを使用する

StreamingResultを使用して実行結果を取得します

MySQL JDBCパラメータ

準備関連のパラメータ

useServerPrepStmts

cachePrepStmts

prepStmtCacheSqlLimit

prepStmtCacheSize

バッチ関連パラメータ

パラメータを統合する

タイムアウト関連のパラメータ

接続プール

接続数を設定する

プローブ構成

データアクセスフレームワーク

マイバティス

マッパーパラメータ

動的SQLバッチ

ストリーミング結果

ExecutorType

春のトランザクション

その他

トラブルシューティングツール

jstack

jmapとmat

痕跡

フレームグラフ

結論

このページは役に立ちましたか？

TiDB を使用したJavaアプリケーション開発のベストプラクティス

`StreamingResult`を使用して実行結果を取得します

`useServerPrepStmts`

`cachePrepStmts`

`prepStmtCacheSqlLimit`

`prepStmtCacheSize`

`ExecutorType`