datafusion functions json
v0.43.0 2024-11-13
หมายเหตุ: นี่ไม่ใช่การเปิดตัว Apache Software Foundation อย่างเป็นทางการ โปรดดู datafusion-contrib/datafusion-functions-json#5
ลังนี้มีชุดฟังก์ชันสำหรับการสืบค้นสตริง JSON ใน DataFusion ฟังก์ชันต่างๆ ได้รับการปรับใช้เป็นฟังก์ชันสเกลาร์ที่สามารถใช้ในการสืบค้น SQL
หากต้องการใช้ฟังก์ชันเหล่านี้ คุณจะต้องโทร:
datafusion_functions_json :: register_all ( & mut ctx ) ? ;
หากต้องการลงทะเบียนฟังก์ชัน JSON ด้านล่างใน SessionContext
ของคุณ
-- Create a table with a JSON column stored as a string
CREATE TABLE test_table (id INT , json_col VARCHAR ) AS VALUES
( 1 , ' {} ' ),
( 2 , ' { "a": 1 } ' ),
( 3 , ' { "a": 2 } ' ),
( 4 , ' { "a": 1, "b": 2 } ' ),
( 5 , ' { "a": 1, "b": 2, "c": 3 } ' );
-- Check if each document contains the key 'b'
SELECT id, json_contains(json_col, ' b ' ) as json_contains FROM test_table;
-- Results in
-- +----+---------------+
-- | id | json_contains |
-- +----+---------------+
-- | 1 | false |
-- | 2 | false |
-- | 3 | false |
-- | 4 | true |
-- | 5 | true |
-- +----+---------------+
-- Get the value of the key 'a' from each document
SELECT id, json_col - > ' a ' as json_col_a FROM test_table
-- +----+------------+
-- | id | json_col_a |
-- +----+------------+
-- | 1 | {null=} |
-- | 2 | {int=1} |
-- | 3 | {int=2} |
-- | 4 | {int=1} |
-- | 5 | {int=1} |
-- +----+------------+
json_contains(json: str, *keys: str | int) -> bool
- true หากสตริง JSON มีคีย์เฉพาะ (ใช้สำหรับตัวดำเนินการ ?
) json_get(json: str, *keys: str | int) -> JsonUnion
- รับค่าจากสตริง JSON ด้วย "เส้นทาง" json_get_str(json: str, *keys: str | int) -> str
- รับค่าสตริงจากสตริง JSON ด้วย "เส้นทาง" json_get_int(json: str, *keys: str | int) -> int
- รับค่าจำนวนเต็มจากสตริง JSON ด้วย "เส้นทาง" json_get_float(json: str, *keys: str | int) -> float
- รับค่าทศนิยมจากสตริง JSON ด้วย "เส้นทาง" json_get_bool(json: str, *keys: str | int) -> bool
- รับค่าบูลีนจากสตริง JSON ด้วย "เส้นทาง" json_get_json(json: str, *keys: str | int) -> str
- รับสตริง JSON แบบดิบที่ซ้อนกันจากสตริง JSON ด้วย "เส้นทาง" json_as_text(json: str, *keys: str | int) -> str
- รับค่าใดๆ จากสตริง JSON ด้วย "เส้นทาง" ซึ่งแสดงเป็นสตริง (ใช้สำหรับตัวดำเนินการ ->>
) json_length(json: str, *keys: str | int) -> int
- รับความยาวของสตริงหรืออาร์เรย์ JSON ->
โอเปอเรเตอร์ - นามแฝงสำหรับ json_get
->>
โอเปอเรเตอร์ - นามแฝงสำหรับ json_as_text
?
โอเปอเรเตอร์ - นามแฝงสำหรับ json_contains
การแสดงนิพจน์ด้วย json_get
จะถูกเขียนใหม่ด้วยวิธีที่เหมาะสม เช่น
select * from foo where json_get(attributes, ' bar ' )::string = ' ham '
จะถูกเขียนใหม่เป็น:
select * from foo where json_get_str(attributes, ' bar ' ) = ' ham '
json_keys(json: str, *keys: str | int) -> list[str]
- รับคีย์ของสตริง JSON json_is_obj(json: str, *keys: str | int) -> bool
- จริงถ้า JSON เป็นวัตถุ json_is_array(json: str, *keys: str | int) -> bool
- จริงหาก JSON เป็นอาร์เรย์ json_valid(json: str) -> bool
- จริงหาก JSON ถูกต้อง