CCI関連のパラメーターの設定と変更 - PolarDB - Alibaba Cloud ドキュメントセンター

このトピックでは、Clustered Columnar Index (CCI) を作成するときに関連するパラメーターを設定する方法と、CCIが設定されるパラメーターを変更する方法について説明します。

サポートされているバージョン

インスタンスはV5.4.20以降を実行します。

説明

バージョン番号の詳細については、「リリースノート」をご参照ください。
インスタンスのバージョンを表示する方法の詳細については、「インスタンスのバージョンの表示と更新」をご参照ください。

CCIの作成時に関連するパラメーターを設定する

CCIを作成するときは、COLUMNAR_OPTIONSキーワードを使用してCCI関連のパラメーターを指定できます。例：

CREATE CLUSTERED COLUMNAR INDEX `cci` 
ON tb (`id`) 
PARTITION BY KEY (`id`)
PARTITIONS 16
COLUMNAR_OPTIONS='{
  "dictionary_columns":"col1,col2",
  "type":"snapshot", 
  "snapshot_retention_days":"7",
  "auto_gen_columnar_snapshot_interval":"30"
}';

説明

COLUMNAR_OPTIONSフィールドはJSON形式の文字列です。

次の表に、構成可能なパラメーターを示します。

パラメーター	説明	スコープ	動的変更
type	CCIタイプ。デフォルト値：default。有効な値： snapshot: CCIとカラムストアのスナップショットが作成されます。 default: CCIのみが作成され、列ストアのスナップショットは作成されません。	インスタンスとCCI	対応
snapshot_retention_days	カラムストアのスナップショットの保持期間。単位：日。有効な値： 1から366。デフォルト値 : 7 グローバル設定を指定した場合、設定が優先されます。これは、カラムストアのスナップショットが7日間保持されることを示します。説明保存期間に達した場合、システムはスナップショットを照会できることを保証しません。このパラメータは、タイムゾーンの設定を必要としません。例： `snapshot_retention_days`パラメーターが`7`に設定されている場合、`T0`に生成されたスナップショットは少なくとも`T0 + 7`日間保持されます。 `T0 + 7`日後、スナップショットは照会できません。このパラメーターは、`type`パラメーターが`snapshot`に設定されている場合にのみ有効です。	インスタンスとCCI	対応
auto_gen_columnar_snapshot_interval	2つの列のスナップショットポイントの間隔。単位：分有効な値：デフォルト値: `-1`。これは、列ストアのスナップショットポイントが自動的に生成されないことを示します。グローバル設定を指定した場合、設定が優先されます。デフォルト値 (`-1`) を除いて、他の有効な値は5以上です。説明このパラメーターを設定すると、システムは自動的に`call polardbx.columnar_flush(schema_name, table_name, index_name)` コマンドを呼び出して、`auto_gen_columnar_snapshot_interval`パラメーターで指定された指定間隔でスナップショットポイントを生成します。最初の自動呼び出し中に1分続くレイテンシが発生する場合があります。コマンドを手動で呼び出して、スナップショットポイントを生成できます。このパラメーターは、`type`パラメーターが`snapshot`に設定されている場合にのみ有効です。	インスタンスとCCI	対応
dictionary_columns	辞書エンコーディングの列。デフォルト値は NULL です。詳細については、「CCIを作成するためのガイドライン」トピックのDictionary encodingセクションを参照してください。	CCI	非対応

CCI関連のパラメータの変更

次のコードを実行して、CCI関連のパラメーターを動的に変更できます。

# Modify instance parameters.
CALL polardbx.columnar_set_config(param_key, param_val);

# Modify CCI-related parameters.
CALL polardbx.columnar_set_config(cci_id, param_key, param_val);

# Specify the database name, table name, and CCI name to modify CCI-related parameters.
CALL polardbx.columnar_set_config(schema_name, table_name, cci_name, param_key, param_val);

説明

cci_idは、一意のcci idを示します。 cci_id値の取得方法の詳細については、「SHOW COLUMNAR STATUS」をご参照ください。
param_keyは、設定するパラメーターの名前を示します。
param_valは、設定するパラメーターの値を示します。