Halaman ini berisi detail project penulisan teknis yang diterima untuk Google Season of Docs.
Ringkasan project
- Organisasi open source:
- Apache Flink
- Penulis teknis:
- Kartik Khare
- Nama project:
- Memperluas Dokumentasi SQL & Table API
- Durasi proyek:
- Durasi standar (3 bulan)
Project description
Flink SQL menunjukkan potensi yang luar biasa. Ide bahwa Anda dapat mengerjakan Streaming hanya menggunakan SQL sudah jelas, tetapi rumit. Saya yakin Flink SQL pada akhirnya dapat menghilangkan kebutuhan engineer data untuk analisis data real-time yang tidak penting seperti menghitung permintaan Uber/Lyft di berbagai kota secara real-time. Langkah pertama untuk mencapai tujuan ini adalah menyederhanakan dokumentasi sehingga seseorang dengan latar belakang analitik juga dapat memulai.
Berikut beberapa peningkatan yang saya rencanakan untuk dokumen. Kita dapat membahasnya lebih lanjut saat benar-benar memulai dokumentasi - * Halaman ringkasan tidak berisi contoh apa pun. Halaman ini harus berisi contoh mudah untuk memberikan pengantar ke Table API. * Halaman Konsep & API Umum harus dibagi. * Fungsi harus memiliki halaman terpisah untuk setiap kategori. Fungsi juga harus dicantumkan dalam bentuk tabel dengan nama, data input, parameter (jika ada), dan nilai return sebagai kolom. * Halaman Jenis Data harus berisi pemetaan yang tepat dari jenis data JAVA → jenis data SQL. Representasi saat ini dalam bentuk paragraf, tetapi idealnya, representasi tersebut harus berupa tabel. * Bagian Sintaksis ekspresi di halaman Table API harus memiliki format yang lebih baik. * Halaman yang benar-benar baru tentang Perencana dan cara pengguna dapat memanfaatkannya. * Halaman tentang pengoptimalan yang saat ini tersebar di beberapa bagian. Halaman Ringkasan SQL juga perlu diformat ulang.
Konten juga perlu diubah karena terasa sedikit berlebihan. Kita juga perlu menambahkan bagian tentang tempat Anda dapat menggunakan Table API sebagai ganti Streaming API dengan perbandingan seperti pengurangan baris kode, pengoptimalan implisit yang lebih baik, keterbacaan yang lebih baik, dan proses debug yang lebih mudah.