Azure Data Factory'de kaynak denetimi

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Varsayılan olarak, Azure Data Factory kullanıcı arabirimi deneyimi (UX) doğrudan veri fabrikası hizmetine karşı yazar. Bu deneyim aşağıdaki sınırlamalara sahiptir:

  • Data Factory hizmeti, değişiklikleriniz için JSON varlıklarını depolamak için bir depo içermez. Değişiklikleri kaydetmenin tek yolu Tümünü Yayımla düğmesini kullanmaktır ve tüm değişiklikler doğrudan veri fabrikası hizmetinde yayımlanır.
  • Data Factory hizmeti işbirliği ve sürüm denetimi için iyileştirilmemiş.
  • Data Factory'yi dağıtmak için gereken Azure Resource Manager şablonu dahil değildir.

Daha iyi bir yazma deneyimi sağlamak için Azure Data Factory, Azure Repos veya GitHub ile bir Git deposu yapılandırmanıza olanak tanır. Git değişiklik izlemeyi ve işbirliğini kolaylaştıran bir sürüm denetimi sistemidir. Bu makalede, en iyi yöntemleri ve sorun giderme kılavuzunu vurgulamanın yanı sıra git deposunda yapılandırma ve çalışma adımları açıklanmaktadır.

Kaynak denetiminin kritik öneme sahip olduğu daha büyük CI/CD deseni hakkında daha fazla bilgi edinmek için Azure Data Factory'de Sürekli tümleştirme ve teslime (CI/CD) de başvurabilirsiniz.

Not

21Vianet tarafından sağlanan Azure Gov ve Microsoft Azure'da GitHub genel desteği ekledik. Duyuru bloguna bakın.

Azure Data Factory'nin Git ile tümleştirmesi hakkında daha fazla bilgi edinmek için aşağıdaki 15 dakikalık öğretici videosunu izleyin:

Git tümleştirmesinin avantajları

Git tümleştirmesinin yazma deneyimine sağladığı avantajlardan bazılarının listesi aşağıdadır:

  • Kaynak denetimi: Veri fabrikası iş yükleriniz önemli hale geldikçe aşağıdaki gibi çeşitli kaynak denetimi avantajları uygulamak için fabrikanızı Git ile tümleştirmek isteyebilirsiniz:
    • Değişiklikleri izleme/denetleme olanağı.
    • Hatalara neden olan değişiklikleri geri döndürme olanağı.
  • Kısmi kaydetmeler: Veri fabrikası hizmetinde yazma yaparken değişiklikleri taslak olarak kaydedemezsiniz ve tüm yayımlamaların veri fabrikası doğrulamasını geçirmesi gerekir. İşlem hatlarınızın tamamlanmamış olması veya bilgisayarınızın kilitlenmesi durumunda değişiklikleri kaybetmek istemeniz fark etmeksizin git tümleştirmesi, veri fabrikası kaynaklarının hangi durumda olduğuna bakılmaksızın artımlı değişikliklere olanak tanır. Git deposunu yapılandırmak, değişiklikleri kaydetmenize olanak tanır ve yalnızca değişikliklerinizi kendi memnuniyetinize göre test ettikten sonra yayımlamanıza olanak tanır.
  • İşbirliği ve denetim: Aynı fabrikaya katkıda bulunan birden çok ekip üyeniz varsa, ekip arkadaşlarınızın bir kod gözden geçirme işlemi aracılığıyla birbirleriyle işbirliği yapmasına izin vermek isteyebilirsiniz. Ayrıca fabrikanızı her katkıda bulunan eşit izinlere sahip olmayacak şekilde ayarlayabilirsiniz. Bazı ekip üyelerinin yalnızca Git aracılığıyla değişiklik yapmasına ve yalnızca ekipteki belirli kişilerin değişiklikleri fabrikada yayımlamasına izin verilir.
  • Daha iyi CI/CD: Sürekli teslim işlemiyle birden çok ortam dağıtıyorsanız git tümleştirmesi belirli eylemleri kolaylaştırır. Bu eylemlerden bazıları şunlardır:
    • 'dev' fabrikanızda herhangi bir değişiklik yapılır yapılmaz yayın işlem hattınızı otomatik olarak tetiklenir şekilde yapılandırın.
    • Resource Manager şablonunda parametre olarak kullanılabilen fabrikanızdaki özellikleri özelleştirin. Yalnızca gerekli özellik kümesini parametre olarak tutmak ve diğer her şeyin sabit kodlanmış olması yararlı olabilir.
  • Daha İyi Performans: Git tümleştirmesine sahip ortalama bir fabrika, veri fabrikası hizmetine karşı bir yazmadan 10 kat daha hızlı yüklenir. Bu performans geliştirmesi, kaynakların Git aracılığıyla indirilmiş olmasıdır.

Not

Git deposu yapılandırıldığında Data Factory hizmetiyle doğrudan yazma, Azure Data Factory UX'te devre dışı bırakılır. PowerShell veya SDK aracılığıyla yapılan değişiklikler doğrudan Data Factory hizmetinde yayımlanır ve Git'e girılmaz.

Git deposuna Bağlan

Git deposunu hem Azure Repos hem de GitHub için veri fabrikanıza bağlamanın dört farklı yolu vardır. Bir Git deposuna bağlandıktan sonra, kaynak denetimi bölümündeki Git yapılandırması altındaki yönetim hub'ındayapılandırmanızı görüntüleyebilir ve yönetebilirsiniz.

Yapılandırma yöntemi 1: Giriş sayfası

Azure Data Factory giriş sayfasında üstteki Kod deposunu ayarla'yı seçin.

Giriş sayfasından kod deposu yapılandırma

Yapılandırma yöntemi 2: Tuval yazma

Azure Data Factory UX yazma tuvalinde Data Factory açılan menüsünü ve ardından Kod deposunu ayarla'yı seçin.

Yazmadan kod deposu ayarlarını yapılandırma

Yapılandırma yöntemi 3: Yönetim hub'ı

Azure Data Factory Studio'da yönetim hub'ına gidin. Kaynak denetimi bölümünde Git yapılandırması'nı seçin. Bağlı deponuz yoksa Yapılandır'ı seçin.

Yönetim hub'ından kod deposu ayarlarını yapılandırma

Yapılandırma yöntemi 4: Fabrika oluşturma sırasında

Azure portalında yeni bir veri fabrikası oluştururken Git yapılandırma sekmesinde Git deposu bilgilerini yapılandırabilirsiniz.

Not

Git'i Azure Portal'da yapılandırırken, proje adı ve depo adı gibi ayarların bir açılan menü yerine el ile girilmesi gerekir.

Azure Portal'dan kod deposu ayarlarını yapılandırma

Azure Repos Git tümleştirmesi ile yazma

Azure Repos Git tümleştirmesi ile görsel yazma, veri fabrikası işlem hatlarınızda çalışmak için kaynak denetimini ve işbirliğini destekler. Veri fabrikasını kaynak denetimi, işbirliği, sürüm oluşturma vb. için bir Azure Repos Git kuruluş deposuyla ilişkilendirebilirsiniz. Tek bir Azure Repos Git kuruluşu birden çok depoya sahip olabilir, ancak bir Azure Repos Git deposu yalnızca bir veri fabrikasıyla ilişkilendirilebilir. Azure Repos kuruluşunuz veya deponuz yoksa kaynaklarınızı oluşturmak için bu yönergeleri izleyin.

Not

Betik ve veri dosyalarını bir Azure Repos Git deposunda depolayabilirsiniz. Ancak, dosyaları Azure Depolama'a el ile yüklemeniz gerekir. Veri fabrikası işlem hattı, Azure Repos Git deposunda depolanan betiği veya veri dosyalarını Azure Depolama'a otomatik olarak yüklemez. ARM şablonları, betikler veya yapılandırma dosyaları gibi ek dosyalar eşlenen klasörün dışındaki depoda depolanabilir. Bunu yaparsanız, eşlenen Azure DevOps klasörünün dışında depolanan dosyaları derlemek/dağıtmak ve bunlarla etkileşim kurmak için ek bir görev gerektiğini unutmayın.

Azure Repos ayarları

Depo yapılandırma ayarlarını gösteren ekran görüntüsü.

Yapılandırma bölmesi, aşağıdaki kod deposu ayarlarının her birini yapılandırma işleminde size adım adım yol gösterir:

Ayar Açıklama Değer
Depo Türü Azure Repos kod deposunun türü.
Azure DevOps Git veya GitHub
Microsoft Entra ID Microsoft Entra kiracınızın adı. <your tenant name>
Azure Repos Kuruluşu Azure Repos kuruluşunuzun adı. Azure Repos kuruluşunuzun adını adresinde https://{organization name}.visualstudio.combulabilirsiniz. Visual Studio profilinize erişmek ve depolarınızı ve projelerinizi görmek için Azure Repos kuruluşunuzda oturum açabilirsiniz. <your organization name>
ProjectName Azure Repos projenizin adı. Azure Repos projenizin adını adresinde https://{organization name}.visualstudio.com/{project name}bulabilirsiniz. <your Azure Repos project name>
RepositoryName Azure Repos kod deponuzun adı. Azure Repos projeleri, projeniz büyüdükçe kaynak kodunuzu yönetmek için Git depoları içerir. Yeni bir depo oluşturabilir veya projenizde zaten var olan bir depo kullanabilirsiniz. <your Azure Repos code repository name>
İşbirliği dalı Yayımlama için kullanılan Azure Repos işbirliği dalınız. Varsayılan olarak değeridir main. Kaynakları başka bir daldan yayımlamak istemeniz durumunda bu ayarı değiştirin. <your collaboration branch name>
Dal yayımlama Yayımla dalı, deponuzdaki ilgili ARM şablonlarının depolandığı ve güncelleştirildiği daldır. Varsayılan olarak değeridir adf_publish. <your publish branch name>
Kök klasör Azure Repos işbirliği dalınızdaki kök klasörünüz. <your root folder name>
Mevcut Data Factory kaynaklarını depoya aktarma Mevcut veri fabrikası kaynaklarının UX Yazma tuvalinden Azure Repos Git deposuna aktarılıp aktarılmayacağını belirtir. Veri fabrikası kaynaklarınızı JSON biçiminde ilişkili Git deposuna aktarmak için kutuyu seçin. Bu eylem her kaynağı ayrı ayrı dışarı aktarır (yani bağlı hizmetler ve veri kümeleri ayrı JSON'lara aktarılır). Bu kutu seçili olmadığında, var olan kaynaklar içeri aktarılamaz. Seçili (varsayılan)
Kaynağı içeri aktaracak dal Veri fabrikası kaynaklarının (işlem hatları, veri kümeleri, bağlı hizmetler vb.) hangi dalda içeri aktarılacağını belirtir. Kaynakları şu dallardan birine aktarabilirsiniz: a. İşbirliği b. Yeni c oluşturun. Var Olanı Kullan

Not

Microsoft Edge kullanıyorsanız ve Azure DevOps Hesabı açılan listenizde herhangi bir değer görmüyorsanız, güvenilen siteler listesine https://*.visualstudio.com ekleyin.

Depo ayarlarını düzenleme

Yapılandırılmış Azure Repos Git deponuzun ayarlarında herhangi bir ayarlama yapılması gerekiyorsa Düzenle'yi seçebilirsiniz.

Azure Repos Git deposunu düzenlemek için düzenle düğmesini gösteren ekran görüntüsü.

Yayımlama dalınızı güncelleştirebilir ve ADF studio'dan yayımla düğmesini devre dışı bırakmak isteyip istemediğinize karar vekleyebilirsiniz. Yayımla düğmesini stüdyodan devre dışı bırakmayı seçerseniz, yayımla düğmesi stüdyoda gri görünür. Bu, son otomatik yayımlama dağıtımının üzerine yazmaktan kaçınmanıza yardımcı olur.

Data Factory Studio'da yayımla düğmesini devre dışı bırakmaya yönelik onay kutusunu gösteren ekran görüntüsü.

Farklı bir Microsoft Entra kiracısı kullanma

Azure Repos Git deposu farklı bir Microsoft Entra kiracısında olabilir. Farklı bir Microsoft Entra kiracısı belirtmek için, kullandığınız Azure aboneliği için yönetici izinlerine sahip olmanız gerekir. Daha fazla bilgi için bkz . Abonelik yöneticisini değiştirme.

Önemli

Başka bir Microsoft Entra kimliğine bağlanmak için oturum açan kullanıcının bu Active Directory'nin bir parçası olması gerekir.

Kişisel Microsoft hesabınızı kullanma

Git tümleştirmesi için kişisel bir Microsoft hesabı kullanmak için, kişisel Azure Deponuzu kuruluşunuzun Active Directory'sine bağlayabilirsiniz.

  1. Kişisel Microsoft hesabınızı kuruluşunuzun Active Directory'sine konuk olarak ekleyin. Daha fazla bilgi için bkz . Azure portalında Microsoft Entra B2B işbirliği kullanıcıları ekleme.

  2. Kişisel Microsoft hesabınızla Azure portalında oturum açın. Ardından kuruluşunuzun Active Directory'sine geçin.

  3. Artık kişisel deponuzu gördüğünüz Azure DevOps bölümüne gidin. Depoyu seçin ve Active Directory'ye bağlanın.

Bu yapılandırma adımlarından sonra, Data Factory kullanıcı arabiriminde Git tümleştirmesini ayarladığınızda kişisel deponuz kullanılabilir.

Azure Repos'u kuruluşunuzun Active Directory'sine bağlama hakkında daha fazla bilgi için bkz. Azure DevOps kuruluşunuzu Microsoft Entra Id'ye Bağlan.

GitHub tümleştirmesi ile yazma

GitHub tümleştirmesi ile görsel yazma, veri fabrikası işlem hatlarınızda çalışmak için kaynak denetimini ve işbirliğini destekler. Veri fabrikasını kaynak denetimi, işbirliği ve sürüm oluşturma için gitHub hesap deposuyla ilişkilendirebilirsiniz. Tek bir GitHub hesabının birden çok deposu olabilir, ancak bir GitHub deposu yalnızca bir veri fabrikasıyla ilişkilendirilebilir. GitHub hesabınız veya deponuz yoksa kaynaklarınızı oluşturmak için bu yönergeleri izleyin.

Data Factory ile GitHub tümleştirmesi hem genel GitHub 'ı (yani https://github.com), GitHub Enterprise Cloud'ı hem de GitHub Enterprise Server'ı destekler. GitHub'daki depoyu okuma ve yazma izniniz olduğu sürece Data Factory ile hem genel hem de özel GitHub depolarını kullanabilirsiniz. Ortak bir depoya bağlanmak için, Depo adı açılan menüsünde görünmedikleri için Bağlantı Deposunu Kullan seçeneğini belirleyin. ADF'nin GitHub kurumsal sunucu tümleştirmesi yalnızca GitHub kurumsal sunucusunun resmi olarak desteklenen sürümleriyle çalışır.

GitHub kuruluş hesabına ait depolar için yöneticinin ADF uygulamasını yetkilendirmesi gerekir. GitHub kullanıcı hesabına ait depolar için, en az ortak çalışma iznine sahip bir kullanıcı ADF uygulamasını yetkilendirebilir. Bu izin, ADF uygulamasına hesabın/kuruluşun sahip olduğu tüm depolara doğrudan erişim vermez, yalnızca ADF uygulamasının kullanıcının erişim izinlerine göre depolara erişmek için kullanıcı adına hareket etmesine izin verir.

Not

Microsoft Edge kullanıyorsanız, 2.1.4'ten küçük GitHub Enterprise sürümü bu sürümle çalışmaz. GitHub resmi olarak =3.0'ı destekler >ve bunların hepsi ADF için uygun olmalıdır. GitHub en düşük sürümünü değiştirdikçe, ADF tarafından desteklenen sürümler de değişir.

GitHub ayarları

 GitHub Depo yapılandırma bölmesini gösteren ekran görüntüsü.

GitHub Kurumsal sunucu kullanarak depo yapılandırma bölmesini gösteren ekran görüntüsü.

GitHub depo ayarları

Yapılandırma bölmesinde aşağıdaki GitHub deposu ayarları gösterilir:

Ayar Açıklama Value
Depo Türü Azure Repos kod deposunun türü. GitHub
GitHub Enterprise Server kullanma GitHub Enterprise Server'ı seçmek için onay kutusu. seçilmemiş (varsayılan)
GitHub Enterprise Server URL'si GitHub Enterprise kök URL'si (yerel GitHub Enterprise sunucusu için HTTPS olmalıdır). Örneğin: https://github.mydomain.com. Yalnızca GitHub Enterprise Server kullan seçiliyse gereklidir <your GitHub Enterprise Server URL>
GitHub deposunun sahibi Deponun sahibi olan GitHub kuruluşu veya hesabı. Bu ad name} öğesinden https://github.com/{owner}/{repository bulunabilir. Bu sayfaya gitmek, GitHub kuruluşunuza veya hesabınıza GitHub OAuth kimlik bilgilerini girmenizi ister. GitHub Enterprise Server kullan'ı seçerseniz erişim belirtecinizi girmenize izin verecek bir iletişim kutusu görüntülenir. <your GitHub repository owner name>
Depo Adı GitHub kod deponuzun adı. GitHub hesapları, kaynak kodunuzu yönetmek için Git depoları içerir. Yeni bir depo oluşturabilir veya hesabınızda zaten var olan bir depo kullanabilirsiniz. Depo seç'i seçtiğinizde GitHub kod deponuzun adını belirtin. <your repository name>
Git deposu bağlantısı GitHub kod deponuz bağlantısı. Depo bağlantısını kullan'ı seçtiğinizde GitHub kod deposu bağlantınızı belirtin. <your repository link>
İşbirliği dalı Yayımlama için kullanılan GitHub işbirliği dalınız. Varsayılan olarak ana değerdir. Kaynakları başka bir daldan yayımlamak istemeniz durumunda bu ayarı değiştirin. Burada yeni bir işbirliği dalı da oluşturabilirsiniz. <your collaboration branch>
Dal yayımlama Deponuzda yayımlamayla ilgili ARM şablonlarının depolandığı ve güncelleştirildiği dal. <your publish branch name>
Kök klasör GitHub işbirliği dalınızdaki kök klasörünüz. <your root folder name>
Mevcut kaynakları depoya aktarma Var olan veri fabrikası kaynaklarının UX yazma tuvalinden GitHub deposuna aktarılıp aktarılmayacağını belirtir. Veri fabrikası kaynaklarınızı JSON biçiminde ilişkili Git deposuna aktarmak için kutuyu seçin. Bu eylem her kaynağı ayrı ayrı dışarı aktarır (yani bağlı hizmetler ve veri kümeleri ayrı JSON'lara aktarılır). Bu kutu seçili olmadığında, var olan kaynaklar içeri aktarılamaz. Seçili (varsayılan)
Kaynağı bu dala aktar Veri fabrikası kaynaklarının (işlem hatları, veri kümeleri, bağlı hizmetler vb.) hangi dalda içeri aktarılacağını belirtir.

Depo ayarlarını düzenleme

Yapılandırılmış GitHub deponuzun ayarlarında herhangi bir ayarlama yapılması gerekiyorsa Düzenle'yi seçebilirsiniz.

GitHub deposunu düzenlemek için düzenle düğmesini gösteren ekran görüntüsü.

Yayımlama dalınızı güncelleştirebilir ve ADF studio'dan yayımla düğmesini devre dışı bırakmak isteyip istemediğinize karar vekleyebilirsiniz. Yayımla düğmesini stüdyodan devre dışı bırakmayı seçerseniz, yayımla düğmesi stüdyoda gri görünür. Bu, son otomatik yayımlama dağıtımının üzerine yazılmasını önlemeye yardımcı olur.

Azure Data Factory studio için yayımla düğmesini devre dışı bırakmaya yönelik onay kutusunu gösteren ekran görüntüsü.

GitHub kuruluşları

GitHub kuruluşuna Bağlan için kuruluşun Azure Data Factory'ye izin vermesi gerekir. Kuruluşta YÖNETICI izinlerine sahip bir kullanıcı, data factory'nin bağlanmasına izin vermek için aşağıdaki adımları gerçekleştirmelidir.

Azure Data Factory'de ilk kez genel GitHub veya GitHub Enterprise Cloud'a Bağlan

Azure Data Factory'den genel GitHub veya GitHub Enterprise Cloud'a ilk kez bağlanıyorsanız, github kuruluşuna bağlanmak için bu adımları izleyin.

  1. Git yapılandırma bölmesinde, GitHub Hesabı alanına kuruluş adını girin. GitHub'da oturum açma istemi görüntülenir.
  2. Kullanıcı kimlik bilgilerinizi kullanarak oturum açın.
  3. Azure Data Factory'yi AzureDataFactory adlı bir uygulama olarak yetkilendirmeniz istenir. Bu ekranda, ADF'nin kuruluşa erişmesine izin verme seçeneğini görürsünüz. İzin verme seçeneğini görmüyorsanız bir yöneticiden GitHub aracılığıyla izni el ile vermesini isteyin.

Bu adımları izledikten sonra fabrikanız kuruluşunuzdaki hem genel hem de özel depolara bağlanabilir. Bağlanamıyorsanız tarayıcı önbelleğini temizlemeyi ve yeniden denemeyi deneyin.

Kişisel bir hesap kullanarak genel GitHub veya GitHub Enterprise Cloud'a zaten bağlı

Genel GitHub veya GitHub Enterprise Cloud'a zaten bağlandıysanız ve yalnızca kişisel bir hesaba erişim izni verdiyseniz, bir kuruluşa izin vermek için aşağıdaki adımları izleyin.

  1. GitHub'a gidin ve Ayarlar açın.

    GitHub ayarlarını açma

  2. Başvurular'ı seçin. Yetkili OAuth uygulamaları sekmesinde AzureDataFactory'yi görmeniz gerekir.

    OAuth uygulamaları'nı seçin

  3. Uygulamayı seçin ve uygulamaya kuruluşunuza erişim verin.

    Erişim verme

Bu adımları izledikten sonra fabrikanız kuruluşunuzdaki hem genel hem de özel depolara bağlanabilir.

GitHub Enterprise Server'a Bağlan

GitHub Enterprise Server'a bağlanıyorsanız kimlik doğrulaması için kişisel erişim belirteci kullanmanız gerekir. Kişisel erişim belirteci oluşturma bölümünde kişisel erişim belirteci oluşturmayı öğrenin.

Not

GitHub Enterprise Server şirket içinde barındırılan özel ortamınızda olduğundan, bu kimlik doğrulamasını kullanırken güvenlik duvarı, ağ ilkeleri ve VPN'de tam denetime sahip olmanız gerekir. Daha fazla bilgi için bkz . GitHub Enterprise Server Hakkında.

GitHub Kurumsal sunucu bölmesini kullanarak depo yapılandırma adımlarını gösteren ekran görüntüsü.

Kurumsal sunucu erişim belirteci kimlik doğrulamasının kullanılmasını gösteren ekran görüntüsü.

Bilinen GitHub sınırlamaları

  • Betik ve veri dosyalarını bir GitHub deposunda depolayabilirsiniz. Ancak, dosyaları Azure Depolama'a el ile yüklemeniz gerekir. Data Factory işlem hattı, GitHub deposunda depolanan betiği veya veri dosyalarını Azure Depolama'a otomatik olarak yüklemez.

  • 2.14.0'dan eski bir sürüme sahip GitHub Enterprise, Microsoft Edge tarayıcısında çalışmaz.

  • Data Factory görsel yazma araçlarıyla GitHub tümleştirmesi yalnızca Data Factory'nin genel kullanıma sunulan sürümünde çalışır.

Azure DevOps Server 2022'ye Bağlan

Azure DevOps Server 2022'ye bağlanırsanız kimlik doğrulaması için kişisel erişim belirteci kullanmanız gerekir. Burada kişisel erişim belirteci oluşturmayı öğrenin.

ve sağlayarak Azure DevOps Server URL şirket içi Azure DevOps'a BağlanAzure DevOps Project Collection

ADO'yu sunucuyu kullanarak bir depo yapılandırmayı gösteren ekran görüntüsü.

Belirteci kod için okuma/yazma olarak erişim kapsamıyla birlikte sağlayın.

ADO erişim belirtecini yapılandırmayı gösteren ekran görüntüsü.

Sürüm denetimi

Sürüm denetim sistemleri (kaynak denetimi olarak da bilinir), geliştiricilerin kod üzerinde işbirliği yapmasına ve kod tabanında yapılan değişiklikleri izlemesine olanak tanır. Kaynak denetimi, çok geliştiricili projeler için temel bir araçtır.

Özellik dalları oluşturma

Bir veri fabrikasıyla ilişkili her Azure Repos Git deposunun bir işbirliği dalı vardır. (main varsayılan işbirliği dalıdır). Kullanıcılar ayrıca dal açılan menüsünde + Yeni Dal'a tıklayarak özellik dalları oluşturabilir.

Yeni dal oluşturma

Yeni dal bölmesi görüntülendikten sonra özellik dalınızın adını girin ve çalışmanın temeli olacak bir dal seçin.

Özel dalı temel alan bir dal oluşturmayı gösteren ekran görüntüsü.

Özellik dalınızdaki değişiklikleri işbirliği dalınızla birleştirmeye hazır olduğunuzda dal açılan menüsüne tıklayın ve Çekme isteği oluştur'u seçin. Bu eylem, çekme istekleri oluşturabileceğiniz, kod incelemeleri yapabileceğiniz ve değişiklikleri işbirliği dalınıza birleştirebileceğiniz Azure Repos Git'e götürür. (main varsayılandır). Yalnızca işbirliği dalınızdan Data Factory hizmetine yayımlamanıza izin verilir.

Yeni çekme isteği oluşturma

Yayımlama ayarlarını yapılandırma

Varsayılan olarak, data factory yayımlanan fabrikanın Resource Manager şablonlarını oluşturur ve bunları adlı adf_publishbir dala kaydeder. Özel yayımlama dalı yapılandırmak için, işbirliği dalındaki kök klasöre bir publish_config.json dosya ekleyin. Yayımlarken, ADF bu dosyayı okur, alanını publishBrancharar ve tüm Resource Manager şablonlarını belirtilen konuma kaydeder. Dal yoksa, data factory bunu otomatik olarak oluşturur. Bu dosyanın nasıl göründüğüne bir örnek aşağıda verilmiştir:

{
    "publishBranch": "factory/adf_publish"
}

Azure Data Factory'nin aynı anda yalnızca bir yayımlama dalı olabilir. Yeni bir yayımlama dalı belirttiğinizde Data Factory önceki yayımlama dalını silmez. Önceki yayımlama dalını kaldırmak istiyorsanız, el ile silin.

Not

Data Factory yalnızca fabrikayı publish_config.json yüklediğinde dosyayı okur. Fabrikayı portalda zaten yüklediyseniz, değişikliklerinizin etkili olması için tarayıcıyı yenileyin.

Kod değişikliklerini yayımlama

Değişiklikleri işbirliği dalında birleştirdikten sonra (mainvarsayılandır), ana daldaki kod değişikliklerinizi Data Factory hizmetinde el ile yayımlamak için Yayımla'ya tıklayın.

Data Factory hizmetinde değişiklikleri yayımlama

Yayımlama dalı ve bekleyen değişikliklerin doğru olduğunu onayladığınız bir yan bölme açılır. Değişikliklerinizi doğruladıktan sonra yayımlamayı onaylamak için Tamam'a tıklayın.

Doğru yayımlama dalını onaylayın

Önemli

Ana dal, Data Factory hizmetinde dağıtılanların temsilcisi değildir. Ana dalın Data Factory hizmetinde el ile yayımlanması gerekir .

Git tümleştirmesi için en iyi yöntemler

İzinler

Genellikle her ekip üyesinin Data Factory'yi güncelleştirme iznine sahip olmasını istemezsiniz. Aşağıdaki izin ayarları önerilir:

  • Tüm ekip üyelerinin Data Factory'de okuma izinleri olmalıdır.
  • Data Factory'de yalnızca belirli bir grup kişinin yayımlamasına izin verilmelidir. Bunu yapmak için Data Factory'yi içeren Kaynak Grubunda Data Factory katkıda bulunan rolüne sahip olmaları gerekir. İzinler hakkında daha fazla bilgi için bkz . Azure Data Factory için roller ve izinler.

İşbirliği dalında doğrudan iadelere izin verilmemesi önerilir. Her iade işleminde özellik dalları oluşturma bölümünde açıklanan bir çekme isteği gözden geçirme işleminden geçileceği için bu kısıtlama hataları önlemeye yardımcı olabilir.

Azure Key Vault'tan parolaları kullanma

Data Factory Bağlı Hizmetleri için bağlantı dizesi veya parolaları veya yönetilen kimlik kimlik doğrulamasını depolamak için Azure Key Vault'un kullanılması önerilir. Güvenlik nedeniyle, veri fabrikası Git'te gizli dizileri depolamaz. Parolalar gibi gizli dizileri içeren Bağlı Hizmetler'de yapılan tüm değişiklikler hemen Azure Data Factory hizmetinde yayımlanır.

Key Vault veya MSI kimlik doğrulaması kullanmak, Resource Manager şablon dağıtımı sırasında bu gizli dizileri sağlamanız gerekmeyeceği için sürekli tümleştirmeyi ve dağıtımı da kolaylaştırır.

Git tümleştirmesiyle ilgili sorunları giderme

Eski yayımlama dalı

Eski yayımlama dalına neden olabilecek bazı durum örnekleri aşağıda verilmiştir:

  • Kullanıcının birden çok dalı vardır. Bir özellik dalında, AKV ile ilişkilendirilmiş olmayan bir bağlı hizmeti sildi (AKV olmayan bağlı hizmetler Git'te olup olmadığına bakılmaksızın hemen yayımlanır) ve özellik dalını hiçbir zaman işbirliği dalı ile birleştirmedi.
  • Kullanıcı SDK veya PowerShell kullanarak veri fabrikasını değiştirdi
  • Bir kullanıcı tüm kaynakları yeni bir dala taşıdı ve ilk kez yayımlamayı denedi. Kaynaklar içeri aktarılırken bağlı hizmetler el ile oluşturulmalıdır.
  • Kullanıcı, AKV olmayan bir bağlı hizmeti veya Integration Runtime JSON'unu el ile karşıya yükler. Veri kümesi, bağlı hizmet veya işlem hattı gibi başka bir kaynaktan bu kaynağa başvurur. Kimlik bilgilerinin şifrelenmesini gerektirdiğinden, kullanıcı arabirimi aracılığıyla oluşturulan AKV olmayan bir bağlı hizmet hemen yayımlanır. Bu bağlı hizmete başvuran bir veri kümesini karşıya yükler ve yayımlamaya çalışırsanız, kullanıcı arabirimi buna izin verir çünkü git ortamında bulunur. Veri fabrikası hizmetinde mevcut olmadığından yayımlama zamanında reddedilir.

Yayımlama dalı ana dal ile eşitlenmemişse ve son yayımlamaya rağmen güncel olmayan kaynaklar içeriyorsa, aşağıdaki çözümlerden birini kullanabilirsiniz:

1. Seçenek: Canlı modun üzerine yazma işlevini kullanma

İşbirliği dalınızdaki kodu canlı modda yayımlar veya üzerine yazar. Deponuzdaki kodu gerçeğin kaynağı olarak kabul eder.

Kod akışı:İşbirliği dalı -> Canlı mod

işbirliği dalından kod yayımlamaya zorlama

Seçenek 2: Git deposunun bağlantısını kesme ve yeniden bağlama

Kodu canlı moddan işbirliği dalı içine aktarır. Kodu canlı modda gerçeğin kaynağı olarak kabul eder.

Kod akışı:Canlı mod -> İşbirliği dalı

  1. Geçerli Git deponuzu kaldırma
  2. Git'i aynı ayarlarla yeniden yapılandırın, ancak Var olan Data Factory kaynaklarını depoya aktar'ın seçili olduğundan emin olun ve İşbirliği dalı (aynı dal) seçeneğini belirleyin
  3. İşbirliği dalındaki değişiklikleri birleştirmek için bir çekme isteği oluşturun.

Not

Yalnızca doğrudan işlemelere izin vermeyen bir depoda çalışıyorsanız çekme isteği oluşturmanız ve birleştirmeniz gerekir. Çoğu kuruluşta depoya gönderimler birleştirmeden önce gözden geçirilmesini gerektirir, bu nedenle en iyi yöntem genellikle bu yaklaşımı kullanmaktır. Ancak bazı durumlarda gözden geçirme gerekmez; bu durumda çekme isteği oluşturmak ve birleştirmek gerekmez, ancak değişiklikler doğrudan işbirliği dalında işlenebilir.

Gerektiğinde her iki yöntemden birini uygun şekilde seçin.

Yayımlamada yeni olarak gösterilen tüm kaynaklar

Yayımlarken, daha önce yayımlanmış olsalar bile tüm kaynaklar yeni olarak görünebilir. Fabrika ARM şablonunu yeniden dağıtarak veya Fabrika repoConfiguration özelliğini PowerShell veya REST API aracılığıyla güncelleştirerek lastCommitId özelliği fabrikanın repoConfiguration özelliğinde sıfırlanırsa bu durum oluşabilir. Kaynakları yayımlamaya devam etmek sorunu çözebilir, ancak yeniden oluşmasını önlemek için fabrika repoConfiguration özelliğini güncelleştirmekten kaçının.

Farklı bir Git deposuna geçme

Farklı bir Git deposuna geçmek için Kaynak denetimi altındaki yönetim hub'ında Git yapılandırma sayfasına gidin. Bağlantıyı kes'i seçin.

Git simgesi

Veri fabrikanızın adını girin ve veri fabrikanızla ilişkili Git deposunu kaldırmak için onayla'ya tıklayın.

Geçerli Git deposuyla ilişkilendirmeyi kaldırma

Geçerli depoyla ilişkilendirmeyi kaldırdıktan sonra Git ayarlarınızı farklı bir depo kullanacak şekilde yapılandırabilir ve ardından mevcut Data Factory kaynaklarını yeni depoya aktarabilirsiniz.

Önemli

Veri fabrikasından Git yapılandırması kaldırılarak depodan hiçbir şey silinmez. Fabrika, yayımlanan tüm kaynakları içerir. Fabrikayı doğrudan hizmette düzenlemeye devam edebilirsiniz.