Bu sayfada, Google Dokümanlar Sezonu için kabul edilen bir teknik yazım projesinin ayrıntıları yer almaktadır.
Proje özeti
- Açık kaynak kuruluşu:
- Apache Flink
- Teknik yazar:
- Kartik Khare
- Proje adı:
- Table API ve SQL belgelerini genişletin
- Proje uzunluğu:
- Standart uzunluk (3 ay)
Proje açıklaması
Flink SQL, şaşırtıcı bir potansiyel gösteriyor. Yalnızca SQL kullanarak akışlarla çalışabileceğiniz fikri açıktır ancak karmaşıktır. Flink SQL'in, çeşitli şehirlerdeki Uber/Lyft isteklerini gerçek zamanlı olarak sayma gibi gerçek zamanlı verilerle ilgili basit analizler için veri mühendislerine olan ihtiyacı ortadan kaldırabileceğine inanıyorum. Bu hedefe ulaşmak için ilk adım, dokümanları analiz geçmişi olan kullanıcıların da başlayabileceği şekilde basitleştirmektir.
Belgeler için planladığım iyileştirmelerden bazıları aşağıda verilmiştir. Dokümanlara gerçekten başladığımızda bu konularda daha fazla konuşabiliriz. * Genel bakış sayfasında örnek yoktur. Table API'ye giriş niteliğinde kolay örnekler içermelidir. * Kavramlar ve Ortak API sayfası bölünmelidir. * İşlevler her kategori için ayrı bir sayfaya sahip olmalıdır. İşlevler, ad, giriş verileri, parametreler (varsa) ve döndürülen değer sütunları olarak tablo şeklinde de listelenmelidir. * Veri Türü sayfası, uygun JAVA veri türü → SQL veri türü eşlemelerini içermelidir. Mevcut gösterim paragraf biçimindedir ancak ideal olarak tablo olmalıdır. * Tablo API'sı sayfasındaki Söz dizimi bölümü daha iyi biçimlendirmeye sahip olmalıdır. * Planlayıcılar ve kullanıcıların bunlardan nasıl yararlanabileceği ile ilgili tamamen yeni bir sayfa. * Şu anda birden fazla bölüme dağılmış optimizasyonlarla ilgili bir sayfa. SQL'e Genel Bakış sayfasının da yeniden biçimlendirilmesi gerekir.
İçeriğin biraz bunaltıcı olduğu için yeniden düzenlenmesi de gerekiyor. Ayrıca, kod satırlarında azalma, daha iyi dolaylı optimizasyonlar, daha iyi okunabilirlik ve daha kolay hata ayıklama gibi karşılaştırmalarla Streaming API yerine Table API'yi kullanabileceğiniz yerler hakkında bir bölüm eklememiz gerekiyor.