Add Release notes for V5.8

knonomura · knonomura · commit e1112eeb4648 · 2025-06-02T17:07:58.000+09:00
diff --git a/docs/GridDB-5.8-CE-RELEASE_NOTES.md b/docs/GridDB-5.8-CE-RELEASE_NOTES.md
@@ -0,0 +1,126 @@
+# GridDB CE 5.8
+
+## Changes in V5.8
+
+The main changes in GridDB CE version 5.8 are as follows:
+
+- SQL Optimization Enhancements
+
+    Supported Join Optimization for the driving table, the inner table of SQL execution. The join plan can be generated with the cost-based method.
+
+- Timeseries-data Functionality Enhancements
+
+    Supported moving average calculation for SQL analytic functions. And improved the accuracy of date arithmetic functions.
+
+---
+
+## SQL Optimization Enhancements
+
+It is now possible to switch between cost-based and rule-based methods to select the driving table and the inner table for join operation, and this can be configured using the following:
+- Cluster definition file (gs_cluster.json)
+- Hint phase
+
+Using the cluster definition file (gs_cluster.json):
+
+  * /sql/costBasedJoinDriving：Specifies whether to use the cost-based method for determining the driving table for join during SQL plan generation. If set to false, it uses the rule-based method. The default value is true, which indicates the cost-based method.
+
+
+Using the hint phase：
+
+  * CostBasedJoinDriving()：Use the cost-based method for determining the driving table for join.
+  * NoCostBasedJoinDriving()：Use the rule-based method for determining the driving table for join.
+
+## Timeseries-data Functionality Enhancements
+
+### Supported moving average calculation for SQL analytic functions
+
+
+Added FRAME clause for SQL analytic functions
+
+``` example
+    function OVER ( [PARTITION BY expression1 ] [ ORDER BY expression2 ] [ FRAME-clause ] )
+```
+
+The syntax of FRAME-clause is as bellow:
+
+``` example
+    ROWS | RANGE <FRAME-start-value> | BETWEEN <FRAME-start-value> AND <FRAME-end-value>
+```
+
+The syntax of the start value and the end value of Frame is as bellow:
+
+``` example
+    UNBOUNDED PRECEDING | UNBOUNDED FOLLOWING | CURRENT ROW | <Frame-boundary1> PRECEDING | <Frame-boundary2> FOLLOWING 
+```
+
+- CURRENT ROW: Specify the current row to be analyzed
+- UNBOUNDED: Specify the head or the tail of the partition
+- PRECEDING/FOLLOWING: Specify preceding or following
+
+The syntax of the boundary of Frame is as bellow:
+
+``` example
+    value1 | ( value2, unit )
+```
+
+- The following functions can be specified the FRAME-clause.
+
+    AVG、COUNT、MAX、MIN、SUM、TOTAL、STDDEV、VAR
+
+- The following functions can not be specified the FRAME-clause.
+
+    ROW_NUMBER、LAG、LEAD
+
+例)
+
+Calculate the moving average for the previous 10 rows.
+
+``` example
+SELECT
+    AVG(value1)
+        OVER(ORDER BY time) 
+        ROWS BETWEEN 10 PRECEDING AND CURRENT ROW
+FROM tbl1;
+```
+
+Calculate the moving average for the period up to 10 minutes prior to each row.
+
+``` example
+SELECT
+    AVG(value1)
+        OVER(ORDER BY time)
+        RANGE BETWEEN (10, MINUTE) PRECEDING AND CURRENT ROW
+FROM tbl1;
+```
+
+### Improved the accuracy of date arithmetic functions
+
+Added the following functions for SQL and TQL(query language for NoSQL Interface).
+
+- SQL
+``` example
+  * TIMESTAMP_MS(timestamp_string [, timezone])：Converts a string representation of the time to a TIMESTAMP(3) type with millisecond precision.
+  * TIMESTAMP_US(timestamp_string [, timezone])：Converts a string representation of the time to a TIMESTAMP(6) type with microsecond precision.
+  * TIMESTAMP_NS(timestamp_string [, timezone])：Converts a string representation of the time to a TIMESTAMP(9) type with nanosecond precision.
+```
+
+- TQL
+``` example
+  * TIMESTAMP_MS(str)：Converts a string representation of the time to a TIMESTAMP(3) type with millisecond precision.
+  * TIMESTAMP_US(str)：Converts a string representation of the time to a TIMESTAMP(6) type with microsecond precision.
+  * TIMESTAMP_NS(str)：Converts a string representation of the time to a TIMESTAMP(9) type with nanosecond precision.
+```
+
+And The following functions now support calculations with microsecond and nanosecond precision:
+
+- SQL
+``` example
+  * TIMESTAMP_ADD(time_unit, timestamp, duration [, timezone])/TIMESTAMP_DIFF(time_unit, timestamp1, timestamp2 [, timezone])
+```
+
+- TQL
+``` example
+  * TIMESTAMPADD(time_unit, timestamp, duration)/TIMESTAMPDIFF(time_unit, timestamp1, timestamp2)
+  Note: We have also added TIMESTAMP_ADD()/TIMESTAMP_DIFF(), which have the same names as the SQL functions.
+```
+
diff --git a/docs/GridDB-5.8-CE-RELEASE_NOTES_ja.md b/docs/GridDB-5.8-CE-RELEASE_NOTES_ja.md
@@ -0,0 +1,127 @@
+# GridDB CE 5.8
+
+## 変更点
+
+GridDB CE V5.8の主な変更点は以下のとおりです。
+
+- SQL最適化の強化
+
+    SQL検索実行時におけるジョイン方向（駆動表・内部表）の最適化を強化しました。従来のSQLプランでは、ジョイン演算の方向はユーザが記述したSELECT文の内容や順序に基づき、ルールを用いて決定されていました。そのため、ユーザはルールを理解し、テーブル規模や絞込み条件に応じて適切なプランが生成されるようにSELECT文を記述する必要がありました。今回の強化により、検索実行中に算出されるロウ数（テーブル規模や絞込み条件を考慮した概算値）をコストとして計算し、このコストを基にジョイン方向を最適化したプランを生成できるようになりました。
+
+- 時系列データ管理・検索機能の強化
+
+    SQL分析関数機能強化(移動平均演算)：SQL実行機能における分析関数のオプション構文として、SQL標準で定義されているフレーム句(分析対象とするデータ範囲の件数・幅指定)に対応しました。これにより、SQLを用いた時系列データのトレンド分析が容易に実現できるようになりました。
+
+    日付演算機能の精度向上：現状のSQLによる日時型演算機能の一部で行えなかった、マイクロ秒・ナノ秒精度の演算が可能となりました。
+
+---
+
+## SQL最適化の強化
+
+結合処理において、最初にアクセスするテーブルを駆動表、次にアクセスして結合するテーブルを内部表といいます。駆動表の決め方には、コストベースによる方法とルールベースによる方法の２種類あります。いずれを用いるかは以下を使って設定できます。
+- クラスタ定義ファイル(gs_cluster.json)
+- ヒント
+
+クラスタ定義ファイル(gs_cluster.json)を使う場合：
+
+  * /sql/costBasedJoinDriving：SQLプラン生成の際、ジョイン方向（駆動表・内部表）の決定にコストベースによる方法を用いるかどうかを指定します。用いない(false)場合は、ルールベースを用いて駆動表を決定します。デフォルト値はコストベースによる方法(true)です。
+
+ヒントを使う場合：
+
+  * CostBasedJoinDriving()：コストベースによる方法で駆動表を決定します。
+  * NoCostBasedJoinDriving()：コストベースによる方法を用いないで、ルールベースによる方法で駆動表を決定します。
+
+## 時系列データ管理・検索機能の強化
+
+### SQL分析関数機能強化(移動平均演算)
+
+分析関数にFRAME句が追加されました。
+
+FRAME句はパーティション全体ではなくフレーム上で作動するウィンドウ関数に対して、ウィンドウフレームを構成する行の集合を指定します。
+
+``` example
+    関数 OVER ( [PARTITION BY 式1 ] [ ORDER BY 式2 ] [ FRAME句 ] )
+```
+
+ここで、FRAME句の構文は以下の通りです。
+
+``` example
+    ROWS | RANGE <フレーム開始値> | BETWEEN <フレーム開始値> AND <フレーム終了値>
+```
+
+フレーム開始値・終了値の構文は以下の通りです。 
+
+``` example
+    UNBOUNDED PRECEDING | UNBOUNDED FOLLOWING | CURRENT ROW | <フレーム境界値1> PRECEDING | <フレーム境界値2> FOLLOWING 
+```
+
+- CURRENT ROW: 分析対象の現在位置のロウを示します
+- UNBOUNDED: パーティションの先頭もしくは末端を示します
+- PRECEDING/FOLLOWING: 前方もしくは後方を示します
+
+フレーム境界値の構文は以下の通りです。
+
+``` example
+    値1 | ( 値2, 単位 )
+```
+
+- 同名の集計関数と対応づく既存の分析関数すべてで、FRAME句を指定できます。
+
+    AVG、COUNT、MAX、MIN、SUM、TOTAL、STDDEV、VAR
+
+- 同名の集計関数と対応付かない以下の分析関数では、FRAME句を指定できません。
+
+    ROW_NUMBER、LAG、LEAD
+
+例)
+
+各ロウの10件前までを集計対象とする移動平均を求める。
+
+``` example
+SELECT
+    AVG(value1)
+        OVER(ORDER BY time) 
+        ROWS BETWEEN 10 PRECEDING AND CURRENT ROW
+FROM tbl1;
+```
+各ロウの10分前までを集計対象とする移動平均を求める。
+
+``` example
+SELECT
+    AVG(value1)
+        OVER(ORDER BY time)
+        RANGE BETWEEN (10, MINUTE) PRECEDING AND CURRENT ROW
+FROM tbl1;
+```
+
+### 日付演算機能の精度向上
+
+SQLおよびTQLに以下の関数を追加しました。
+
+- SQL
+``` example
+  * TIMESTAMP_MS(timestamp_string [, timezone])：時刻の文字列表現timestamp_stringの値を、ミリ秒精度のTIMESTAMP(3)型に変換します。
+  * TIMESTAMP_US(timestamp_string [, timezone])：時刻の文字列表現timestamp_stringの値を、マイクロ秒精度のTIMESTAMP(6)型に変換します。
+  * TIMESTAMP_NS(timestamp_string [, timezone])：時刻の文字列表現timestamp_stringの値を、ナノ秒精度のTIMESTAMP(9)型に変換します。
+```
+
+- TQL
+``` example
+  * TIMESTAMP_MS(str)：時刻の文字列表現をミリ秒精度のTIMESTAMP(3)型に変換します。
+  * TIMESTAMP_US(str)：時刻の文字列表現をマイクロ秒精度のTIMESTAMP(6)型に変換します。
+  * TIMESTAMP_NS(str)：時刻の文字列表現をナノ秒精度のTIMESTAMP(9)型に変換します。
+```
+
+また、以下の関数でマイクロ秒・ナノ秒精度の演算が可能となりました。
+
+- SQL
+``` example
+  * TIMESTAMP_ADD(time_unit, timestamp, duration [, timezone])/TIMESTAMP_DIFF(time_unit, timestamp1, timestamp2 [, timezone])
+```
+
+- TQL
+``` example
+  * TIMESTAMPADD(time_unit, timestamp, duration)/TIMESTAMPDIFF(time_unit, timestamp1, timestamp2)
+  ※ SQLの関数と同名のTIMESTAMP_ADD()/TIMESTAMP_DIFF()も追加しました。
+```
+
