SORT_JSON_OBJECT_KEYS
説明
SORT_JSON_OBJECT_KEYSはJSONオブジェクトのキーをソートします。この関数はJSONオブジェクトを入力として受け取り、辞書順でソートされたキーを持つ新しいJSONオブジェクトを返します。
JSON標準によると、JSONオブジェクトは順序のないコレクションであることに注意してください。ただし、この関数は、例えば2つのJSONオブジェクトが同一の内容であるかを比較する場合など、キーの順序の一貫性を確保する必要がある場合に有用です。
構文
SORT_JSON_OBJECT_KEYS(json_value)
エイリアス
SORT_JSONB_OBJECT_KEYS
パラメータ
json_value - キーをソートする必要があるJSON値。JSON型である必要があります。
戻り値
キーが辞書順でソートされた新しいJSONオブジェクトを返します。戻り値の型は入力のJSON型と一致します。
入力がNULLの場合、関数はNULLを返します。
例
基本的なキーソート
SELECT sort_json_object_keys(cast('{"b":123,"b":456,"a":789}' as json));
+------------------------------------------------------------------+
| sort_json_object_keys(cast('{"b":123,"b":456,"a":789}' as json)) |
+------------------------------------------------------------------+
| {"a":789,"b":123} |
+------------------------------------------------------------------+
ネストされたJSON配列の処理
SELECT sort_json_object_keys(cast('[{"b":123,"b":456,"a":789},{"b":123},{"b":456},{"a":789}]' as json));
+----------------------------------------------------------------------------------------------------+
| sort_json_object_keys(cast('[{"b":123,"b":456,"a":789} ,{"b":123},{"b":456},{"a":789} ]' as json)) |
+----------------------------------------------------------------------------------------------------+
| [{"a":789,"b":123},{"b":123},{"b":456},{"a":789}] |
+----------------------------------------------------------------------------------------------------+
NULL値の処理
SELECT sort_json_object_keys(null);
+-----------------------------+
| sort_json_object_keys(null) |
+-----------------------------+
| NULL |
+-----------------------------+
注意事項
-
SORT_JSON_OBJECT_KEYS関数には別名SORT_JSONB_OBJECT_KEYSがあり、両方の関数は同一の機能を持ちます。 -
この関数はオブジェクトのキーのみをソートし、関連する値は変更しません。
-
この関数はオブジェクトのみをソートし、配列はソートしません。これは標準で配列が順序付きコレクションであると規定されているためです。
-
JSONオブジェクト内の重複するキーは、Doris JSON型に変換される際にマージされ、最初のキーと値のペアのみが保持されます。
-
この関数は主に、比較やデバッグの目的でJSONオブジェクトのキーが一貫した順序で表示されることを保証するために使用されます。デフォルトではDoris JSON型はキーの順序を保証しないためです。
