KingbaseES JSON_REMOVE関数のKingbaseデータベースへの使用方法の紹介

1. JSON_REMOVE 関数の紹介

KES では、拡張機能はデータベースの機能の追加と拡張を行うための仕組みです。拡張機能を使用すると、特定のニーズを満たすために、KES に新しいデータ型、関数、演算子、インデックスの種類、および構文を追加することができます。

JSON_REMOVE関数は、一般的に使用されるMySQLのJSON関数をサポートするために使用される、KESのMySQLモードにおける拡張機能の1つです。JSON_REMOVE関数の主な機能は、JSONオブジェクトまたは配列から指定されたキーまたはインデックスを削除することです。JSON_REMOVE関数の構文は以下のとおりです。

JSON_REMOVE(json_doc, path[, path]…)

json_doc は操作対象の JSON オブジェクトまたは配列、path は削除するキーまたはインデックスを示す 1 つ以上のパス式です。JSON_REMOVE 関数は、指定されたパス式に基づいて、json_doc から対応するキーまたはインデックスと、それらの対応する値を削除します。パス式が複数のキーまたはインデックスに一致する場合、一致したすべてのキーまたはインデックスとそれらの対応する値が削除されます。

以下は、JSON_REMOVE関数の使用法を示す例です。

SELECT

{"name":"John"}

これは、ageとcityのキーが削除された後、残ったJSONオブジェクトにはnameのキーとその値のみが含まれることを意味します。

仮に、ユーザー情報(名前、年齢、居住地)を含む「ユーザー」というテーブルがあるとします。JSON_REMOVE関数と条件文を使用して、年齢に基づいてデータをフィルタリングすることができます。

まず、「ユーザー」というテーブルを作成し、いくつかのデータを挿入します。

CREATE TABLE users(

id INT AUTO_INCREMENT PRIMARY KEY,

data JSON

;

次に、条件ロジックと動的に生成されたパス式を使用して、cityキーを削除します。

UPDATE users

END)

WHERE JSON_CONTAINS_PATH(data, 'one', '$.city');

上記の例では、JSON_REMOVE関数を使用してcityキーを移動させています。条件に従って、年齢が25歳未満の場合は、パス式「$.ctiy」を使用してcityキーを移動させ、それ以外はNULLを使用します。また、JSON_CONTAINS_PATH関数を使用して、cityキーがJSONオブジェクトに存在するかどうかを確認します。

更新ステートメントを実行すると、ユーザーテーブルのデータは年齢条件に基づいて、cityキーから動的に削除されます。例えば、25歳未満のユーザーにはcityキーが含まれなくなります。ユーザーテーブルのデータをクエリします。

SELECT * FROM users;

出力は次のようになります。

id

data

1

{"name":"John","age":30}

2

{"name":"Alice","age":20}

3

{"name":"Bob","age":40,"city":"Paris"}

ご覧の通り、25歳未満のユーザーのデータには、cityキーが含まれていません。

この例では、条件に基づいてキーを削除するためにJSON_REMOVE関数を使用する方法を示しています。特定の条件に応じて、JSONオブジェクト内のキーを柔軟に削除または保持することができます。

JSON_REMOVE関数を使用する際の注意事項

KESでJSON_REMOVE関数を使用する際には、いくつかの注意事項があります。

まず、削除するキーまたはパス式を指定する際には、正しい構文と形式を使用してください。パス式は単純なキー名、またはネストされたキーや配列インデックスを指定する複雑なパス式です。パス式が操作対象のJSON値の構造と一致していることを確認してください。

2. JSON_REMOVE関数を呼び出す際には、まず削除するキーがJSON値に存在するかどうかを確認することが最善です。JSON_CONTAINS_PATH関数を使用して、キーの存在を確認することができます。これにより、存在しないキーに対してJSON_REMOVE関数を呼び出すことを回避でき、エラーを回避できます。

3. JSON_REMOVE 関数を使用して JSON 値を修正する際には、データの整合性を確保してください。複数のセッションが同時に同じ JSON 値を修正すると、データの不整合が発生する可能性があります。並行処理環境で JSON_REMOVE 関数を使用する場合は、トランザクションやロックなどの並行制御メカニズムを考慮する必要があります。

これらの注意事項に従うことで、KES の JSON_REMOVE 関数を正しく使用し、潜在的なエラーやデータの不整合の問題を回避することができます。