Azure Synapse Veri Gezgini veri alımı özellikleri (Önizleme)

Önemli

Azure Synapse Analytics Veri Gezgini (Önizleme) 7 Ekim 2025'te kullanımdan kaldırılacaktır. Bu tarihten sonra Synapse Veri Gezgini'ne çalışan iş yükleri silinir ve ilişkili uygulama verileri kaybolur. Microsoft Fabric'te Eventhouse'a geçiş yapmanızı kesinlikle öneririz.

Microsoft Cloud Migration Factory (CMF) programı, müşterilere Fabric'e geçişte yardımcı olmak için tasarlanmıştır. Program, müşteriye hiçbir ücret ödemeden uygulamalı klavye kaynakları sunar. Bu kaynaklar, önceden tanımlanmış ve üzerinde anlaşmaya varılmış bir kapsama sahip 6-8 haftalık bir süre için atanır. Müşteri adaylıkları Microsoft hesabı ekibinden veya doğrudan CMF ekibine yardım isteği gönderilerek kabul edilir.

Veri alımı, verilerin tabloya eklendiği ve Veri Gezgini'nde sorgu için kullanılabilir hale getirildiği işlemdir. Anahtar sözcük with sonrasında veri alma komutuna özellikler eklersiniz.

Sindirim özellikleri

Aşağıdaki tabloda Veri Gezgini tarafından desteklenen özellikler listelenir, bunlar açıklanır ve örnekler sağlanır:

Mülkiyet	Description	Example
ingestionMapping	Kaynak dosyadaki verilerin tablodaki gerçek sütunlara nasıl eşlendiğini gösteren dize değeri. Değeri ilgili format eşleme türüyle tanımlayın. Bkz. veri eşlemeleri.	with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]") (kullanım dışı: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference	Adlandırılmış eşleme ilkesi nesnesi kullanılarak kaynak dosyadaki verilerin tablodaki gerçek sütunlara nasıl eşlendiğini gösteren dize değeri. Değeri ilgili format eşleme türüyle tanımlayın. Bkz. veri eşlemeleri.	with (format="csv", ingestionMappingReference = "Mapping1") (kullanım dışı: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime	Alınan veri kapsamlarının oluşturma zamanında kullanılacak datetime değeri (ISO8601 dizesi olarak biçimlendirilir). Belirtilmezse geçerli değer (now()) kullanılır. Bekletme ilkesinin doğru şekilde uygulanması için eski verileri alırken varsayılan değerin geçersiz kılınması yararlı olur. Belirtildiğinde, hedef tablonun etkin Lookback özelliğin belirtilen değerle hizalandığından emin olun.	with (creationTime="2017-02-13")
extend_schema	Belirtildiyse komutuna tablonun şemasını genişletme talimatı veren bir Boole değeri (varsayılan olarak falseolarak kullanılır). Bu seçenek yalnızca .append ve .set-or-append komutları için geçerlidir. İzin verilen tek şema uzantılarının sonunda tabloya ek sütunlar eklenir.	Özgün tablo şeması ise (a:string, b:int)geçerli bir şema uzantısı olabilir (a:string, b:int, c:datetime, d:string), ancak (a:string, c:datetime) geçerli olmaz
folder	Sorgudan alma komutları için tabloya atanacak klasör. Tablo zaten varsa, bu özellik tablonun klasörünü geçersiz kılar.	with (folder="Tables/Temporary")
format	Veri biçimi ( desteklenen veri biçimlerine bakın).	with (format="csv")
ingestIfNotExists	Tabloda aynı değere sahip bir etiketle etiketlenmiş veriler varsa, belirtilirse alımın başarılı olmasını engelleyen bir ingest-by: dize değeri. Bu, etkili veri alımını sağlar. Daha fazla bilgi için ingest-by: tags bölümüne bakın.	Etiketli ingest-by:Part0001 veriler zaten varsa, özellikler with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') geçerli alımın tamamlanmaması gerektiğini gösterir. Henüz yoksa, bu yeni alım için bu etiketin ayarlanmış olması gerekir (gelecekte aynı verileri tekrar alma girişiminde bulunulması durumunda).
ignoreFirstRecord	Ayarlanırsa true, alımın her dosyanın ilk kaydını yoksayması gerektiğini gösteren bir Boole değeridir. Bu özellik, dosyadaki ilk kayıt sütun adlarıysa, CSV ve benzeri formatlardaki dosyalar için kullanışlıdır. Varsayılan olarak varsayılır false .	with (ignoreFirstRecord=false)
persistDetails	Belirtilirse, .show operation details komutunun bunları alabilmesi için komutun ayrıntılı sonuçları (başarılı olsa bile) kalıcı hale getireceğini belirten Boole değeri. Varsayılan olarak false değerini alır.	with (persistDetails=true)
policy_ingestiontime	Belirtilirse, boole değeri, bu komutla oluşturulan bir tabloda Alma Zamanı İlkesi'nin etkinleştirilip etkinleştirilmeyeceğini belirten bir açıklama sağlar. Varsayılan değer: true.	with (policy_ingestiontime=false)
recreate_schema	Belirtildiyse komutun tablonun şemasını yeniden oluşturup oluşturamayacağını açıklayan boole değeri. Bu özellik yalnızca komutu için .set-or-replace geçerlidir. Her ikisi de ayarlandıysa bu özellik özelliğinden extend_schema önceliklidir.	with (recreate_schema=true)
tags	JSON dizesi olarak biçimlendirilmiş, alınan verilerle ilişkilendirilecek etiketlerin listesi	with (tags="['Tag1', 'Tag2']")
validationPolicy	Alma sırasında hangi doğrulamaların çalıştırıldığını gösteren bir JSON dizesi. Farklı seçeneklerin açıklaması için bkz. Veri alımı .	with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (bu aslında varsayılan ilkedir)
zipPattern	ZIP arşivi olan depolama alanından veri alırken bu özelliği kullanın. Bu, ZIP arşivinde hangi dosyaların alındığını seçerken kullanılacak normal ifadeyi gösteren bir dize değeridir. Arşivdeki diğer tüm dosyalar göz ardı edilir.	with (zipPattern="*.csv")

Sonraki Adımlar

• Veri alımı hakkında daha fazla bilgi edinin.
• Desteklenen veri biçimleri hakkında daha fazla bilgi edinin.