設定のベストプラクティス

ユーザーがさまざまな業務シナリオにおいてOceanBaseデータベースで良好なパフォーマンスを得られるようにするため、OceanBaseは過去の多くの実環境でのチューニング経験に基づき、各業務シナリオにおける主要なパラメータと変数の推奨設定をまとめました。OceanBaseクラウドプラットフォーム（OceanBase Cloud Platform、OCP）では、テナント作成時にパラメータ設定でパラメータテンプレートを選択できます。ユーザーが選択したパラメータテンプレートに基づき、対応するバージョンのカーネルRPMパッケージの内容を読み取って、該当するパラメータ値を取得します。OCPを使用してテナント情報を作成する方法については、プライマリテナントの新規作成を参照してください。

本記事では、主にOceanBaseデータベースをCLIでデプロイした後、異なる業務アプリケーションシナリオにおける主要なパラメータとシステム変数の推奨設定について説明します。

パラメータ設定テンプレート

OceanBaseデータベースのRPMパッケージをインストールすると、/home/admin/oceanbase/etcディレクトリで、さまざまな業務シナリオにおける推奨パラメータ設定のテンプレートを確認できます。

• default_parameter.json：パラメータの推奨設定が保存されています。
• default_system_variable.json：変数の推奨設定が保存されています。

パラメータ設定ファイルのテンプレート分類：

• express_oltp：このテンプレートは、取引、決済コアシステム、インターネット高スループットアプリケーションなどのワークロードタイプに適用されます。外部キー制約、ストアドプロシージャ、長トランザクション、大規模トランザクション、複雑な結合や複雑なサブクエリなどの制限がないことを前提とします。このシナリオにおける関連する推奨設定の詳細については、以下のexpress_oltpを参照してください。

• complex_oltp：このテンプレートは、銀行、保険システムなどのワークロードに適用されます。通常、複雑な結合、複雑な相関サブクエリ、PLで記述されたバッチ処理ジョブが含まれ、長トランザクションや大規模トランザクションも存在します。短期間で実行されるクエリでは、パラレル実行が採用されることがあります。このシナリオにおける関連する推奨設定の詳細については、以下のcomplex_oltpを参照してください。

• olap：このテンプレートは、主にリアルタイムデータウェアハウス分析アプリケーションに使用されます。このシナリオにおける関連する推奨設定の詳細については、以下のolapを参照してください。

• htap：このテンプレートは、OLAPとOLTPの混合ワークロードシナリオに適用されます。運用データのリアルタイム分析、不正行為検出、個別化推薦などが含まれますが、これらに限定されません。このシナリオにおける関連する推奨設定の詳細については、以下のhtapを参照してください。

• kv：このテンプレートは、HBase互換およびKey-Valueテーブルモデルアクセスモード、単一パーティションアクセス、SQL層なしに適用されます。このシナリオは通常、極めて高いデータスループット要件を伴い、レイテンシに非常に敏感です。このシナリオにおける関連する推奨設定の詳細については、以下のkvを参照してください。

express_oltp

このシナリオでは、現在のところ変数設定の推奨事項はありません。

express_oltp シナリオの構成パラメータの推奨値の詳細は以下のとおりです：

express_oltp シナリオ例

1. sysテナントで以下のステートメントを実行し、クラスタレベル構成パラメータを設定します。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. ユーザーテナントで以下のステートメントを実行し、テナントレベル構成パラメータを設定します。

   • MySQLテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     

   • Oracleテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     

complex_oltp

このシナリオでは、現在のところ変数設定の推奨事項はありません。

complex_oltpシナリオの構成パラメータ推奨値の詳細は以下の通りです：

complex_oltp シナリオ例

1. sysテナントで以下のステートメントを実行し、クラスタレベル構成パラメータを設定します。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET large_query_threshold = '600s';
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. ユーザーテナントで以下のステートメントを実行し、テナントレベル構成パラメータを設定します。

   • MySQLテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     

   • Oracleテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     

olap

OLAPシナリオにおける構成パラメータの推奨値の詳細は以下のとおりです：

OLAPシナリオにおける変数の推奨値の詳細は以下のとおりです：

OLAPシナリオ例

1. sysテナントで以下のステートメントを実行し、クラスタレベル構成パラメータを設定します。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET trace_log_slow_query_watermark = '7d';
   ALTER SYSTEM SET large_query_threshold = '0ms';
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. ユーザーテナントで以下のステートメントを実行し、テナントレベル構成パラメータを設定します。

   • MySQLテナントの設定例：

     ALTER SYSTEM SET default_table_store_format = 'column';
     ALTER SYSTEM SET _io_read_batch_size = '128K';
     ALTER SYSTEM SET _io_read_redundant_limit_percentage = 50;
     ALTER SYSTEM SET _io_callback_thread_count = 64;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = False;
     ALTER SYSTEM SET _nested_loop_join_enabled = False;
     ALTER SYSTEM SET default_table_organization = 'HEAP';
     ALTER SYSTEM SET default_table_merge_engine = 'DELETE_INSERT';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET _force_subquery_unnest = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     ALTER SYSTEM SET default_skip_index_level = 1;
     

   • Oracleテナントの設定例：

     ALTER SYSTEM SET default_table_store_format = 'column';
     ALTER SYSTEM SET "_io_read_batch_size" = '128K';
     ALTER SYSTEM SET "_io_read_redundant_limit_percentage" = 50;
     ALTER SYSTEM SET "_io_callback_thread_count" = 64;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = False;
     ALTER SYSTEM SET "_nested_loop_join_enabled" = False;
     ALTER SYSTEM SET default_table_organization = 'HEAP';
     ALTER SYSTEM SET default_table_merge_engine = 'DELETE_INSERT';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET "_force_subquery_unnest" = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     ALTER SYSTEM SET "default_skip_index_level" = 1;
     

3. ユーザーテナントで以下のステートメントを実行し、テナントレベル変数を設定します。

   • MySQLテナントの設定例：

     SET GLOBAL ob_query_timeout = 604800000000;
     SET GLOBAL ob_trx_timeout = 604800000000;
     SET GLOBAL parallel_min_scan_time_threshold = 10;
     SET GLOBAL ob_sql_work_area_percentage = 30;
     SET GLOBAL parallel_degree_policy = AUTO;
     SET GLOBAL collation_server = utf8mb4_bin;
     SET GLOBAL collation_connection = utf8mb4_bin;
     

   • Oracleテナントの設定例：

     SET GLOBAL ob_query_timeout = 604800000000;
     SET GLOBAL ob_trx_timeout = 604800000000;
     SET GLOBAL parallel_min_scan_time_threshold = 10;
     SET GLOBAL ob_sql_work_area_percentage = 30;
     SET GLOBAL parallel_degree_policy = AUTO;
     SET GLOBAL collation_server = utf8mb4_bin;
     SET GLOBAL collation_connection = utf8mb4_bin;
     

htap

このシナリオでは、現在のところ変数設定の推奨事項はありません。

htapシナリオにおける構成パラメータの推奨値の詳細は以下の通りです：

htap シナリオ例

1. sysテナントで以下のステートメントを実行し、クラスタレベル構成パラメータを設定します。

   ALTER SYSTEM SET large_query_threshold = '600s';
   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. ユーザーテナントで以下のステートメントを実行し、テナントレベル構成パラメータを設定します。

   • MySQLテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET max_partition_num = 65536;
     

   • Oracleテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET max_partition_num = 65536;
     

kv

このシナリオでは、現在のところ変数設定の推奨事項はありません。

kvシナリオの構成パラメータの推奨値の詳細は以下のとおりです：

KVシナリオ例

1. sysテナントで以下のステートメントを実行し、クラスタレベル構成パラメータを設定します。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET large_query_threshold = '0ms';
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. ユーザーテナントで以下のステートメントを実行し、テナントレベル構成パラメータを設定します。

   • MySQLテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET enable_auto_split = True;
     

   • Oracleテナントの設定例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 1;
     ALTER SYSTEM SET enable_auto_split = True;
     

構成パラメータと変数の確認

• SHOW PARAMETERS LIKE 'parameter_name'; ステートメントを使用して構成パラメータ情報を照会できます。

  例：

  SHOW PARAMETERS LIKE 'enable_syslog_recycle';
  

• 以下のステートメントを使用して変数情報を照会できます。

  • MySQLモード：SHOW [GLOBAL] VARIABLES LIKE 'variables_name'; ステートメントを使用して照会できます。

    例：

    SHOW VARIABLES LIKE 'ob_query_timeout';
    

    SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';
    

  • Oracleモード：ビュー SYS.TENANT_VIRTUAL_SESSION_VARIABLE/SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE を使用して変数情報を照会できます。

    例：

    SELECT * FROM SYS.TENANT_VIRTUAL_SESSION_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';
    

    SELECT * FROM SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';
    

関連ドキュメント

• 構成パラメータと変数の詳細については、構成パラメータとシステム変数の概要を参照してください。
• 構成パラメータの設定方法については、パラメータの設定を参照してください。
• 変数の設定方法については、変数の設定を参照してください。