Azure Data Lake Storage'de Common Data Model tablolarına bağlanma

Makale
03/11/2024

Not

Azure Active Directory artık Microsoft Entra ID. Daha fazla bilgi edinin

Common Data Model tablolarıyla Azure Data Lake Storage hesabınızı kullanarak Dynamics 365 Customer Insights - Data'ya veri alın. Veri alımı tam veya artımlı olabilir.

Önkoşullar

Azure Data Lake Storage hesabında hiyerarşik ad alanı etkin olmalıdır. Veriler, kök klasörü tanımlayan ve her tablo için alt klasörleri olan hiyerarşik bir klasör biçiminde saklanmalıdır. Alt klasörler, tam veri veya artımlı veri klasörlerine sahip olabilir.
Microsoft Entra hizmet sorumlusuyla kimlik doğrulaması yapmak için kiracınızda yapılandırıldığından emin olun. Daha fazla bilgi için bkz. Azure Data Lake Storage hesabına Microsoft Entra hizmet sorumlusuyla bağlanma.
Bağlanmak ve verileri almak istediğiniz Azure Data Lake Storage, Dynamics 365 Customer Insights ortamıyla aynı Azure bölgesinde ve abonelikler aynı kiracıda olmalıdır. Farklı bir Azure bölgesindeki bir veri gölünden Common Data Model klasörüne bağlantılar desteklenmez. Ortamın Azure bölgesini öğrenmek için Customer Insights - Data'da Ayarlar>Sistem>Hakkında bölümüne gidin.
Çevrimiçi hizmetlerde depolanan veriler, verilerin işlendiği veya depolandığı konumdan farklı bir konumda depolanabilir. Çevrimiçi hizmetlerde depolanan verileri içeri aktararak veya verilere bağlanarak, verilerin aktarılabileceğini kabul edersiniz. Microsoft Güven Merkezi'nde daha fazla bilgi edinin.
Customer Insights - Data hizmet sorumlusu, depolama hesabına erişmek için aşağıdaki rollerden birinde olmalıdır. Daha fazla bilgi için bkz. Hizmet sorumlusuna depolama hesabına erişim izinleri atama.
- Depolama Blobu Veri Okuyucusu
- Depolama Blobu Veri Sahibi
- Depolama Blobu Veri Katılımcısı
Azure aboneliği seçeneğini kullanarak Azure depolama alanınıza bağlanırken veri kaynağı bağlantısını kuran kullanıcının, depolama hesabında en azından Depolama Blobu Verileri katılımcı izinlerine ihtiyacı vardır.
Azure aboneliği seçeneğini kullanarak Azure depolama alanınıza bağlanırken veri kaynağı bağlantısını kuran kullanıcının, depolama hesabında en azından Microsoft.Storage/storageAccounts/read eylemi için izne ihtiyacı vardır. Bu eylemi içeren bir Azure yerleşik rolü, Okuyucu rolüdür. Erişimi yalnızca gerekli eylemle sınırlamak için yalnızca bu eylemi içerenbir Azure özel rolü oluşturun.
En iyi performansı elde edebilmek için, bölümün boyutu 1 GB veya daha küçük olmalı ve bir klasördeki bölüm dosyalarının sayısı 1000'i aşmamalıdır.
Data Lake Storage'inizdeki veriler, verilerinizin depolanması için Common Data Model standardını izlemeli ve veri dosyalarının (*.csv veya *.parquet) şemasını temsil etmek için ortak veri modeli bildirimine sahip olmalıdır. Bildirim, tablo sütunları ve veri türleri gibi tabloların ayrıntılarının yanı sıra veri dosyası konumu ve dosya türü sağlamalıdır. Daha fazla bilgi için bkz. Common Data Model bildirimi. Bildirim yoksa, Depolama Blobu Veri Sahibi veya Depolama Blobu Veri Katılımcısı erişimi olan Yönetici kullanıcılar, verileri alırken şemayı tanımlayabilir.

Not

.parquet dosyalarındaki alanların herhangi birisinde Int96 veri türü varsa bu veriler, Tablolar sayfasında görüntülenmez. Unix zaman damgası biçimi (1 Ocak 1970, UTC gece yarısından itibaren zamanı saniye olarak gösterir) gibi standart veri türlerini kullanmanızı öneririz.

Sınırlamalar

Customer Insights - Data, 16'dan büyük hassasiyete sahip ondalık türdeki sütunları desteklemez.

Azure Data Lake Storage'a bağlanma

Veri>Veri kaynakları öğesine gidin.
Veri kaynağı ekle'yi seçin.
Azure Data Lake Common Data Model tabloları'nı seçin.
Veri kaynağı adı ve isteğe bağlı bir Açıklama girin. Ada aşağı akış işlemlerinde başvurulur ve veri kaynağı oluşturulduktan sonra değiştirilemez.
Depolama hesabınızı şunu kullanarak bağlayın: için aşağıdaki seçeneklerden birini belirleyin. Daha fazla bilgi için bkz. Azure Data Lake Storage hesabına Microsoft Entra hizmet sorumlusuyla bağlanma.
- Azure kaynağı: Kaynak Kimliği'ni girin. (private-link.md).
- Azure aboneliği: Abonelik'i ve ardından Kaynak grubu ve Depolama hesabı'nı seçin.
Not

Veri kaynağı oluşturmak için kapsayıcıda aşağıdaki rollerden birine ihtiyacınız vardır:
- Depolama Blob'u Veri Okuyucu, bir depolama hesabından veri okumak ve Customer Insights - Data'ya veri almak için yeterlidir.
- Depolama Blob'u Veri Katılımcısı veya Sahibi, bildirim dosyalarını doğrudan Customer Insights - Data'da düzenlemek istiyorsanız gereklidir.
Depolama hesabında role sahip olmak, tüm kapsayıcılarda aynı rolü sağlayacaktır.
İsteğe bağlı olarak, bir Azure Özel Bağlantı aracılığıyla bir depolama hesabından veri almak istiyorsanız Özel Bağlantıyı Etkinleştir'i seçin. Daha fazla bilgi için bkz. Özel Bağlantılar.
Verileri içe aktarmak için verileri ve şemayı (model.json veya manifest.json dosyası) içeren Kapsayıcı'nın adını ve İleri'yi seçin.

Not

Ortamda başka bir veri kaynağıyla ilişkilendirilmiş model.json veya manifest.json dosyaları, listede görüntülenmez. Ancak aynı model.json veya manifest.json dosyası birden çok ortamda veri kaynakları için kullanılabilir.
Yeni bir şema oluşturmak için Yeni bir şema dosyası oluşturma bölümüne gidin.
Mevcut bir şemayı kullanmak için model.json veya manifest.cdm.json dosyasını içeren klasöre gidin. Dosyayı bulmak için bir dizinde arama yapabilirsiniz.
json dosyasını ve İleri'yi seçin. Kullanılabilir tabloların bir listesi görüntülenir.
Dahil edilecek tabloları seçin.

İpucu

Bir JSON düzenleme arabirimindeki bir tabloyu düzenlemek için tabloyu ve ardından Şema dosyasını düzenle'yi seçin. Değişiklikleri yapın ve Kaydet'i seçin.
Artımlı alım gerektiren seçili tablolar için Artımlı yenileme altında Gerekli görüntülenir. Bu tabloların her biri için bkz. Azure Data Lake veri kaynakları için artımlı yenilemeyi yapılandırma.
Birincil anahtarın tanımlanmadığı seçili tablolar için Birincil anahtar altında Gerekli görüntülenir. Bu tabloların her biri için:
1. Gerekli'yi seçin. Tabloyu düzenle paneli görüntülenir.
2. Birincil anahtar'ı seçin. Birincil anahtar, tabloya özgü bir özniteliktir. Bir özniteliğin geçerli bir birincil anahtar olması için yinelenen değerler, eksik değerler veya null değerler içermemesi gerekir. Dize, tamsayı ve GUID veri türü öznitelikleri, birincil anahtarlar olarak desteklenmektedir.
3. İsteğe bağlı olarak, bölüm desenini değiştirin.
4. Paneli kaydedip kapatmak için Kapat'ı seçin.
Dahil edilen her tablo için Sütun sayısını seçin. Öznitelikleri yönet sayfası görüntülenir.
1. Yeni sütunlar oluşturun, mevcut sütunları düzenleyin veya silin. Adı ve veri biçimini değiştirebilir veya anlamsal bir tür ekleyebilirsiniz.
2. Analizleri ve diğer özellikleri etkinleştirmek için tam tablo veya belirli sütunlar için Veri profili oluşturma'yı seçin. Varsayılan olarak, veri profili oluşturmak için tablo etkinleştirilmez.
3. Bitti'yi seçin.
Kaydet'i seçin. Yeni veri kaynağını Yenileniyor durumunda gösteren Veri kaynakları sayfası açılır.

Bahşiş

Görevler ve işlemlerin durumları vardır. Çoğu işlem, veri kaynakları ve veri profili yenilemeleri gibi yukarı akış yönündeki işlemlere bağlıdır.

İlerleme ayrıntıları bölmesini açmak ve görevlerin ilerlemesini görüntülemek için durumu seçin. İşi iptal etmek için bölmenin alt kısmında İşi iptal et seçeneğini belirleyin.

Her görevin altında işleme süresi, son işleme tarihi ve görevle veya işlemle ilişkili herhangi bir ilgili hata ve uyarı gibi daha fazla ilerleme durumu bilgisi için Ayrıntıları görüntüle'yi seçebilirsiniz. Sistemdeki diğer işlemleri görmek için panelin alt kısmında Sistem durumunu görüntüle'yi seçin.

Verilerin yüklenmesi zaman alabilir. Başarılı bir yenilemeden sonra alınan veriler, Tablolar sayfasından incelenebilir.

Yeni bir şema dosyası oluşturma

Şema dosyası oluştur'u seçin.
Dosya için bir ad girin ve Kaydet'i seçin.
Yeni tablo'yu seçin. Yeni Tablo paneli görüntülenir.
Tablo adını girin ve Veri dosyalarının konumu'nu seçin.
- Birden çok .csv veya .parquet dosyası: Kök klasöre göz atın, desen türünü seçin ve ifadeyi girin.
- Tek .csv veya .parquet dosyaları: .csv veya .parquet dosyasına göz atın ve dosyayı seçin.
Kaydet'i seçin.
Öznitelikleri manuel olarak eklemek için öznitelikleri tanımla'yı seçin veya otomatik oluştur'u seçin. Öznitelikleri tanımlamak için bir ad girin, veri biçimini ve isteğe bağlı semantik türünü seçin. Otomatik oluşturulan öznitelikler için:
1. Öznitelikler otomatik olarak oluşturulduktan sonra İnceleme öznitelikleri'ni seçin. Öznitelikleri yönet sayfası görüntülenir.
2. Her öznitelik için veri biçiminin doğru olduğundan emin olun.
3. Analizleri ve diğer özellikleri etkinleştirmek için tam tablo veya belirli sütunlar için Veri profili oluşturma'yı seçin. Varsayılan olarak, veri profili oluşturmak için tablo etkinleştirilmez.
4. Bitti'yi seçin. Tabloları seç sayfası görüntülenir.
Varsa, tablolar ve sütunlar eklemeye devam edin.
Tüm tablolar eklendikten sonra, tabloları veri kaynağı alımına dahil etmek için Ekle'yi seçin.
Artımlı alım gerektiren seçili tablolar için Artımlı yenileme altında Gerekli görüntülenir. Bu tabloların her biri için bkz. Azure Data Lake veri kaynakları için artımlı yenilemeyi yapılandırma.
Birincil anahtarın tanımlanmadığı seçili tablolar için Birincil anahtar altında Gerekli görüntülenir. Bu tabloların her biri için:
1. Gerekli'yi seçin. Tabloyu düzenle paneli görüntülenir.
2. Birincil anahtar'ı seçin. Birincil anahtar, tabloya özgü bir özniteliktir. Bir özniteliğin geçerli bir birincil anahtar olması için yinelenen değerler, eksik değerler veya null değerler içermemesi gerekir. Dize, tamsayı ve GUID veri türü öznitelikleri, birincil anahtarlar olarak desteklenmektedir.
3. İsteğe bağlı olarak, bölüm desenini değiştirin.
4. Paneli kaydedip kapatmak için Kapat'ı seçin.
Kaydet'i seçin. Yeni veri kaynağını Yenileniyor durumunda gösteren Veri kaynakları sayfası açılır.

Bahşiş

Görevler ve işlemlerin durumları vardır. Çoğu işlem, veri kaynakları ve veri profili yenilemeleri gibi yukarı akış yönündeki işlemlere bağlıdır.

İlerleme ayrıntıları bölmesini açmak ve görevlerin ilerlemesini görüntülemek için durumu seçin. İşi iptal etmek için bölmenin alt kısmında İşi iptal et seçeneğini belirleyin.

Her görevin altında işleme süresi, son işleme tarihi ve görevle veya işlemle ilişkili herhangi bir ilgili hata ve uyarı gibi daha fazla ilerleme durumu bilgisi için Ayrıntıları görüntüle'yi seçebilirsiniz. Sistemdeki diğer işlemleri görmek için panelin alt kısmında Sistem durumunu görüntüle'yi seçin.

Verilerin yüklenmesi zaman alabilir. Başarılı bir yenilemeden sonra alınan veriler Veri>Tablolar sayfasından incelenebilir.

Azure Data Lake Storage veri kaynağını düzenleme

Depolama hesabınızı şunu kullanarak bağlayın: seçeneğini güncelleştirebilirsiniz. Daha fazla bilgi için bkz. Azure Data Lake Storage hesabına Microsoft Entra hizmet sorumlusuyla bağlanma. Depolama hesabınızdan farklı bir kapsayıcıya bağlanmak veya firma adını değiştirmek için yeni bir veri kaynağı bağlantısı oluşturun.

Veri>Veri kaynakları öğesine gidin. Güncelleştirmek istediğiniz veri kaynağının yanında Düzenle'yi seçin.
Aşağıdaki bilgilerden birini değiştirin:
- Tanım
- Depolama hesabınızı şunu kullanarak bağlayın: ve bağlantı bilgileri. Bağlantıyı güncelleştirdiğinizde Kapsayıcı bilgilerini değiştiremezsiniz.
  Not
  
  Depolama hesabına veya kapsayıcıya aşağıdaki rollerden biri atanmalıdır:
  - Depolama Blobu Veri Okuyucusu
  - Depolama Blobu Veri Sahibi
  - Depolama Blobu Veri Katılımcısı
- Azure Data Lake Storage ile Azure için yönetilen kimlikler kullanma ???
- Azure Özel Bağlantı aracılığıyla bir depolama hesabından veri almak istiyorsanız Özel Bağlantıyı Etkinleştir'i seçin. Daha fazla bilgi için bkz. Özel Bağlantılar.
İleri'yi seçin.
Aşağıdakilerden birini değiştirin:
- Kapsayıcıdan farklı bir tablo kümesine sahip farklı bir model.json veya manifest.json dosyasına gidin.
- Alınacak ek tablolar eklemek için Yeni tablo'yu seçin.
- Bağımlılık yoksa önceden seçilmiş tabloları kaldırmak için tabloyu seçin ve Sil'i seçin.
  
  Önemli
  
  Mevcut model.json veya manifest.json dosyasında ve tablo kümesinde bağımlılıklar varsa bir hata iletisi görürsünüz ve farklı bir model.json veya manifest.json dosyası seçemezsiniz. model.json veya manifest.json dosyasını değiştirmeden önce bu bağımlılıkları kaldırın veya bağımlılıkları kaldırmaktan kaçınmak için kullanmak istediğiniz model.json veya manifest.json dosyasıyla yeni bir veri kaynağı oluşturun.
- Veri dosyası konumunu veya birincil anahtarı değiştirmek için Düzenle'yi seçin.
- Artımlı alım verilerini değiştirmek için bkz. Azure Data Lake veri kaynakları için artımlı yenilemeyi yapılandırma.
- Tablo adını yalnızca .json dosyasındaki tablo adıyla eşleşecek şekilde değiştirin.
  
  Not
  
  Tablo adını her zaman, almadan sonra model.json veya manifest.json dosyasındaki tablo adıyla aynı şekilde tutun. Customer Insights - Data, her sistem yenilemesi sırasında tüm tablo adlarını model.json veya manifest.json ile doğrular. Tablo adı değişirse, Customer Insights - Data .json dosyasında yeni tablo adını bulunamadığından bir hata oluşur. Alınan bir tablo adı yanlışlıkla değiştirilirse, tablo adını .json dosyasındaki adla eşleşecek şekilde düzenleyin.
Sütunları eklemek, değiştirmek veya veri profili oluşturmayı etkinleştirmek için Sütunlar'ı seçin. Ardından Bitti'yi seçin.
Değişikliklerinizi uygulamak ve Veri kaynakları sayfasına dönmek için Kaydet'i seçin.

Bahşiş

Görevler ve işlemlerin durumları vardır. Çoğu işlem, veri kaynakları ve veri profili yenilemeleri gibi yukarı akış yönündeki işlemlere bağlıdır.

İlerleme ayrıntıları bölmesini açmak ve görevlerin ilerlemesini görüntülemek için durumu seçin. İşi iptal etmek için bölmenin alt kısmında İşi iptal et seçeneğini belirleyin.

Her görevin altında işleme süresi, son işleme tarihi ve görevle veya işlemle ilişkili herhangi bir ilgili hata ve uyarı gibi daha fazla ilerleme durumu bilgisi için Ayrıntıları görüntüle'yi seçebilirsiniz. Sistemdeki diğer işlemleri görmek için panelin alt kısmında Sistem durumunu görüntüle'yi seçin.

Aracılığıyla paylaş