OceanBaseデータベースは、V4.xバージョンでアーキテクチャの変更・アップグレードおよびリファクタリングが行われたため、多くの構成パラメータや変数が機能しなくなりました。V4.xでは、無効な構成パラメータや変数が削除または変更されています。例えば、メジャーフリーズをトリガーするために使用されていた構成パラメータ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バージョンでセマンティクスが変更されたパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| 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_ls_leader_balance |
|
ログストリームのLeader自動均衡を有効にするかどうかを制御します。 |
| enable_gts_standalone |
|
テナントGTSサービスが専用ユニットセットを使用する機能を有効にするかどうかを設定します。 |
| zone_deploy_mode |
|
テナントの各Zoneにおける分散モードを設定します。 |
| 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カーソルの最大数を制御します。 |
| 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 | ステートメント実行時に、すべての deterministic UDFのキャッシュプールが使用できる最大メモリ量（バイト単位）を設定します。0の場合、実行時キャッシュ機能は無効になります。 |
| attach_shared_sstable_thread_score | V4.4.0 | テナントが共有ストレージモードで計算ノード間のデータ参照を実行するために使用できるスレッド数を設定します。 |
| inc_sstable_upload_thread_score | V4.4.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バージョン以降、オープンソースモードでは、この構成パラメータのデフォルト値が |
| 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 | 外部テーブル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が行われない場合、強制的に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 | データロード操作でHintが指定されていない場合に、パラメータで定義されたHintを使用するかどうかを制御します。 |
| 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系で廃止されたパラメータを示しています。
パラメータ名 |
説明 |
|---|---|
| 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バージョンから、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バージョン以降、デフォルト値が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ステートメントの解析時にパラメータ化を有効または無効にするかどうかを制御します。 |
| obsparse_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 |
|
ローカルクライアントが接続する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 | 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に対する部分的更新を制御します。 |
| 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以降のバージョンから削除されました。 |