ตัวสร้าง Avro Schema
สร้าง Apache Avro record schema จากตัวอย่าง JSON อนุมานชนิดของ field, logical types (uuid, timestamp-millis) และ nullable unions รับได้ทั้ง JSON เดี่ยว,
Loading tool...
ตัวสร้าง Avro Schema คืออะไร?
ตัวสร้าง Avro schema เปลี่ยนข้อมูลตัวอย่าง JSON ให้เป็น Apache Avro record schema ซึ่งเป็น contract แบบมีชนิดข้อมูลที่ใช้กับ Kafka, Confluent Schema Registry, Hadoop และ data lake pipeline เพียงวาง object เดี่ยว, array ของ sample หรือ NDJSON บรรทัดละ object เครื่องมือจะอนุมานชนิด Avro ของแต่ละ field (string, int, long, double, boolean, record ซ้อนใน, array) ตรวจจับ logical types เช่น uuid และ timestamp-millis และทำเครื่องหมาย field ที่หายไปหรือเป็น null ในบาง sample เป็น nullable union พร้อม default null ทั้งหมดทำงานในเบราว์เซอร์ของคุณ
ประโยชน์หลัก
- เปลี่ยนตัวอย่าง JSON ดิบเป็น Avro contract ที่มีชนิดข้อมูลครบภายในไม่กี่วินาที
- รวมหลาย sample เพื่อให้ schema สะท้อนความหลากหลายของข้อมูลจริง ไม่ใช่แค่ record เดียว
- field แบบ optional กลายเป็น nullable union พร้อม default null ตามแนวปฏิบัติของ Avro
- ตั้งชื่อ record และ namespace ได้ ให้ตรงกับกฎการตั้งชื่อของ Schema Registry
- ทำงาน 100% ฝั่ง client — ข้อมูลตัวอย่างไม่ออกจากเบราว์เซอร์
กรณีการใช้งาน
- •สร้าง schema เริ่มต้นสำหรับ Kafka producer หรือ consumer จาก event JSON ตัวอย่าง
- •ลงทะเบียน schema ใน Confluent Schema Registry โดยไม่ต้องเขียนชนิด field เอง
- •กำหนด schema ตาราง Hive หรือ Hadoop จาก JSON record ที่ export มา
- •ทำเอกสาร API payload เป็น Avro contract สำหรับส่งมอบงานระหว่างทีม data engineering
- •ย้าย pipeline แบบ JSON ไปเป็น Avro binary format โดยมี schema เริ่มต้นที่ตรวจสอบแล้ว
วิธีสร้าง Avro schema จาก JSON
- วางข้อมูลตัวอย่าง: วาง JSON object เดี่ยว, array ของ object หรือ NDJSON ลงช่องอินพุต หรือกด Sample เพื่อโหลดสอง record ที่โชว์ union และ logical type
- ตั้งชื่อ record และ namespace: กรอกในแผง Options โดยค่าเริ่มต้นเป็น RootRecord และ com.example เพื่อให้ตรงกับ naming rule ของ Schema Registry ของคุณ
- ตรวจฟิลด์ที่อนุมานได้: ดูในผลลัพธ์ว่า int กับ long, nested record, array, logical type uuid และ timestamp-millis ถูกต้อง พร้อม nullable union ที่ default เป็น null สำหรับฟิลด์ทางเลือก
- คัดลอกหรือดาวน์โหลด schema: กด Copy เพื่อคัดลอก หรือกด Download เพื่อบันทึกไฟล์ .avsc ตามชื่อ record โดยทุกอย่างอนุมานในเบราว์เซอร์ ไม่มีการอัปโหลดข้อมูลตัวอย่าง
คุณสมบัติหลัก
- อนุมานชนิดข้อมูล string, boolean, int, long, double, record ซ้อนใน และ array
- ตรวจจับ logical types: uuid และ datetime แบบ ISO-8601 (timestamp-millis)
- รวมหลาย sample เข้าด้วยกัน — field ที่หายไปบางส่วนกลายเป็น nullable union พร้อม default null
- รับ input ได้ทั้ง object เดี่ยว, array ของ object หรือ NDJSON บรรทัดละ object
- ปรับชื่อ record และ namespace ใน schema ที่สร้างได้ตามต้องการ
- ทำงาน offline ในเบราว์เซอร์ของคุณทั้งหมด — ไม่มีข้อมูลออกจากเครื่อง
คำถามที่พบบ่อย
ตัวสร้าง schema รับอินพุตแบบไหนบ้าง
รับ JSON object เดี่ยว, array ของ object หรือ NDJSON ที่บรรทัดละหนึ่ง object ไม่เกิน 1 MB โดยจะรวมหลาย sample เข้าด้วยกันเพื่อให้ schema ครอบคลุมทุกความแปรผันของฟิลด์ ไม่ใช่แค่ record แรก
ระบบอนุมานชนิดข้อมูลอย่างไร
จำนวนเต็มที่อยู่ในช่วง 32 บิตเป็น int ที่ใหญ่กว่าเป็น long ทศนิยมเป็น double, boolean คงเดิม และ object ซ้อนกลายเป็น record ถ้าเปิดตรวจ logical type UUID จะกลายเป็น string แบบ logicalType uuid และวันเวลา ISO-8601 เป็น long แบบ timestamp-millis
ฟิลด์ที่ขาดหายไปในบาง sample จะเป็นอย่างไร
จะกลายเป็น nullable union เช่น ["null", "string"] พร้อม default เป็น null เมื่อเปิดตัวเลือก nullable unions ไว้ ถ้าต้องการ schema เข้มงวดที่บังคับทุกฟิลด์ให้ปิดตัวเลือกนี้
กำหนดชื่อ record และ namespace เองได้ไหม
ได้ ตั้งได้ในแผง Options โดยค่าเริ่มต้นชื่อ record คือ RootRecord และ namespace คือ com.example ไฟล์ที่ดาวน์โหลดจะตั้งชื่อตาม record ของคุณ เช่น UserEvent.avsc