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

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

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

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

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テーブルモデルアクセスモード、単一パーティションアクセス、NoSQLに適しています。このシナリオは通常、非常に高いデータスループット要件が伴い、レイテンシに非常に敏感です。このシナリオに関連する推奨設定の詳細情報については、下記kvを参照してください。

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';
     

   • 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';
     

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';
     

   • 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';
     

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 _force_subquery_unnest = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     

   • 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 "_force_subquery_unnest" = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     

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

   • MySQLモードテナントの設定例：

     SET GLOBAL ob_query_timeout = 604800000000;
     SET GLOBAL ob_trx_timeout = 604800000000;
     SET GLOBAL parallel_degree_policy = AUTO;
     SET GLOBAL parallel_min_scan_time_threshold = 10;
     SET GLOBAL ob_sql_work_area_percentage = 30;
     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_degree_policy = AUTO;
     SET GLOBAL parallel_min_scan_time_threshold = 10;
     SET GLOBAL ob_sql_work_area_percentage = 30;
     

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 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 max_partition_num = 65536;
     

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 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 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';
    

関連ドキュメント

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