JSON functions - MaxCompute - Alibaba Cloud Dokümantasyon Merkezi

İndeks

İşlev	Özellikler
FROM_JSON	Belirtilen çıkış biçimine göre bir JSON dizesinden ARRAY, MAP veya STRUCT türünde bir değer döndürür.
GET_JSON_OBJECT	Belirtilen yolu kullanarak bir JSON dizesinden bir dize ayıklar.
JSON_ARRAY	Boş olabilen bir JSON nesnesini, bu nesneyi içeren bir JSON dizisine dönüştürür.
JSON_CONTAINS	Bir JSON belgesinin belirtilen bir JSON öğesini içerip içermediğini denetler.
JSON_EXISTS	Bir JSON belgesinde belirtilen JSONPath ifadesinin var olup olmadığını denetler.
JSON_EXPLODE	Bir JSON dizisindeki veya JSON nesnesindeki her öğeyi birden çok satıra genişletir.
JSON_EXTRACT	Belirtilen bir JSONPath ifadesine dayanarak bir JSON dizesinden veya JSON veri türünden veri ayıklar.
JSON_FORMAT	Bir JSON veri türünü dizeye dönüştürür. Çıktı varsayılan olarak düzenlenmiş (prettified) değildir.
JSON_INSERT	Bir JSON belgesinde belirtilen konuma bir JSON değeri ekler.
JSON_LENGTH	Belirtilen yoldaki JSON verisinin uzunluğunu döndürür.
JSON_OBJECT	Anahtar-değer çiftlerinden bir JSON nesnesi oluşturur.
JSON_PARSE	Bir dizeyi JSON veri türüne dönüştürür. Dize geçerli JSON biçiminde değilse hata döndürülür.
JSON_PRETTY	Satır sonları ve boşluklar ekleyerek bir JSON dizesini okunabilirlik açısından biçimlendirir.
JSON_SET	Bir JSON belgesinde belirtilen yoldaki mevcut bir değeri değiştirir veya yeni bir değer ekler.
JSON_STRIP_NULLS	Bir JSON nesnesinden veya JSON dizisinden değeri `null` olan tüm alanları veya öğeleri kaldırır.
JSON_TUPLE	Belirtilen bir anahtar grubu için standart bir JSON dizesinden dizeler ayıklar.
JSON_TYPE	Bir JSON değerinin tür adını döndürür.
JSON_UNQUOTE	Bir JSON dizesinden tırnak işaretlerini kaldırır.
JSON_VALID	Bir dizenin geçerli bir JSON olup olmadığını denetler.
TO_JSON	Belirtilen bir karmaşık veri türünü JSON dizesine dönüştürür.

Kullanım notları

SDK sürüm gereksinimleri
- Yalnızca Java SDK V0.44.0 ve sonraki sürümler desteklenir.
- Yalnızca PyODPS V0.11.4.1 ve sonraki sürümler desteklenir.
Tablo işlemi sınırlamaları
- Bir tabloya JSON sütunu ekleyemezsiniz.
- Küme tabloları desteklenmez.
- Delta Table türündeki tablolar desteklenmez.
SQL işlemi sınırlamaları
- JSON türü üzerinde karşılaştırma işlemleri desteklenmez.
- JSON türünde ORDER BY veya GROUP BY yan tümcelerini kullanamazsınız. Ayrıca bir JSON türü sütununu JOIN anahtarı olarak kullanamazsınız.
Veri hassasiyeti
- Bir JSON NUMBER değerinin tam sayı kısmı BIGINT türü olarak depolanır. Tam sayı BIGINT aralığının dışındaysa taşma oluşur.
- Bir JSON NUMBER değerinin ondalık kısmı DOUBLE türü olarak depolanır. Ondalık kısım DOUBLE türüne dönüştürülürken hassasiyet kaybı yaşanabilir.
Karakter sınırlamaları: Unicode karakteri \u0000, JSON verisi oluşturmak için kullanılan dizelerde desteklenmez.
Motor uyumluluğu: Hologres gibi başka bir motor kullanarak bir tablodan veri okursanız JSON veri türü okunamaz.
Java UDF'leri ve Python UDF'leri JSON türünü desteklemez.
JSON veri türü en fazla 20 düzey derinliğinde iç içe yerleştirilebilir.
Geliştirme araçları

Desteklenen geliştirme araçları arasında MaxCompute istemcisi (odpscmd), MaxCompute Studio ve DataWorks bulunur. Dataphin gibi harici ekosistemler desteklenmez. JSON veri türünü harici bir sistemle kullanmak istiyorsanız başlamadan önce uyumluluğunu onaylamanız gerekir. odpscmd istemcisini kullanırken aşağıdakilere dikkat edin:
- İstemciyi V0.46.5 veya sonraki bir sürüme yükseltmeniz gerekir. Aksi takdirde DESC json_table komutunu çalıştıramaz veya Tunnel kullanarak JSON verilerini indiremezsiniz.
- İstemci yükleme yolundaki conf\odps_config.ini dosyasında use_instance_tunnel parametresini false olarak ayarlayın. Aksi takdirde sorgular başarısız olur.

Başvuru kaynakları

JSON veri türü hakkında daha fazla bilgi için bkz. JSON veri türü.