Sorgulama İçin BigQuery'de Telefon Numaralarını E.164 Formatına Normalleştirme

Telefon numaralarını E.164 formatına normalleştirmek için.

Bir Orijinal Operatör Sorgulama işlemi öncesinde BigQuery'de telefon numaralarını E.164 formatına normalleştirmek için ham sütunu koruyun, bir çalışma sütununda sunum karakterlerini ayıklayın ve yalnızca yetkili bir ülke alanı bu seçimi desteklediğinde ülke kodu ekleyin. CarrierLookup gerçek zamanlı istekleri için başında artı işareti bulundurun. Tek ülkeli bir dosya görevi için, ülke kodlu rakamları dışa aktarın ve dönen CSV dosyasını sabit bir anahtar kullanarak mutabık kılın.

Orijinal numarayı ve ülke kanıtını koruyun

Temizlik sırasında telefon numarasının tek kopyasının üzerine yazmayın. Ham değer, kaynak ülke, normalleştirilmiş aday ve reddedilme veya manuel inceleme nedeni için ayrı sütunlar oluşturun. Bir kaynak; ulusal arama öneki, yerel format veya tutarsız yazılmış bir ülke kodu içerebilir. Bir Regex, noktalama işaretlerini kaldırabilir ancak bir numaranın hangi ülkeye ait olduğuna karar veremez. Bu karar, güvenilir bir ülke alanı veya diğer yetkili kaynak kanıtlarını gerektirir.

ITU E.164 recommendation uluslararası numaralandırma yapısını tanımlar. CarrierLookup gerçek zamanlı sorgulamaları; başında + işareti, ülke kodu ve boşluk veya ayırıcı içermeyen abone numarası gerektirir. Sadece rakamlara benzeyen bir aday, otomatik olarak geçerli bir numara değildir. Belirsiz değerleri, bir insan veya doğrulanmış bir numaralandırma kuralı çözene kadar sorgulama kümesinin dışında tutun.

Dışa aktarma şeklini en başta planlayın. Gerçek zamanlı çoklu istekler farklı ülkelerden numaralar içerebilir ve giriş sırasına göre döner. CarrierLookup'ın toplu dosya görevi, seçilen tek bir ülkeden gelen numaraları kabul eder. Karışık ülkeli bir veri kümesini, dosyaları hazırlamadan önce güvenilir ülke atamasına göre bölün; sadece ilk birkaç rakama bakarak bir ülke seçmeyin.

Mekanik temizlik için BigQuery fonksiyonlarını kullanın

Google'ın BigQuery string-function reference dokümanı REGEXP_REPLACE, REGEXP_CONTAINS ve ilgili fonksiyonları açıklar. Bunları; kaynak değerin bir kopyasından boşlukları, parantezleri ve kısa çizgileri kaldırmak gibi mekanik dönüşümler için kullanın. REGEXP_REPLACE(raw_phone, r'[^0-9+]', '') gibi basit bir ifade bir inceleme adayı oluşturabilir, ancak beklenmedik bir dahili artı işaretini de koruyabilir. Bunu bir format testi ve karantina yolu ile takip edin; her çıktıyı doğrudan API'ye göndermeyin.

Halihazırda güvenilir bir artı işareti ve ülke koduyla saklanan veriler için, bir aday ifade, o artı işaretini korurken ayırıcıları temizleyebilir. Yerel numaralar için, güncel numaralandırma kılavuzuna göre gözden geçirilmiş ülkeye özel bir normalleştirme kuralı kullanın. Orijinal değer zaten bir ülke kodu veya ana hat öneki içerdiğinde, genel bir "CRM ülke kodunu başa ekle" kuralı risklidir. Her kaynak türüne uygulanan özel dönüşümü belgeleyin ve dışa aktarmadan önce çıktıyı örnekleyin.

Pratik bir hazırlık tablosu; raw_phone, country_source, normalized_e164, normalization_rule ve review_status sütunlarını içerir. Sorgulama girişini yalnızca hazır olarak işaretlenmiş satırlardan oluşturun. Bu, reddedilen bir formatın operatör bulunamadı sonucuyla karıştırılmasını önler ve düzeltmeleri geri alınabilir kılar.

Gerçek zamanlı çoklu yolu hazırlayın

Küçük bir hazır küme için, + işaretini ve ardından ülke kodlu rakamları içeren E.164 dizelerini REST çoklu iş akışına aktarın. POST /api/v1/batch-check uç noktası 1–100 arası numarayı kabul eder ve sıralı, eşzamanlı bir sonuç döndürür. Çağrıyı göndermeden önce istek öğesinden kaynak satır anahtarına bir konumsal eşleme kaydedin. CRM'de yinelenen kayıtlar olduğunda yalnızca aynı telefon değerlerine güvenmeyin.

Dönen her öğenin identifier ve exists durumunu okuyun. exists=false durumu, öğenin normal bir sonucu olmadığını ifade eder; numaranın bağlantısının kesildiği anlamına gelmez. Başarılı bir sonuç; operatör, temel operatör, numara türü, ülke kodu, bölge ve şehir bilgilerini içerebilir, isteğe bağlı alanlar boş olabilir. Her sonucun sorgulama zamanını ve giriş ilişkisini hazırlık tablosunda tutun.

Tekli sorgulama, bir operatörün tek bir kaydı incelemesi gerektiğinde aynı E.164 formunu kullanır. Belgelenmiş X-API-Key başlığını kullanarak güvenilir bir sunucudan kimlik doğrulaması yapın. Bu iş akışı, veri ekiplerine çok daha büyük bir hazırlık listesi göndermeden önce bir örnek üzerinde normalleştirmeyi test etme imkanı verir.

Tek ülkeli dosya görevlerini hazırlayın

Büyük bir liste için, satır başına bir ülke kodlu numara içeren tek sütunlu bir TXT veya CSV oluşturun ve toplu görev için ilgili ISO ülkesini seçin. Belgelenmiş giriş, seçilen o ülkeye ait olmalıdır. Çok parçalı gönderimde, ülke alanı dosyadan önce gelmelidir. Toplu hazırlık; geçersiz satırları, yinelenenleri, ülke kodu olmayan satırları ve seçilen ülke dışındaki numaraları kaldırır. Kaynak dışa aktarımını tamamen işlenmiş olarak kabul etmeden önce hazırlık sayılarını inceleyin.

Toplu görev eşzamansızdır: POST /api/v1/bulk-tasks ile gönderin, görev kimliğini kaydedin ve GET /api/v1/bulk-tasks/{id} sorgusunu 30 saniyeden daha sık olmayacak şekilde yapın. Başarılı bir görev bir CSV dosyası sağlar. Tanımlayıcıyı, artı işareti olmadan düz ülke kodlu rakamlar olarak raporlar. Bu, gerçek zamanlı istek formundan farklıdır, bu nedenle sonucu doğrudan dize eşitliği ile ham telefon alanına bağlamayın.

Her kabul edilen E.164 adayından yalnızca rakamlardan oluşan normalleştirilmiş bir birleştirme anahtarı oluşturun ve kaynak satır anahtarını ayrı tutun. Giriş yinelenen numaralar içeriyorsa, toplu hazırlık bunları birleştirebilir; bir sonucun birkaç kaynak kayıtla ilişkilendirilip ilişkilendirilmeyeceğine karar verin. Eşleşmeyen, geçersiz ve yinelenen kaynak satırlarını sonuç CSV'sinin dışında mutabık kılın.

CRM güncellemelerinden önce birleştirilmiş verileri inceleyin

Sonuçlanan operatör, taşıma işleminden sonraki mevcut hizmet veren operatörü değil, orijinal tahsisatı tanımlar. Bölge ve şehir, canlı konumdan ziyade tahsisat coğrafyasıdır. Analistlerin bir alan adını kişinin şu an nerede olduğunun kanıtı sanmaması için bu açıklamaları veri sözlüğüne koyun. code=0 ile tamamlanan gerçek zamanlı bir sonuç, isteğe bağlı operatör alanlarını boş bırakabilir; negatif bir etiket oluşturmak yerine boşlukları Mevcut değil olarak tutun.

Birkaç kaynak sistemden ve ülkeden birleştirilmiş satırları örnekleyin. Ham numaranın, normalleştirilmiş E.164 formunun, düz rakam anahtarının ve sonuç tanımlayıcısının aynı girişe referans verdiğini kontrol edin. Değerleri CRM'e yazmadan önce hazırlık tablosundaki uyumsuzlukları araştırın. Tahsisat bağlamı daha sonra tekrar gözden geçirilebileceğinden ve kaynak kaydın kendisi değişebileceğinden sorgulama zaman damgasını saklayın.

Bu iş hattı üç işi birbirinden ayırır: BigQuery bilinen bir temsili temizler, CarrierLookup belgelenmiş tahsisat alanlarını sağlar ve CRM ekibi güncellemeyi yapıp yapmayacağına karar verir. Bu ayrım, hataları görünür kılar ve operatör sonucunu kendi anlam sınırları içinde tutar.

SSS

Ekipler BigQuery'de telefon ayırıcılarını nasıl kaldırabilir?

Bir çalışma kopyası ve REGEXP_REPLACE gibi belgelenmiş dize fonksiyonlarını kullanın, ardından adayı beklenen E.164 şekline göre doğrulayın.

Ekipler yerel bir numaraya nasıl ülke kodu atayabilir?

Güvenilir bir ülke alanı ve gözden geçirilmiş ülkeye özel bir kural kullanın. Ülkesi veya arama biçimi belirsiz olan satırları karantinaya alın.

Ekipler toplu bir CSV dosyasını E.164 girdisiyle nasıl birleştirebilir?

Kabul edilen E.164 adaylarından yalnızca rakamlardan oluşan sabit bir anahtar oluşturun ve bunu toplu CSV tanımlayıcısıyla mutabık kılın, bu sırada kaynak satır kimliklerini koruyun.

Ekipler karışık ülkeli bir listeyi nasıl yönetebilir?

Küçük, karışık ülkeli bir küme için gerçek zamanlı çoklu istekleri kullanın veya büyük dosyaları toplu gönderimden önce güvenilir ülke atamasına göre bölün.

Daha Fazla Bilgi

İş akışınızın bir sonraki adımına uyan ürün bilgisini seçin.

• Ürün dokümantasyonunu görüntüleyin →
• Ekiple görüşün →