OceanBaseデータベースはV4.xバージョンでアーキテクチャの変更・アップグレードおよびリファクタリングが行われたため、多くの構成パラメータや変数が機能しなくなりました。V4.xでは無効な構成パラメータや変数が削除または変更されています。例えば、Major Freezeをトリガーするために使用されていた構成パラメータminor_freeze_timesは削除されました。同時に、一部の構成パラメータのデフォルト値も調整されています。例えば、V4.xバージョンでは基盤レベルで大規模トランザクションのサポートが解決されたため、トランザクションは凍結操作の影響を受けなくなりました。そのため、freeze_trigger_percentageのデフォルト値を20%に調整しました。
V4.x系でのパラメータ関連の変更
置き換えられたパラメータ
次の表は、V4.xバージョンでV3.xバージョンから置き換えられたパラメータを示しています。
パラメータ名(V3.x) |
置き換え後のパラメータ名(V4.x) |
説明 |
|---|---|---|
| backup_concurrency | ha_low_thread_score | 置き換え後はテナントレベルとなりました |
| clog_disk_utilization_threshold | log_disk_utilization_threshold | 置き換え後はテナントレベルとなりました |
| clog_transport_compress_func | log_transport_compress_func | 置き換え後はテナントレベルとなりました |
| data_copy_concurrency、fast_recovery_concurrency、restore_concurrency | ha_high_thread_score | 置き換え後はテナントレベルとなりました |
| log_archive_checkpoint_interval | archive_lag_target | 置き換え後はテナントレベルとなりました |
| merge_thread_count | compaction_low_thread_score | 置き換え後はテナントレベルとなりました |
| migrate_concurrency 、server_data_copy_out_concurrency、server_data_copy_in_concurrency | ha_mid_thread_score | 置き換え後はテナントレベルとなりました |
| sql_audit_memory_limit | ob_sql_audit_percentage | テナント変数に置き換えられ、構成パラメータではなくなりました |
| minor_merge_concurrency | compaction_mid_thread_score | 置き換え後はテナントレベルとなりました |
| clog_persistence_compress_func | log_storage_compress_func | 置き換え後はテナントレベルとなりました |
| enable_clog_persistence_compress | log_storage_compress_all | 置き換え後はテナントレベルとなりました |
名前が変更されたパラメータ
次の表は、V4.xバージョンで名前が変更されたパラメータを示しています。
パラメータ名(V3.x) |
パラメータ名(V4.x) |
説明 |
|---|---|---|
| tableapi_transport_compress_func | kv_transport_compress_func |
|
適用範囲が変更されたパラメータ
OceanBaseデータベースはマルチテナントアーキテクチャであり、ほとんどのユーザーは同一クラスタ内に複数のテナントを作成し、業務種類に応じて個別に管理することを選択します。ユーザーが1つのテナントを1つのビジネスユニットとして利用するニーズに応えるため、V4.xバージョンでは、クラスタレベルの機能をテナントレベルに分割しました。例えば、テナントレベルのバックアップ、テナントレベルのダンプとメジャーコンパクションなどです。
次の表は、適用範囲が変更されたパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| backup_data_file_size |
|
| enable_rebalance | V4.2.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
| balancer_idle_time | V4.2.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
| log_archive_concurrency | V4.1.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
| log_restore_concurrency | V4.1.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
| major_compact_trigger | V4.0.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
| minor_compact_trigger | V4.0.0バージョンから、クラスタレベルからテナントレベルに変更されました。 |
効力モードを変更するパラメータ
パラメータは一般的に動的に反映されるものと再起動後に反映されるものの2種類があります。ほとんどのパラメータは動的に反映されるものであり、OBServerノードを再起動しなくても設定が有効になります。
以下の表は、効力モードを変更するパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| net_thread_count | V4.4.0バージョン以降、効力モードが再起動後に反映されるものから即時に反映されるものに変更されました。 |
| server_cpu_quota_min |
|
| server_cpu_quota_max |
|
デフォルト値を変更するパラメータ
以下の表は、デフォルト値を変更するパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| ob_storage_s3_url_encode_type | V4.4.2バージョンでは、V4.4.2 BP1バージョン以降、デフォルト値がdefaultからcompliantRfc3986Encodingに調整されました。 |
| compaction_dag_cnt_limit | V4.4.0バージョン以降、デフォルト値が15000から50000に調整されました。 |
| kv_group_commit_batch_size | V4.3.5バージョンでは、V4.3.5 BP1バージョン以降、デフォルト値が1から10に調整されました。 |
| direct_load_allow_fallback | V4.3.5バージョン以降、デフォルト値がFalseからTrueに調整されました。 |
| memstore_limit_percentage |
|
| range_optimizer_max_mem_size |
|
| ls_gc_delay_time |
|
| enable_monotonic_weak_read | V4.2.1バージョン以降、デフォルト値がtrueからfalseに調整されました。 |
| location_refresh_thread_count | V4.2.0バージョン以降、デフォルト値が4から2に調整されました。 |
| enable_record_trace_id | V4.2.0バージョン以降、デフォルト値がtrueからfalseに調整されました。 |
| plan_cache_evict_interval | V4.2.0バージョン以降、デフォルト値が1秒から5秒に調整されました。 |
| tenant_task_queue_size | V4.1.0バージョン以降、デフォルト値が65536から16384に調整されました。 |
| server_cpu_quota_min |
|
| writing_throttling_maximum_duration | V4.0.0バージョン以降、デフォルト値が1時間から2時間に調整されました。 |
| writing_throttling_trigger_percentage | V4.0.0バージョン以降、デフォルト値が100から60に調整されました。 |
| freeze_trigger_percentage | V4.0.0バージョン以降、デフォルト値が70から20に調整されました。 |
値の範囲が変更されたパラメータ
次の表は、値の範囲が変更されたパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| compaction_schedule_tablet_batch_cnt | V4.4.0以降、値の範囲が[10000、200000]から[10000、500000]に調整されました。 |
| compaction_dag_cnt_limit | V4.4.0以降、値の範囲が[10000、200000]から[10000、500000]に調整されました。 |
| net_thread_count | V4.3.5 BP2以降、値の範囲が[0, 64]から[0, 128]に調整されました。 |
| ob_startup_mode | V4.3.4以降、値の範囲にSHARED_STORAGEの値が追加されました。 |
| large_query_threshold |
|
| memstore_limit_percentage |
|
| range_optimizer_max_mem_size |
|
| job_queue_processes |
|
| memory_limit_percentage | V4.2.1以降、値の範囲が[10, 90]から[10, 95]に調整されました。 |
| cpu_quota_concurrency | V4.2.0以降、値の範囲が[1,10]から[1,20]に調整されました。 |
| memory_limit | V4.1.0以降、値の範囲が[4G, +∞)から[1G, +∞)に調整されました。 |
| server_cpu_quota_min |
|
新規構成パラメータ
次の表は、V4.xバージョンで追加された構成パラメータです。
パラメータ名 |
導入バージョン |
説明 |
|---|---|---|
| schema_history_archive_expire_time | V4.4.2バージョンでは、V4.4.2 BP1バージョンから導入されました。 | スキーマのマルチバージョン履歴アーカイブデータの保持時間を指定するために使用されます。 |
| zone_disk_balance_tolerance_percentage | V4.4.2バージョンでは、この構成パラメータはV4.4.2 BP1バージョンから導入されました。 | ゾーン間のテーブルグループディスク均等化アルゴリズムが不均衡に対して許容する度合いを制御します。 |
| enable_ls_leader_balance |
|
ログストリームのLeader自動均等化を有効にするかどうかを制御します。 |
| enable_gts_standalone |
|
テナントGTSサービスが一組のUnitを専有する機能を有効にするかどうかを設定します。 |
| zone_deploy_mode |
|
テナントの各ゾーンでの分散モードを設定します。 |
| mds_minor_compact_trigger | V4.4.1 | MDS Minor CompactionをトリガーするSSTableの数を制御するために使用されます。 |
| mds_compaction_mid_thread_score | V4.4.1 | 中優先順位MDS CompactionのDAG（Direct Acyclic Graph）スレッド数を設定するために使用されます。 |
| mds_compaction_high_thread_score | V4.4.1 | 高優先順位MDS CompactionのDAG（Direct Acyclic Graph）スレッド数を設定するために使用されます。 |
| ls_scale_out_factor |
|
ログストリームの拡張係数であり、各サービスノード上のテナントのログストリーム数を制御するために使用されます。 |
| external_table_io_hole_size | V4.4.0 | 連続する2つのIO範囲間の最大距離（バイト単位）を設定するために使用されます。 |
| external_table_io_range_size | V4.4.0 | メジャーコンパクション範囲の最大サイズ（バイト単位）を設定するために使用されます。連続する2つの範囲をメジャーコンパクションした結果がこのサイズを超える場合は、それらはメジャーコンパクションされません。 |
| async_ps_cursor_max_count | V4.4.0 | 単一ノード内の非同期PS cursorの最大数を制御するために使用されます。 |
| ob_enable_java_udf | V4.4.0 | Java UDF機能を有効または無効にするために使用されます。 |
| load_data_diagnosis_log_compression | V4.4.0 | 診断ログで使用する圧縮アルゴリズムを設定するために使用されます。 |
| load_data_diagnosis_log_max_size | V4.4.0 | 単一診断ログファイルのサイズを設定するために使用されます。 |
| result_cache_max_size | V4.4.0 | result cacheモジュールが使用できる最大メモリ量を制御するために使用されます。 |
| result_cache_max_result | V4.4.0 | 単一result cacheキャッシュオブジェクトが使用できるresult_cache_max_sizeのメモリ割合を制御するために使用されます。 |
| ob_result_cache_evict_percentage | V4.4.0 | result cacheメモリエビクトウォータマークを設定するために使用されます。 |
| ob_deterministic_udf_cache_max_size | V4.4.0 | ステートメント実行時に、すべてのdeterministicUDFのキャッシュプールが合計で使用できる最大メモリ量（バイト単位）を示します。0の場合、実行時キャッシュ機能は無効です。 |
| enable_lock_priority | V4.3.5 BP2 | テーブルロックの優先順位スイッチです。 |
| enable_adaptive_plan_cache | V4.3.5 BP2 | テナントのプランキャッシュ（Plan Cache）の適応能力を有効にするかどうかを制御するために使用されます。 |
| global_index_auto_split_policy | V4.3.5 BP2 | 新規作成されるグローバルインデックスで自動パーティション機能を有効にするかどうかを制御するために使用されます。
注意V4.4.1バージョン以降、オープンソースモードでは、この構成パラメータのデフォルト値が |
| clog_io_isolation_mode | V4.3.5 BP2 | clogディスクとdataディスクが独立しているかどうかに基づいて、clogディスクのI/Oリクエストがリソース分離の管理を受けるかどうかを決定するために使用されます。システムの実際のデプロイ状況に応じて、この構成パラメータの値を柔軟に調整することで、パフォーマンスとリソース利用率のバランスを取ることができます。 |
| default_table_organization | V4.3.5 BP1 | 設定可能なテーブルのデフォルトのテーブル編成モードです。 |
| px_node_policy | V4.3.5 BP1 | PXコンピューティングノードの候補プールを決定するために使用されます。 |
| ob_enable_java_env | V4.3.5 BP1 | HDFS/MaxCompute(ODPS)などの外部テーブル機能に依存するJava環境を有効にするかどうかを制御します。 |
| ob_java_home | V4.3.5 BP1 | JNI実行に依存するJavaホームパスを設定します。この構成は、ob_enable_java_envが有効な場合にのみ設定できます。 |
| ob_java_opts | V4.3.5 BP1 | JVM起動パラメータ（メモリサイズやガベージコレクションアルゴリズムなど）を設定します。この構成は、ob_enable_java_envが有効な場合にのみ設定できます。 |
| ob_java_connector_path | V4.3.5 BP1 | 外部テーブルconnectorに依存するJARパッケージのパスを設定します。この構成は、ob_enable_java_envが有効な場合にのみ設定できます。 |
| temporary_file_max_disk_size | V4.3.5 BP1 | テナントの単一ノード内で一時ファイルが使用できる最大ディスク容量を設定します。 |
| package_state_sync_max_size | V4.3.5 BP1 | package state同期パッケージ変数値の最大長を制御します。このパラメータの設定値を超えた場合、パッケージ変数は同期されません。 |
| unit_gc_wait_time |
|
Unit GCの最大待機時間を指定します。この時間を超えた場合は強制的にGCを実行します。 |
| recover_table_concurrency |
|
テーブルレベル復元のテナント間データロード段階で、並列に復元できるテーブルの最大数を設定します。 |
| recover_table_dop |
|
テーブルレベル復元のテナント間データロード段階で、単一テーブルの並列復元を許可する最大数を設定します。 |
| query_memory_limit_percentage |
|
単一SQLが使用できるテナントメモリの割合を指定するために使用されます。 |
| replica_parallel_migration_mode |
|
ログストリームレプリカ並列移行機能のモードを指定するために使用されます。 |
| sts_credential |
|
OCPが提供するSTSサービスにアクセスする資格情報を指定するために使用されます。 |
| arbitration_degradation_policy | V4.3.4 | 自動デグレードのポリシーを設定します。 |
| kv_hbase_client_scanner_timeout_period | V4.3.4 | OBKV-HBaseストリーミングクエリのタイムアウト時間を設定します。 |
| default_load_mode | V4.3.4 | データインポート操作でヒントが指定されていない場合に、パラメータで定義されたヒントを使用するかどうかを制御します。 |
| direct_load_allow_fallback | V4.3.4 | データインポート操作シナリオでダイレクトロードがサポートされない場合に、エラーを報告するかどうかを制御します。 |
| enable_auto_split | V4.3.4 | このテーブルで自動パーティション機能を有効にするかどうかを制御します。
注意V4.4.1バージョン以降、KVテンプレートで作成されたクラスタでは、このパラメータのデフォルト値がtrueに変更されました。 |
| auto_split_tablet_size | V4.3.4 | テナントで自動パーティション機能が有効になっている状態で、パーティションの分割をトリガーするしきい値を制御します。
注意V4.4.1バージョン以降、このパラメータのデフォルト値は2GBに変更されました。 |
| sync_io_thread_count | V4.3.4 | 同期I/Oリクエストを処理するスレッド数を設定します。 |
| ob_encoding_granularity | V4.3.3 | ベクトルインデックスモジュールが使用できるメモリリソースの上限割合を制御します。 |
| ob_storage_s3_url_encode_type | V4.3.3 | S3リクエスト送信時のURLエンコード方式がRFC3986規格と互換性があるかどうかを設定します。 |
| ob_vector_memory_limit_percentage | V4.3.3 | ベクトルインデックスモジュールのメモリリソース占用しきい値（単位：割合）を設定します。 |
| storage_rowsets_size | V4.3.2 | カラムストアエンジンの1回のベクトル化バッチ処理行数を制御します。 |
| alert_log_level |
|
警告ログのレベルを設定します。 |
| enable_global_background_resource_isolation |
|
グローバルなフォアグラウンド/バックグラウンドリソース分離機能を有効にするかどうかを制御します。 |
| global_background_cpu_quota |
|
グローバルなフォアグラウンド/バックグラウンドリソース分離が有効な場合のバックグラウンドタスクのCPUコア数を制御します。 |
| choose_migration_source_policy |
|
移行時のソース側レプリカ選択優先ポリシーを指定します。 |
| lob_enable_block_cache_threshold |
|
OUTROWストレージのLOBクエリキャッシュのしきい値を設定します。 |
| spill_compression_codec | V4.3.1 | SQL実行プロセスでのデータ永続化圧縮を実現するための圧縮アルゴリズムタイプを指定します。 |
| max_partition_num |
|
MySQLモードで許可される最大パーティション数を制御します。 |
| log_storage_compress_all |
|
clogストレージ圧縮機能を有効にするかどうかを制御します。 |
| syslog_compress_func |
|
システムログの圧縮アルゴリズムを設定します。 |
| syslog_disk_size |
|
システムログのディスク容量の上限を設定します。 |
| syslog_file_uncompressed_count |
|
システムログの非圧縮ファイル数を設定します。 |
| log_storage_compress_func |
|
clogストレージ圧縮の圧縮アルゴリズムを設定します。 |
| enable_dblink |
|
DBLink機能を有効にするかどうかを制御します。 |
| data_disk_write_limit_percentage |
|
データディスク書き込みの制限割合を制御します。 |
| strict_check_os_params |
|
OS構成パラメータのチェック機能のスイッチを有効にするかどうかを制御します。 |
| default_table_store_format | V4.3.0 | ユーザーテナントがデフォルトで作成するテーブルの形式を指定します。行ストア、純粋なカラムストア、冗長な行ストア/カラムストアを含みます。 |
| enable_rpc_authentication_bypass | V4.3.0 | OBServerクラスタでRPCセキュリティ認証が有効な場合、OMS移行サービスおよびOBKVサービスがRPCセキュリティ認証をバイパスしてクラスタに接続することを許可するかどうかを設定します。 |
| sql_protocol_min_tls_version | V4.2.1 | SQLステートメントがSSL接続を行う際に使用するSSL/TLSプロトコルの最小バージョン番号を設定します。 |
| compaction_dag_cnt_limit | V4.2.1 | Compaction DAGキュー上のDAG数の上限値を設定します。 |
| compaction_schedule_tablet_batch_cnt | V4.2.1 | Compactionバッチスケジューリング時の各バッチでスケジューリングするパーティション数の上限値を設定します。 |
| enable_transfer | V4.2.1 | テナント内でTransferを許可するかどうかを制御します。 |
| ttl_thread_score | V4.2.1 | TTLタスクが使用するワーカースレッド数を設定します。 |
| local_ip | V4.2.0 | クラスタデプロイ時に指定するObServerマシンのIPアドレスです。 |
| observer_id | V4.2.0 | クラスタ内でRSがOBServerノードに割り当てる一意の識別子です。 |
| standby_fetch_log_bandwidth_limit | V4.2.0 | スタンバイテナントが配置されるクラスタ内のすべてのサーバーがプライマリテナントからログを同期する際に、1秒間に占有できる最大帯域幅を設定します。 |
| storage_meta_cache_priority | V4.2.0 | kvcache内でストレージMeta Cacheの優先順位を制御します。 |
| archive_lag_target | V4.2.0 | テナントログアーカイブの遅延時間を制御します。 |
| log_disk_throttling_maximum_duration | V4.2.0 | ログスロットリングがトリガーされた後のログディスクの最大利用可能時間を調整します。 |
| log_disk_throttling_percentage | V4.2.0 | ログ書き込みスロットリングがトリガーされた場合の回収不能なログディスク容量の割合を設定します。 |
| ls_gc_delay_time | V4.2.0 | テナントログストリームの遅延削除時間を設定します。 |
| partition_balance_schedule_interval | V4.2.0 | パーティションの均衡スケジューリング間隔を設定します。 |
| range_optimizer_max_mem_size | V4.2.0 | Query Rangeモジュールが使用するメモリを制限します。 |
| standby_db_fetch_log_rpc_timeout | V4.2.0 | スタンバイデータベースのログ取得RPCタイムアウト時間を設定します。これにより、スタンバイデータベースのログ転送サービスがプライマリデータベースの特定のサーバーが利用不可であることを検出し、他のサーバーへ切り替える動作を制御できます。 |
| standby_db_preferred_upstream_log_region | V4.1.0 | 物理スタンバイデータベースシナリオにおいて、スタンバイテナントが上流ログを同期する優先Regionを設定します。 |
| log_storage_warning_tolerance_time | V4.1.0 | ログディスクのI/O失敗から、ディスクが不良ディスクとしてマークされ、プライマリ切り替えがトリガーされるまでの時間を設定します。 |
| ob_startup_mode | V4.1.0 | OBServerノードの起動モードを設定します。初回起動時の変更のみをサポートします。 |
| sql_net_thread_count | V4.1.0 | MySQLクラスタのI/Oスレッド数、すなわちglobal_sql_nio_serverスレッドの数を設定します。 |
| arbitration_timeout | V4.1.0 | 自動降格をトリガーするタイムアウト時間を設定します。 |
| dump_data_dictionary_to_log_interval | V4.1.0 | テナントデータディクショナリ永続化の周期を制御します。 |
| enable_user_defined_rewrite_rules | V4.1.0 | ユーザー定義ルールの有効化を制御するスイッチです。 |
| log_transport_compress_all | V4.1.0 | ログ転送で圧縮を使用するかどうかを設定します。 |
| log_transport_compress_func | V4.1.0 | ログ転送の圧縮アルゴリズムを指定します。 |
| rpc_memory_limit_percentage | V4.1.0 | テナント内のRPCがテナント総メモリの最大割合を設定します。 |
| tenant_sql_login_thread_count | V4.1.0 | MySQLテナントログインのスレッド数、すなわちmysql_queueスレッドの数を設定します。 |
| tenant_sql_net_thread_count | V4.1.0 | MySQLテナントI/Oスレッド数、すなわちsql_nio_serverスレッドの数を設定します。 |
| log_disk_percentage | V4.0.0 | Redoログがその配置ディスクの総容量に占める割合を設定します。 |
| log_disk_size | V4.0.0 | Redoログディスクのサイズ、すなわち当該OBServerが使用可能なログディスクの総容量を設定します。 |
| ha_high_thread_score | V4.0.0 | 高可用性・高優先順位スレッドの現在のワーカースレッド数を設定します。 |
| ha_low_thread_score | V4.0.0 | 高可用性・低優先順位スレッドの現在のワーカースレッド数を設定します。 |
| ha_mid_thread_score | V4.0.0 | 高可用性・中優先順位スレッドの現在のワーカースレッド数を設定します。 |
| query_memory_limit_percentage |
|
単一SQLが使用可能なテナントメモリの割合を指定します。 |
現在は使用されていないパラメータ
次の表は、V4.x系で廃止されたパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| schema_history_recycle_interval | 内部最適化のため、V4.4.2バージョンでは、V4.4.2 BP1バージョンから削除されました。 |
| global_write_halt_residual_memory | 関連機能は使用されなくなり、V4.2.0バージョンから削除されました。 |
| max_px_worker_count | 関連機能は使用されなくなり、V4.2.0バージョンから削除されました。 |
| plan_cache_high_watermark | 関連機能は常にサポートされていませんでした。V4.2.0バージョンから削除されました。 |
| plan_cache_low_watermark | 関連機能は常にサポートされていませんでした。V4.2.0バージョンから削除されました。 |
| rootservice_memory_limit | アーキテクチャのアップグレード変更により、V4.2.0バージョンから削除されました。 |
| system_trace_level | 実装ロジックが変更されたため、この構成パラメータは適用されなくなり、V4.2.0バージョンから削除されました。 |
| token_reserved_percentage | 実装ロジックが変更されたため、この構成パラメータは適用されなくなり、V4.2.0バージョンから削除されました。 |
| trace_log_sampling_interval | 実装ロジックが変更されたため、この構成パラメータは適用されなくなり、V4.2.0バージョンから削除されました。 |
| io_category_config | 実装ロジックが変更されたため、この構成パラメータは適用されなくなり、V4.2.0バージョンから削除されました。 |
| auto_broadcast_location_cache_rate_limit | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| auto_leader_switch_interval | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| auto_refresh_location_cache_rate_limit | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_backup_dest | 関連機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
| backup_backup_dest_option | 関連機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
| backup_dest_option | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_concurrency | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。V4.0.0バージョンから、この構成パラメータを置き換える新しいパラメータ ha_low_thread_score が追加されました。 |
| backup_dest | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_log_archive_option | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_net_limit | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_recovery_window | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_region | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| backup_zone | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| balance_blacklist_failure_threshold | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| balance_blacklist_retry_interval | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| balancer_emergency_percentage | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| balancer_timeout_check_interval | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| clog_disk_utilization_threshold | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。V4.0.0バージョンから、この構成パラメータを置き換える新しいパラメータ log_disk_utilization_threshold が追加されました。 |
| clog_expire_days | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| clog_cache_priority | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| clog_disk_usage_limit_percentage | アーキテクチャのアップグレード変更により、V4.0.0バージョンから削除されました。 |
| clog_transport_compress_func | V4.0.0バージョンではこの機能はサポートされておらず、V4.0.0以降のバージョンから削除されました。V4.1.0以降のバージョンからは、構成パラメータlog_transport_compress_funcが追加され、この構成パラメータに置き換えられました。 |
| clog_max_unconfirmed_log_count | 実装ロジックが変更されたため、関連機能は適用されなくなり、V4.0.0以降のバージョンから削除されました。 |
| clog_persistence_compress_func | 関連機能はV4.0.0バージョンではサポートされておらず、V4.0.0以降のバージョンから削除されました。V4.2.1以降のバージョン（V4.3.0バージョンを除く）から再びサポートされ、構成パラメータlog_storage_compress_funcが追加され、この構成パラメータに置き換えられました。 |
| cpu_reserved | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| data_copy_concurrency | 実装ロジックが変更されたため、V4.0.0以降のバージョンから削除されました。V4.0.0以降のバージョンからは、構成パラメータha_high_thread_scoreが追加され、この構成パラメータに置き換えられました。 |
| default_transport_compress_func | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| election_cpu_quota | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| election_blacklist_interval | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_auto_refresh_location_cache | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_auto_leader_switch | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_clog_persistence_compress | 関連機能はV4.0.0バージョンではサポートされておらず、V4.0.0以降のバージョンから削除されました。V4.2.1以降のバージョン（V4.3.0バージョンを除く）から再びサポートされ、構成パラメータlog_storage_compress_allが追加され、この構成パラメータに置き換えられました。 |
| enable_global_freeze_trigger | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_log_archive | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_election_group | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_merge_by_turn | 関連機能はサポートされなくなり、V4.0.0以降のバージョンから削除されました。 |
| enable_manual_merge | 関連機能はサポートされなくなり、V4.0.0以降のバージョンから削除されました。 |
| enable_one_phase_commit | 実装ロジックが変更されたため、関連機能は適用されなくなり、V4.0.0以降のバージョンから削除されました。 |
| enable_pg | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_separate_sys_clog | 関連機能は当初から有効ではなかったため、V4.0.0以降のバージョンから削除されました。 |
| enable_smooth_leader_switch | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| enable_rootservice_standalone | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| fast_recovery_concurrency | 実装ロジックが変更されたため、V4.0.0以降のバージョンから削除されました。V4.0.0以降のバージョンからは、構成パラメータha_high_thread_scoreが追加され、この構成パラメータに置き換えられました。 |
| flush_log_at_trx_commit | 利用頻度が低いため、V4.0.0以降のバージョンから削除されました。 |
| gc_wait_archive | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| global_index_build_single_replica_timeout | 実装ロジックが変更されたため、関連機能は適用されなくなり、V4.0.0以降のバージョンから削除されました。 |
| global_major_freeze_residual_memory | 利用頻度が低いため、V4.0.0以降のバージョンから削除されました。 |
| get_leader_candidate_rpc_timeout | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| ignore_replica_checksum_error | 使用は推奨されないため、V4.0.0以降のバージョンから削除されました。 |
| index_clog_cache_priority | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| index_info_block_cache_priority | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| index_cache_priority | アーキテクチャのアップグレードに伴う変更であり、V4.0.0以降のバージョンから削除されました。 |
| ilog_index_expire_time | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| location_cache_priority | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| location_cache_expire_time | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| log_archive_batch_buffer_limit | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| log_archive_checkpoint_interval | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。V4.0.0以降は、構成パラメータarchive_lag_targetがこのパラメータに代わります。 |
| max_kept_major_version_number | 利用頻度が低いため、V4.0.0以降のバージョンから削除されました。 |
| merge_stat_sampling_ratio | 実装方法の変更により、V4.0.0以降のバージョンから削除されました。 |
| merge_thread_count | 実装ロジックの変更により、V4.0.0以降のバージョンから削除されました。V4.0.0以降は、構成パラメータcompaction_low_thread_scoreがこのパラメータに代わります。 |
| merger_completion_percentage | 利用頻度が低いため、V4.0.0以降のバージョンから削除されました。 |
| merger_switch_leader_duration_time | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| merger_warm_up_duration_time | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| migrate_concurrency | 実装ロジックの変更により、V4.0.0以降のバージョンから削除されました。V4.0.0以降は、構成パラメータha_mid_thread_scoreがこのパラメータに代わります。 |
| minor_deferred_gc_time | 使用を推奨しないため、V4.0.0以降のバージョンから削除されました。 |
| minor_freeze_times | 構成パラメータ major_compact_trigger の意味と一致するため、V4.0.0以降のバージョンからこの構成パラメータは削除され、構成パラメータ major_compact_trigger のみが使用されます。 |
| minor_merge_concurrency | 実装ロジックの変更により、V4.0.0以降のバージョンから削除されました。V4.0.0以降は、構成パラメータcompaction_mid_thread_scoreがこのパラメータに代わります。 |
| minor_warm_up_duration_time | 使用を推奨しないため、V4.0.0以降のバージョンから削除されました。 |
| multiblock_read_gap_size | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| multiblock_read_size | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_rpc_port | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| enable_ob_esi_process | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_session_timeout | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_io_concurrency | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_memory_limit | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_syslog_level | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ob_esi_max_syslog_file_count | 対応する機能がサポートされなくなったため、V4.0.0以降のバージョンから削除されました。 |
| ofs_list | 対応する機能が適用されなくなったため、V4.0.0以降のバージョンから削除されました。 |
| partition_table_check_interval | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| rebuild_replica_data_lag_threshold | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| replica_safe_remove_time | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| resource_soft_limit | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| restore_concurrency | 実装ロジックの変更により、V4.0.0以降のバージョンから削除されました。V4.0.0以降は、構成パラメータha_high_thread_scoreがこのパラメータに代わります。 |
| row_purge_thread_count | 対応する機能は常にサポートされておらず、V4.0.0バージョンから削除されました。 |
| server_data_copy_out_concurrency | 実装ロジックが変更され、V4.0.0バージョンから削除されました。V4.0.0バージョンからは、構成パラメータha_mid_thread_scoreが追加され、このパラメータに置き換えられました。 |
| server_data_copy_in_concurrency | 実装ロジックが変更され、V4.0.0バージョンから削除されました。V4.0.0バージョンからは、構成パラメータha_mid_thread_scoreが追加され、このパラメータに置き換えられました。 |
| sql_audit_memory_limit | 実装ロジックが変更され、対応する機能は適用されなくなり、V4.0.0バージョンから削除されました。V4.0.0バージョンからは、変数ob_sql_audit_percentageが追加され、このパラメータに置き換えられました。 |
| switchover_process_thread_count | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| sys_bkgd_io_high_percentage | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| sys_bkgd_io_low_percentage | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| sys_cpu_limit_trigger | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| system_cpu_quota | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| tenant_groups | 対応する機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
| trx_force_kill_threshold | 実装ロジックが変更され、対応する機能は適用されなくなり、V4.0.0バージョンから削除されました。 |
| unit_balance_resource_weight | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| user_iort_up_percentage | 実装ロジックが変更され、対応する機能は適用されなくなり、V4.0.0バージョンから削除されました。 |
| user_tab_col_stat_cache_priority | 実装ロジックが変更され、対応する機能は適用されなくなり、V4.0.0バージョンから削除されました。 |
| wait_leader_batch_count | アーキテクチャのアップグレードに伴う変更で、V4.0.0バージョンから削除されました。 |
| zone_merge_concurrency | 対応する機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
| zone_merge_order | 対応する機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
| zone_merge_timeout | 対応する機能はサポートされなくなり、V4.0.0バージョンから削除されました。 |
V4.x系におけるシステム変数関連の変更
ユーザーのビジネス利用シナリオにより適合させるため、OceanBaseデータベースではテナント変数のデフォルト値や値の範囲などについても一連の最適化と調整を行っています。特に、以前のバージョンではundo_retentionはシステム変数として導入されていましたが、V4.x系ではV4.0.0バージョンから、このパラメータはテナントレベルの構成パラメータに調整されました。
デフォルト値を変更するシステム変数
以下の表は、デフォルト値を変更する変数を示しています。
変数名 |
説明 |
|---|---|
| ob_default_lob_inrow_threshold |
|
| sql_mode |
|
| optimizer_features_enable |
|
| secure_file_priv | V4.2.1バージョン以降、デフォルト値がNULLから""に調整されました。 |
| max_allowed_packet | V4.2.1バージョン以降、デフォルト値が4194304から16777216に調整されました。 |
| ob_max_read_stale_time | V4.1.0バージョン以降、デフォルト値が5000000から-1に調整されました。 |
| ob_trx_idle_timeout | V4.0.0バージョン以降、デフォルト値が120秒から1日に調整されました。 |
| ob_trx_timeout | V4.0.0バージョン以降、デフォルト値が100秒から1日に調整されました。 |
値の範囲または意味を変更するシステム変数
以下の表は、値の範囲または意味を変更するシステム変数を示しています。
変数名 |
説明 |
|---|---|
| secure_file_priv | V4.2.0バージョン以降、列挙値の空文字列（""）とNULLの意味が、元の「制限なし」から「インポート・エクスポートが無効」と調整されました。 |
| ob_max_read_stale_time | V4.1.0バージョン以降、値の範囲が [0, 9223372036854775807] から [-1, 9223372036854775807] に変更されました。 |
権限要件を変更するシステム変数
以下の表は、権限要件を変更する変数を示しています。
変数名 |
説明 |
|---|---|
| secure_file_priv | V4.2.0バージョン以降、この変数を変更するには、ローカルUnixソケット接続を介した接続に限定されます。 |
新規システム変数
以下の表は、V4.xバージョンで追加されたシステム変数です。
変数名 |
導入バージョン |
説明 |
|---|---|---|
| event_scheduler | V4.3.5 BP2 | イベントスケジューラーがサーバー上で有効化され、実行されているかどうかを判断するために使用されます。 |
| ob_enable_ps_parameter_anonymous_block | V4.3.5 BP2 | PSモードで匿名ブロックとCALLステートメントの解析時にパラメータ化を有効または無効にするために使用されます。 |
| ob_sparse_drop_ratio_search | V4.3.5 BP2 | HNSWインデックスのデフォルトのextra infoしきい値を設定します。 |
| ob_ivf_nprobes | V4.3.5 BP1 | ベクトルインデックスクエリを実行する際に、このクエリで最も近いクラスタ中心をいくつ検索するかを設定します。 |
| mview_refresh_dop | V4.3.5 BP1 | マテリアライズドビューのデフォルトのリフレッシュ並列度を制御します。 |
| enable_optimizer_rowgoal | V4.3.5 BP1 | 最適化エンジンが基数推定時に行数目標（LIMIT演算子など）の影響を考慮するかどうかを制御します。 |
| pid_file |
|
サーバーが自身のプロセスIDを書き込むファイルのパス名を照会するために使用されます。 |
| port |
|
OBServerノードのデプロイ時に、サーバーがTCP/IP接続をリッスンするポート番号を設定するために使用されます。 |
| socket |
|
ローカルクライアントが接続するソケットファイル名を照会するために使用されます。 |
| ob_hnsw_ef_search | V4.3.3 | HNSWベクトルインデックス検索時に考慮する近傍ノード数を設定します。 |
| ob_table_access_policy | V4.3.3 | 最適化エンジンがベーステーブル計画を生成する際に特定のストレージ形式を優先的に選択するかどうかを制御します。 |
| cardinality_estimation_model |
|
最適化エンジンが行数を推定する際に使用する相関モデルを制御します。 |
| activate_all_roles_on_login |
|
ログイン時にすべてのRolesをデフォルトで自動的に有効にするかどうかを制御します。 |
| innodb_stats_persistent |
|
InnoDBインデックス統計情報をディスクに永続化するかどうかを制御します。 |
| ob_compatibility_control |
|
MYSQL5.7およびMYSQL8.0との互換性が競合する場合の動作パターンを制御します。 |
| ob_compatibility_version |
|
製品の動作に変更が生じた機能と互換性のあるOceanBaseデータベースのバージョンを制御します。 |
| ob_security_version |
|
セキュリティ機能と互換性のあるOceanBaseデータベースのバージョンを制御します。 |
| automatic_sp_privileges |
|
ストアドプロシージャ内でALTERおよびEXECUTE権限を自動的に付与するかどうかを設定します。 |
| lc_time_names |
|
日付と月の名称および略称を表示する言語を制御します。 |
| ob_enable_pl_cache |
|
PL cacheモジュールを有効にするかどうかを制御します。 |
| optimizer_dynamic_sampling | V4.2.0 | 動的サンプリングのレベルを制御します。 |
| optimizer_features_enable | V4.2.0 | 異なるOceanBaseバージョンの最適化エンジン機能を有効にします。 |
| parallel_degree_limit | V4.2.0 | Auto DOP戦略を使用する場合、最適化エンジンが選択する並列度の上限値を設定します。 |
| parallel_degree_policy | V4.2.0 | 並列度選択ポリシーを設定します。 |
| parallel_min_scan_time_threshold | V4.2.0 | Auto DOP戦略で並列度を計算するためのパラメータ、すなわちベーステーブルスキャンを並列処理するための最小評価実行時間を設定します。 |
| runtime_filter_type | V4.2.0 | テナントレベルのRuntime Filterタイプを設定します。 |
| runtime_filter_wait_time_ms | V4.2.0 | Runtime Filterの最大待機時間を設定します。 |
| runtime_filter_max_in_num | V4.2.0 | Runtime In FilterのNDV（特定列における異なる値の数）を設定します。 |
| runtime_bloom_filter_max_size | V4.2.0 | Runtime Bloom Filterの最大使用メモリを設定します。単位はバイトです。 |
| cte_max_recursion_depth | V4.1.0 | 公共テーブル式（CTE）の最大再帰深さを設定します。サーバーはこのCTE値を超える操作の実行を終了します。 |
| ob_max_read_stale_time | V4.1.0 | 弱い読み取りクエリの最大遅延しきい値（μs）を設定します。 |
| regexp_stack_limit | V4.1.0 | 正規表現マッチング操作の内部スタックの最大利用可能メモリを設定します。デフォルト単位はバイトです。 |
| ob_enable_show_trace | V4.1.0 | Show Traceログの使用を有効にするかどうかを設定します。 |
| cursor_sharing | V4.0.0 | SQL処理時にパラメータ化を行うかどうかを判断します。 |
| innodb_strict_mode | V4.0.0 | 特定構文のSQLチェックモードを設定します。 |
| log_row_value_options | V4.0.0 | Lobが部分的更新を使用するかどうかを制御します。 |
現在では使用されていないシステム変数
次の表は、V4.x系で廃止されたシステム変数です。
変数名 |
説明 |
|---|---|
| ob_enable_trace_log | アーキテクチャのアップグレードに伴う変更で、V4.1.0以降のバージョンから削除されました。 |
| ob_create_table_strict_mode | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |
| ob_enable_blk_nestedloop_join | 実装ロジックが変更されたことにより、該当機能が適用されなくなり、V4.0.0以降のバージョンから削除されました。 |
| ob_enable_hash_group_by | 実装方法が変更されたことにより、V4.0.0以降のバージョンから削除されました。 |
| ob_timestamp_service | アーキテクチャのアップグレードに伴う変更で、V4.0.0以降のバージョンから削除されました。 |