Aracılığıyla paylaş


Azure Data Factory’de genel parametreler

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!

Genel parametreler, işlem hatlarının herhangi bir ifadede kullanabileceği bir veri fabrikasındaki sabitlerdir. Bunlar, aynı parametre adlarına ve değerlerine sahip birden çok işlem hattınız olduğunda kullanışlıdır. Sürekli tümleştirme ve dağıtım işlemini (CI/CD) kullanarak bir veri fabrikasını tanıtırken, bu parametreleri her ortamda geçersiz kılabilirsiniz.

Genel parametreler oluşturma

Genel parametre oluşturmak için Yönet bölümündeki Genel parametreler sekmesine gidin. Oluşturma yan gezintisini açmak için Yeni'yi seçin.

Genel parametreler oluşturmak için seçtiğiniz Yeni düğmesini vurgulayan ekran görüntüsü.

Yan gezintide bir ad girin, bir veri türü seçin ve parametrenizin değerini belirtin.

Yeni genel parametrenin adını, veri türünü ve değerini eklediğiniz yeri gösteren ekran görüntüsü.

Genel parametre oluşturulduktan sonra, parametrenin adına tıklayarak bu parametreyi düzenleyebilirsiniz. Aynı anda birden çok parametreyi değiştirmek için Tümünü düzenle'yi seçin.

Genel parametreler oluşturma

İşlem hattında genel parametreleri kullanma

Genel parametreler herhangi bir işlem hattı ifadesinde kullanılabilir. İşlem hattı veri kümesi veya veri akışı gibi başka bir kaynağa başvuruyorsa, genel parametre değerini bu kaynağın parametreleri aracılığıyla geçirebilirsiniz. Genel parametrelere olarak pipeline().globalParameters.<parameterName>başvurulur.

Genel parametreleri kullanma

CI/CD'de genel parametreler

CI/CD sırasında ARM şablonuna genel parametreler eklemenizi öneririz. Aşağıdaki görüntüde gösterildiği gibi ARM şablonuna genel parametreler eklemeye yönelik yeni mekanizma ('Yönetim hub'ı' -> 'ARM şablonu' -> 'ARM şablonuna genel parametreleri dahil et'), daha önce olduğu gibi fabrika düzeyinde ayarları geçersiz kılmaz, bu nedenle CI/CD sırasında genel parametre dağıtımı için ek PowerShell gerektirmez.

'ARM şablonuna ekle' öğesinin ekran görüntüsü.

Not

Genel parametreleri dahil etmek için kullanıcı arabirimi deneyimini 'Genel parametreler' bölümünden Yönet hub'ında 'ARM şablonu' bölümüne taşıdık.

Eski mekanizmayı zaten kullanıyorsanız ('Yönetim hub'ı' -> 'Genel parametreler' -> 'ARM şablonuna ekle') devam edebilirsiniz. Bunu desteklemeye devam edeceğiz.

İndirilen ARM şablonundaki Parameters klasörü, ARM şablonunda kullanılan parametreleri tanımlayan JSON dosyalarını içerir. Her dosya belirli bir genel parametreye karşılık gelir.

Genel parametreleri sürekli tümleştirme ve dağıtım çözümünüzde tümleştirmenin eski akışını kullanıyorsanız, çalışmaya devam eder:

  • ARM şablonuna genel parametreleri ekleyin ('Yönet hub'ı' -> 'Genel parametreler' -> 'ARM şablonuna ekle') Kullanım dışı bırakılan 'ARM şablonuna ekle' öğesinin ekran görüntüsü.

  • PowerShell betiği aracılığıyla genel parametreleri dağıtma

Genel parametrelerle CICD'yi çok daha kolay ve kolay yönetilebilir hale getirdiğinden ARM şablonuna genel parametreleri eklemeye yönelik yeni mekanizmayı ('Yönetim hub'ı' -> 'ARM şablonu' -> 'ARM şablonuna genel parametreleri dahil et') kullanmanızı kesinlikle öneririz.

Not

Arm şablonu yapılandırmasına genel parametreleri dahil et yalnızca "Git modunda" kullanılabilir. Şu anda "canlı mod" veya "Data Factory" modunda devre dışı bırakılmıştır.

Uyarı

Parametre adında '-' kullanamazsınız. "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage='pipeline().globalParameters.myparam-dbtest-url' ifadesi >geçerli değil: .....}" hata kodu alıyorsunuz. Ancak parametre adında '_' kullanabilirsiniz.