Hızlı Başlangıç: Synapse Studio ile toplu yükleme

Synapse Studio'daki Toplu Yükleme sihirbazıyla verileri kolayca yükleyebilirsiniz. Synapse Studio, Azure Synapse Analytics'in bir özelliğidir. Toplu Yükleme sihirbazı, verileri ayrılmış bir SQL havuzuna toplu yüklemek için COPY deyimiyle bir T-SQL betiği oluşturma işleminde size yol gösterir.

Toplu Yükleme sihirbazına erişim noktaları

Synapse Studio'da aşağıdaki alana sağ tıklayarak verileri toplu olarak yükleyebilirsiniz: Çalışma alanınıza bağlı azure depolama hesabından bir dosya veya klasör.

Önkoşullar

• Sihirbaz, kimlik doğrulaması için Microsoft Entra pass-through kullanan bir COPY deyimi oluşturur. Microsoft Entra kullanıcınızın, Azure Data Lake Storage 2. Nesil hesabı için en azından Depolama Blob Verileri Katkıda Bulunanı Azure rolüne sahip çalışma alanına erişimi olmalıdır.

• Yüklenecek yeni bir tablo oluşturuyorsanız COPY deyimini ve Tablo Oluştur izinlerini kullanmak için gerekli izinlere sahip olmanız gerekir.

• Data Lake Storage 2. Nesil hesabıyla ilişkilendirilmiş bağlı hizmetin yüklenecek dosya veya klasöre erişimi olmalıdır . Örneğin, bağlı hizmetin kimlik doğrulama mekanizması yönetilen bir kimlikse, çalışma alanının yönetilen kimliğinin depolama hesabında en azından "Depolama Blob Verisi Okuyucu" iznine sahip olması gerekir.

• Çalışma alanınızda bir sanal ağ etkinleştirildiyse Data Lake Storage 2. Nesil hesabının kaynak veriler ve hata dosyası konumu için bağlı hizmetleriyle ilişkilendirilmiş tümleşik çalışma zamanının etkileşimli yazma özelliğinin etkinleştirildiğinden emin olun. Otomatik şema algılama, kaynak dosya içeriğini önizleme ve sihirbazda Data Lake Storage 2. Nesil depolama hesaplarına göz atma için etkileşimli yazma gereklidir.

Adımlar

1. Kaynak depolama konumu panelinde depolama hesabını ve yüklemekte olduğunuz dosyayı veya klasörü seçin. Sihirbaz, dosyadaki kaynak alanları uygun hedef SQL veri türlerine eşleme de dahil olmak üzere Parquet dosyalarını ve sınırlandırılmış metin (CSV) dosyalarını otomatik olarak algılamaya çalışır.

   

2. Toplu yükleme işlemi sırasında reddedilen satırlar olduğunda hata ayarlarınız da dahil olmak üzere dosya biçimi ayarlarını seçin. Copy deyiminin dosya biçimi ayarlarını yapılandırmanıza yardımcı olması için dosyayı nasıl ayrıştıracağını görmek için Önizleme verileri'ni de seçebilirsiniz. COPY deyiminin güncelleştirilmiş ayarla dosyayı nasıl ayrıştıracağını görmek için, dosya biçimi ayarını her değiştirdiğinizde Verileri önizle'yi seçin.

   

   Uyarı

   • Toplu Yükleme sihirbazı, çok karakterli alan sonlandırıcıları kullanılarak verilerin önizlemesini desteklemez. Çok karakterli bir alan sonlandırıcı belirttiğinizde, sihirbaz verilerin önizlemesini tek bir sütunda yapar.
   • Sütun adlarını çıkar seçeneğini seçtiğinizde, Toplu Yükleme sihirbazı İlk satır alanında belirtilen ilk satırdan sütun adlarını ayrıştıracaktır. Toplu Yükleme sihirbazı, COPY deyimindeki FIRSTROW değerini bu üst bilgi satırını yoksaymak için otomatik olarak 1 artırır.
   • COPY ifadesinde çok karakterli satır sonlandırıcılarının belirtilmesi desteklenir. Ancak Toplu Yükleme sihirbazı bunu desteklemez ve bir hata verir.

3. Yükün mevcut bir tabloya mı yoksa yeni bir tabloya mı ait olacağı da dahil olmak üzere yüklemek için kullandığınız ayrılmış SQL havuzunu seçin.

4. Uygun sütun eşlemesine sahip olduğunuzdan emin olmak için Sütun eşlemesini yapılandır'ı seçin. Çıkarım sütun adlarını etkinleştirdiyseniz, not sütun adları otomatik olarak algılanır. Yeni tablolar için sütun eşlemesini yapılandırmak, hedef sütun veri türlerini güncelleştirmek için kritik öneme sahiptir.

   Sütun eşlemesini yapılandırmayı gösteren ekran görüntüsü.

5. Komut dosyasını aç seçeneğine tıklayın. Veri gölünüzden yükleme yapmak için COPY deyiminin kullanıldığı bir T-SQL betiği oluşturulur.

Sonraki adımlar

• COPY özellikleri hakkında daha fazla bilgi için COPY deyimi makalesine bakın.
• Ayıklama, dönüştürme ve yükleme (ETL) işlemi kullanma hakkında bilgi için veri yüklemeye genel bakış makalesine bakın.