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ノードを再起動することなく即時に反映されます。
以下の表は、効力発生日を変更する構成パラメータを示しています。
| パラメータ名 | 説明 |
|---|---|
| server_cpu_quota_min |
|
| server_cpu_quota_max |
|
デフォルト値を変更する構成パラメータ
次の表に、デフォルト値を変更する構成パラメータが示されています。
| パラメータ名 | 説明 |
|---|---|
| compaction_dag_cnt_limit | V4.3.5バージョンについて、V4.3.5 BP3バージョン以降、デフォルト値が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.3.5バージョンについて、V4.3.5 BP3バージョン以降、値の範囲は[10000, 200000]から[10000, 500000]に調整されました。 |
| compaction_dag_cnt_limit | V4.3.5バージョンについて、V4.3.5 BP3バージョン以降、値の範囲は[10000, 200000]から[10000, 500000]に調整されました。 |
| 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系で意味が変更された構成パラメータを示します。
| パラメータ名 | 説明 |
|---|---|
| datafile_maxsize | V4.3.4バージョン以降、共有なし（Shared-Nothing、SN）モードではこのパラメータの意味は変更されません。共有ストレージ（Shared-Storage、SS）モードでは、このパラメータは無意味です。 |
| datafile_next | V4.3.4バージョン以降、共有なし（Shared-Nothing、SN）モードではこのパラメータの意味は変更されません。共有ストレージ（Shared-Storage、SS）モードでは、このパラメータは無意味です。 |
| datafile_disk_percentage | V4.3.4バージョン以降、共有なし（Shared-Nothing、SN）モードではこのパラメータの意味は変更されません。共有ストレージ（Shared-Storage、SS）モードでは、このパラメータはローカル利用可能キャッシュ領域がディスク全体に占める割合を設定します。 |
| datafile_size | V4.3.4バージョン以降、共有なし（Shared-Nothing、SN）モードではこのパラメータの意味は変更されません。共有ストレージ（Shared-Storage、SS）モードでは、このパラメータはローカルキャッシュ領域のサイズを設定します。 |
新規構成パラメータ
以下の表に、V4.x系で追加された構成パラメータを示します。
| パラメータ名 | 導入バージョン | 説明 |
|---|---|---|
| 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 | 新規作成されるグローバルインデックスで自動パーティション機能を有効にするかどうかを制御します。 |
| default_storage_cache_policy | V4.3.5 BP2 | デフォルトのキャッシュポリシーを設定します。 |
| enable_manual_storage_cache_policy | V4.3.5 BP2 | ユーザーが手動で指定したホットスポットキャッシュポリシーを有効にします。 |
| suspend_storage_cache_task | V4.3.5 BP2 | バックグラウンドキャッシュタスクを一時停止するかどうかを設定します。 |
| 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 | 外部テーブルコネクタに依存する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 | このテーブルで自動パーティション機能を有効にするかどうかを制御します。 |
| auto_split_tablet_size | V4.3.4 | テナントで自動パーティション機能が有効になっている場合、分割をトリガーするしきい値を制御します。 |
| sync_io_thread_count | V4.3.4 | 同期IOリクエストのスレッド数を設定します。 |
| 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 | カラムストアエンジンが一度にベクトル化してバッチ処理する行数を制御します。 |
| 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 | スタンバイテナントが存在するクラスタ内のすべてのServerが、プライマリテナントからログを同期する際のトラフィック合計が、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系で廃止された構成パラメータを示します。
| パラメータ名 | 説明 |
|---|---|
| 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以降のバージョンからは、このパラメータに代わってclog_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を除く）から再びサポートされるようになり、このパラメータに代わってclog_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以降、undo_retentionはテナントレベルの構成パラメータに変更されました。
デフォルト値を変更するシステム変数
次の表は、デフォルト値を変更する変数を示しています。
| 変数名 | 説明 |
|---|---|
| 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以降のバージョンから、デフォルト値が120sから1dに変更されました。 |
| 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 |
|
ログイン時にすべてのロールをデフォルトで自動的に有効にするかどうかを制御します。 |
| 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](200.system-variable/300.global-system-variable/10000(optimizer_features_enable-global.md) | 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 | 弱い整合性読み取りクエリの最大遅延しきい値（us）を設定します。 |
| 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が部分的更新を使用するかどうかを制御します。 |
| ob_enable_rich_error_msg | V4.0.0 | SQL実行エラー時にsvr_ip、time、trace_idなどの情報を表示するかどうかを制御します。 |
現在では使用されなくなったシステム変数
以下の表に、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以降のバージョンから削除されました。 |