Azure depolamadan veri alma

Bu makalede, Azure depolamadan (ADLS 2. Nesil kapsayıcısı, blob kapsayıcısı veya tek tek bloblar) yeni veya mevcut bir tabloya veri almayı öğreneceksiniz.

Önkoşullar

Source

  1. KQL veritabanınızın alt şeridinde Veri Al'ı seçin.

    Veri al penceresinde Kaynak sekmesi seçilidir.

  2. Kullanılabilir listeden veri kaynağını seçin. Bu örnekte, Azure depolamadan veri alırsınız.

    Screenshot of get data window with source tab selected.

Yapılandırma

  1. Bir hedef tablo seçin. Yeni bir tabloya veri almak istiyorsanız + Yeni tablo'yu seçin ve bir tablo adı girin.

    Dekont

    Tablo adları boşluk, alfasayısal, kısa çizgi ve alt çizgi gibi en fazla 1024 karakter olabilir. Özel karakterler desteklenmez.

  2. Veri kaynağınızı eklemek için depolama bağlantı dizesi URI alanına yapıştırın ve ardından öğesini seçin+. Aşağıdaki tabloda desteklenen kimlik doğrulama yöntemleri ve Azure depolamadan veri almak için gereken izinler listelenmektedir.

    Kimlik doğrulama yöntemi Tek tek blob Blob kapsayıcı Azure Data Lake Storage 2. Nesil
    Paylaşılan Erişim (SAS) belirteci Okuma ve Yazma Okuma ve Listeleme Okuma ve Listeleme
    hesap erişim anahtarını Depolama

    Dekont

    • Tek tek en fazla 10 blob ekleyebilir veya tek bir kapsayıcıdan en fazla 5000 blob alabilirsiniz. İkisini de aynı anda alamazsınız.
    • Her blob sıkıştırılmamış en fazla 1 GB olabilir.
    1. Blob kapsayıcısı veya Azure Data Lake Storage 2. Nesil için bir bağlantı dizesi yapıştırdıysanız, aşağıdaki isteğe bağlı filtreleri ekleyebilirsiniz:

      Screenshot of configure tab with new table entered and one sample data file selected.

      Ayar Alan açıklaması
      Dosya filtreleri (isteğe bağlı)
      Folder path Belirli bir klasör yoluna sahip dosyaları almak için verileri filtreler.
      Dosya uzantısı Yalnızca belirli bir dosya uzantısına sahip dosyaları almak için verileri filtreler.
  3. İleri'yi seçin

İncele

İncele sekmesi açılır ve verilerin önizlemesi görüntülenir.

Alma işlemini tamamlamak için Son'u seçin.

Screenshot of the inspect tab.

İsteğe bağlı olarak:

  • Girdilerinizden oluşturulan otomatik komutları görüntülemek ve kopyalamak için Komut görüntüleyicisi'ni seçin.
  • Şemanın çıkarıldığını dosyayı değiştirmek için Şema tanımı dosyası açılan listesini kullanın.
  • Açılan listeden istediğiniz biçimi seçerek otomatik olarak çıkarılan veri biçimini değiştirin. Daha fazla bilgi için bkz . Gerçek Zamanlı Analiz tarafından desteklenen veri biçimleri.
  • Sütunları düzenleyin.
  • Veri türüne göre gelişmiş seçenekleri keşfedin.

Sütunları düzenle

Dekont

  • Tablosal biçimler (CSV, TSV, PSV) için bir sütunu iki kez eşleyemezsiniz. Var olan bir sütuna eşlemek için önce yeni sütunu silin.
  • Var olan bir sütun türünü değiştiremezsiniz. Farklı biçime sahip bir sütuna eşlemeye çalışırsanız, boş sütunlarla karşılaşabilirsiniz.

Tabloda yapabileceğiniz değişiklikler aşağıdaki parametrelere bağlıdır:

  • Tablo türü yeni veya var
  • Eşleme türü yeni veya var
Tablo türü Eşleme türü Kullanılabilir ayarlamalar
Yeni tablo Yeni eşleme Sütunu yeniden adlandırma, veri türünü değiştirme, veri kaynağını değiştirme, eşleme dönüştürme, sütun ekleme, sütunu silme
Varolan tablo Yeni eşleme Sütun ekleme (daha sonra veri türünü değiştirebileceğiniz, yeniden adlandırabileceğiniz ve güncelleştirebileceğiniz)
Varolan tablo Mevcut eşleme yok

Screenshot of columns open for editing.

Eşleme dönüştürmeleri

Bazı veri biçimi eşlemeleri (Parquet, JSON ve Avro) basit alma zamanı dönüştürmelerini destekler. Eşleme dönüştürmelerini uygulamak için Sütunları düzenle penceresinde bir sütun oluşturun veya güncelleştirin.

Eşleme dönüştürmeleri, kaynağın veri türü int veya long olan dize veya datetime türünde bir sütun üzerinde gerçekleştirilebilir. Desteklenen eşleme dönüştürmeleri şunlardır:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Veri türüne göre gelişmiş seçenekler

Tablosal (CSV, TSV, PSV):

  • Mevcut bir tablodaki tablo biçimlerini alırsanız Gelişmiş>Tablo şemasını koru'yu seçebilirsiniz. Tablosal veriler, kaynak verileri mevcut sütunlara eşlemek için kullanılan sütun adlarını içermesi gerekmez. Bu seçenek işaretlendiğinde eşleme sırasıyla yapılır ve tablo şeması aynı kalır. Bu seçenek işaretlenmemişse, veri yapısından bağımsız olarak gelen veriler için yeni sütunlar oluşturulur.

  • İlk satırı sütun adı olarak kullanmak için Gelişmiş>İlk satır sütun başlığı'nı seçin.

    Screenshot of advanced CSV options.

JSON:

  • JSON verilerinin sütun bölmesini belirlemek için 1 ile 100 arasındaki Gelişmiş>İç İçe Düzeyler'i seçin.

  • Hata içeren Gelişmiş>JSON satırlarını atla'yı seçerseniz, veriler JSON biçiminde alır. Bu onay kutusunu seçili bırakmazsanız, veriler çok kanallı biçimde alınıyor.

    Screenshot of advanced JSON options.

Özet

Veri hazırlama penceresinde, veri alımı başarıyla tamamlandığında üç adım da yeşil onay işaretleri ile işaretlenir. Sorgulamak için bir kart seçebilir, alınan verileri bırakabilir veya alma özetinizin bir panosunu görebilirsiniz.

Screenshot of summary page with successful ingestion completed.