AnalyticDB:fixnumeric

FIXNUMERIC の利用シーン

ご利用のワークロードで以下のすべてが必要な場合は、FIXNUMERIC を使用してください。

• 正確な 10 進数値：丸め誤差が許容されない金融計算、台帳、課金、コンプライアンスレポートなど

• 高いクエリパフォーマンス：数値列に対する大規模な SUM、AVG、またはその他の集約

• 予測可能なデータ範囲：64 ビットまたは 128 ビット整数範囲に収まる値

以下が必要な場合は、NUMERIC を使用してください。

• NaN のサポート：FIXNUMERIC は NaN 値をサポートしていません

• 無制限の範囲：64 ビットまたは 128 ビットの固定整数境界を超える値

• 可変スケール：行によって小数点以下の桁数が異なる列

FIXNUMERIC の仕組み

FIXNUMERIC は、各 10 進数値を、あらかじめ設定されたスケールに等しい 10 のべき乗で乗算して整数にマッピングし、その結果をネイティブ整数レジスタに格納します。たとえば、スケール 6 の 3.141592 は、整数 3141592 として格納されます。算術演算は、ネイティブ CPU 命令セットを使用してこれらの整数上で直接実行されます。これが、FIXNUMERIC 列に対する集約クエリが NUMERIC 列に対する同等のクエリよりも大幅に高速である理由です。

FIXNUMERIC には 2 つのバリアントがあります。データに必要な精度と範囲に基づいて選択してください。

値が 19 桁を超える有効数字、または小数点以下 6 桁を超える桁数を必要としない限り、FIXNUMERIC128 よりも FIXNUMERIC を使用することを推奨します。

制限事項

• AnalyticDB for PostgreSQL V7.0 インスタンスのうち、V7.2.1.1 以降のマイナーバージョンを実行しているもののみが、fixnumeric 拡張をサポートします。マイナーバージョンを確認するには、「インスタンスのマイナーバージョンを表示する」をご参照ください。スペックアップするには、「UpgradeDBVersion」をご参照ください。

• サーバーレスモードのインスタンスは fixnumeric 拡張機能をサポートしていません。

• FIXNUMERIC と FIXNUMERIC128 には固定の値範囲があります。範囲を超える値を挿入すると、オーバーフローエラーが発生します。

• スケールは列レベルではなく、型レベルで固定されます。列を作成するときにスケールを指定する必要はありません。スケールは、FIXNUMERIC では 6、FIXNUMERIC128 では 10 にあらかじめ設定されています。

拡張機能のインストール

fixnumeric 拡張機能は、GUI ベースのインストールをサポートしていません。インストールするには、してください。インストール後、AnalyticDB for PostgreSQL インスタンスを再起動してください。拡張機能をアンインストールするには、チケットを送信してください。

クエリでの FIXNUMERIC の使用

FIXNUMERIC は他の数値データ型と同様に機能し、正確な値を必要とする FLOAT または DOUBLE PRECISION 列を置き換えることができます。

CREATE TABLE test_t(a float, b numeric(14,6), c fixnumeric, d fixnumeric128);
INSERT INTO test_t SELECT v+0.1,v+0.1,v+0.1,v+0.1 FROM generate_series(1,1000) v;

CREATE INDEX ON test_t (c);
CREATE INDEX ON test_t (d);

SELECT SUM(a), SUM(b), SUM(c), SUM(d) FROM test_t;

sum         |      sum      |        sum        |        sum
--------------------+---------------+-------------------+-------------------
 500600.00000000175 | 500600.000000 | 500600.0000000000 | 500600.0000000000
(1 row)

SELECT AVG(a), AVG(b), AVG(c), AVG(d) FROM test_t;

avg        |         avg          |    avg     |      avg
-------------------+----------------------+------------+----------------
 500.6000000000017 | 500.6000000000000000 | 500.600000 | 500.6000000000
(1 row)

サポートされる関数

FIXNUMERIC は、すべての集計関数を含め、NUMERIC または DECIMAL 型をサポートするほとんどの関数と互換性があります。浮動小数点の結果を返す関数には、アスタリスク (*) が付いています。

*これらの関数は、計算前に FIXNUMERIC を DOUBLE に変換します。結果は浮動小数点値です。