JSON 演算子

Zilliz Cloud は、JSON フィールドのクエリとフィルタリングに使用できる高度な演算子をサポートしており、複雑で構造化されたデータの管理に最適です。これらの演算子を使用すると、JSON ドキュメントを効果的にクエリし、JSON フィールド内の特定の要素、値、条件に基づいてエンティティを取得できます。このセクションでは、Zilliz Cloud で JSON 固有の演算子を使用する方法を、実際の例を交えて説明します。

📘Notes

JSON フィールドは複雑なネスト構造を扱えず、すべてのネスト構造をプレーン文字列として扱います。そのため、JSON フィールドを使用する場合は、過度に深いネストを避け、最適なパフォーマンスを得るためにデータ構造をできるだけフラットに保つことをお勧めします。

使用可能な JSON 演算子

Zilliz Cloud は、JSON データのフィルタリングとクエリに役立つ強力な JSON 演算子をいくつか提供しています。演算子は次のとおりです。

• JSON_CONTAINS(identifier, expr): 指定した JSON 式がフィールド内に見つかったエンティティをフィルタリングします。

• JSON_CONTAINS_ALL(identifier, expr): 指定した JSON 式のすべての要素がフィールドに存在することを保証します。

• JSON_CONTAINS_ANY(identifier, expr): JSON 式の少なくとも 1 つのメンバーがフィールド内に存在するエンティティをフィルタリングします。

実際のシナリオでこれらの演算子をどのように適用できるかを、例を交えて確認します。

JSON_CONTAINS

json_contains 演算子は、特定の要素またはサブ配列が JSON フィールド内に存在するかどうかを確認します。JSON 配列またはオブジェクトに特定の値が含まれていることを確認したい場合に便利です。

例

商品のコレクションがあり、各商品の tags フィールドに ["electronics", "sale", "new"] のような文字列の JSON 配列が含まれているとします。タグ "sale" を持つ商品をフィルタリングするとします。

Python

python

# JSON data: {"tags": ["electronics", "sale", "new"]}
filter = 'json_contains(product["tags"], "sale")'

Java

java

// JSON data: {"tags": ["electronics", "sale", "new"]}
String filter = "json_contains(product[\"tags\"], \"sale\")";

Go

go

// JSON data: {"tags": ["electronics", "sale", "new"]}
filter := "json_contains(product[\"tags\"], \"sale\")"

Rust

rust

// JSON data: {"tags": ["electronics", "sale", "new"]}
let filter = "json_contains(product[\"tags\"], \"sale\")";

C++

c++

// JSON data: {"tags": ["electronics", "sale", "new"]}
std::string filter = "json_contains(product[\"tags\"], \"sale\")";

NodeJS

javascript

// JSON data: {"tags": ["electronics", "sale", "new"]}
const filter = 'json_contains(product["tags"], "sale")';

CSharp

csharp

// JSON data: {"tags": ["electronics", "sale", "new"]}
string filter = "json_contains(product[\"tags\"], \"sale\")";

cURL

bash

# JSON data: {"tags": ["electronics", "sale", "new"]}
filter='json_contains(product["tags"], "sale")'

この例では、Zilliz Cloud は tags フィールドに要素 "sale" が含まれているすべての商品を返します。

JSON_CONTAINS_ALL

json_contains_all 演算子は、指定した JSON 式のすべての要素が対象のフィールドに存在することを保証します。JSON 配列内で複数の値を一致させたい場合に特に便利です。

例

商品タグのシナリオを引き続き使用し、タグ "electronics"、"sale"、"new" を持つすべての商品を検索する場合は、json_contains_all 演算子を使用できます。

Python

python

# JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
filter = 'json_contains_all(product["tags"], ["electronics", "sale", "new"])'

Java

java

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
String filter = "json_contains_all(product[\"tags\"], [\"electronics\", \"sale\", \"new\"])";

Go

go

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
filter := "json_contains_all(product[\"tags\"], [\"electronics\", \"sale\", \"new\"])"

Rust

rust

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
let filter = "json_contains_all(product[\"tags\"], [\"electronics\", \"sale\", \"new\"])";

C++

c++

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
std::string filter = "json_contains_all(product[\"tags\"], [\"electronics\", \"sale\", \"new\"])";

NodeJS

javascript

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
const filter = 'json_contains_all(product["tags"], ["electronics", "sale", "new"])';

CSharp

csharp

// JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
string filter = "json_contains_all(product[\"tags\"], [\"electronics\", \"sale\", \"new\"])";

cURL

bash

# JSON data: {"tags": ["electronics", "sale", "new", "discount"]}
filter='json_contains_all(product["tags"], ["electronics", "sale", "new"])'

このクエリは、tags 配列に指定した 3 つの要素 "electronics"、"sale"、"new" がすべて含まれているすべての商品を返します。

JSON_CONTAINS_ANY

json_contains_any 演算子は、JSON 式の少なくとも 1 つのメンバーがフィールド内に存在するエンティティをフィルタリングします。複数の候補値のいずれかに基づいてエンティティを一致させたい場合に便利です。

例

タグ "electronics"、"sale"、"new" の少なくとも 1 つを持つ商品をフィルタリングするとします。これは json_contains_any 演算子を使用して実現できます。

Python

python

# JSON data: {"tags": ["electronics", "sale", "new"]}
filter = 'json_contains_any(product["tags"], ["electronics", "new", "clearance"])'

Java

java

// JSON data: {"tags": ["electronics", "sale", "new"]}
String filter = "json_contains_any(product[\"tags\"], [\"electronics\", \"new\", \"clearance\"])";

Go

go

// JSON data: {"tags": ["electronics", "sale", "new"]}
filter := "json_contains_any(product[\"tags\"], [\"electronics\", \"new\", \"clearance\"])"

Rust

rust

// JSON data: {"tags": ["electronics", "sale", "new"]}
let filter = "json_contains_any(product[\"tags\"], [\"electronics\", \"new\", \"clearance\"])";

C++

c++

// JSON data: {"tags": ["electronics", "sale", "new"]}
std::string filter = "json_contains_any(product[\"tags\"], [\"electronics\", \"new\", \"clearance\"])";

NodeJS

javascript

// JSON data: {"tags": ["electronics", "sale", "new"]}
const filter = 'json_contains_any(product["tags"], ["electronics", "new", "clearance"])';

CSharp

csharp

// JSON data: {"tags": ["electronics", "sale", "new"]}
string filter = "json_contains_any(product[\"tags\"], [\"electronics\", \"new\", \"clearance\"])";

cURL

bash

# JSON data: {"tags": ["electronics", "sale", "new"]}
filter='json_contains_any(product["tags"], ["electronics", "new", "clearance"])'

この場合、Zilliz Cloud はリスト ["electronics", "new", "clearance"] 内のタグを少なくとも 1 つ持つすべての商品を返します。商品がこれらのタグの 1 つだけを持つ場合でも、結果に含まれます。