Azure Data Factory'de Azure İşlevi etkinliği
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!
Azure İşlevi etkinliği, Azure İşlevleri bir Azure Data Factory veya Synapse işlem hattında çalıştırmanıza olanak tanır. Azure İşlevi çalıştırmak için bağlı bir hizmet bağlantısı oluşturmanız gerekir. Ardından bağlı hizmeti, yürütmeyi planladığınız Azure İşlevini belirten bir etkinlikle kullanabilirsiniz.
Kullanıcı arabirimiyle Azure İşlevi etkinliği oluşturma
İşlem hattında Azure İşlevi etkinliğini kullanmak için aşağıdaki adımları tamamlayın:
İşlem hattı Etkinlikleri bölmesinin Azure İşlevi bölümünü genişletin ve bir Azure İşlevi etkinliğini işlem hattı tuvaline sürükleyin.
Tuvalde henüz seçili değilse yeni Azure İşlevi etkinliğini ve ayrıntılarını düzenlemek için Ayarlar sekmesini seçin.
Tanımlanmış bir Azure İşlevi bağlı hizmetiniz yoksa yeni bir hizmet oluşturmak için Yeni'yi seçin. Yeni Azure İşlevi bağlı hizmet bölmesinde mevcut Azure İşlev Uygulaması URL'nizi seçin ve bir İşlev Anahtarı sağlayın.
Azure İşlevi bağlı hizmetini seçtikten sonra yapılandırmayı tamamlamak için işlev adını ve diğer ayrıntıları sağlayın.
Azure İşlevi bağlı hizmeti
Azure işlevinin dönüş türü geçerli JObject
olmalıdır. (Unutmayın:JArray bir JObject
.) Dışında herhangi bir dönüş türü JObject
başarısız olur ve kullanıcı hatasını yükseltir Yanıt İçeriği geçerli bir JObject değil.
İşlev Anahtarı, her birinin bir işlev uygulamasında ayrı benzersiz anahtarlara veya ana anahtara sahip olduğu işlev adına güvenli erişim sağlar. Yönetilen kimlik, işlev uygulamasının tamamına güvenli erişim sağlar. Kullanıcının işlev adına erişmek için anahtar sağlaması gerekir. Daha fazla bilgi için İşlev erişim anahtarı hakkında daha fazla bilgi için işlev belgelerine bakın
Özellik | Açıklama | Gerekli |
---|---|---|
Tür | Tür özelliği şu şekilde ayarlanmalıdır: AzureFunction | Yes |
İşlev uygulaması URL'si | Azure İşlev Uygulaması URL'si. Biçim: https://<accountname>.azurewebsites.net . Bu URL, İşlev Uygulamanızı Azure portalında görüntülerken URL bölümünün altındaki değerdir |
Yes |
İşlev tuşu | Azure İşlevi için erişim anahtarı. İlgili işlevin Yönet bölümüne tıklayın ve İşlev Anahtarı'nı veya Konak anahtarını kopyalayın. Daha fazla bilgi için buraya bakın: Erişim anahtarlarıyla çalışma | Yes |
Kimlik Doğrulaması | Azure İşlevi'ni çağırmak için kullanılan kimlik doğrulama yöntemi. Desteklenen değerler 'Sistem tarafından atanan yönetilen kimlik' veya 'anonim' değerleridir. | Yes |
Kaynak Kimliği | Azure İşlevinin Uygulama (istemci) kimliği. İlgili işlevin Kimlik Doğrulaması bölümüne geçin ve Kimlik sağlayıcısı altında Uygulama (istemci) kimliğini alın. Bu özellik, sistem tarafından atanan yönetilen kimliği kullandığınızda görüntülenir. Daha fazla bilgi için bkz. App Service veya Azure İşlevleri uygulamanızı Microsoft Entra oturum açma bilgilerini kullanacak şekilde yapılandırma. | Hayır |
Not
Anonim kimlik doğrulaması kullandığınızda, Azure İşlevi tarafında kimliğinizi indirdiğinizden emin olun.
Azure İşlevi etkinliği
Özellik | Açıklama | İzin verilen değerler | Required |
---|---|---|---|
Veri Akışı Adı | İşlem hattındaki etkinliğin adı | String | Yes |
Tür | Etkinlik türü : 'AzureFunctionActivity' | String | Yes |
Bağlı hizmet | İlgili Azure İşlevi Uygulaması için Azure İşlevi bağlı hizmeti | Bağlı hizmet başvurusu | Yes |
İşlev adı | Bu etkinliğin çağırdığını Azure İşlev Uygulaması'ndaki işlevin adı | String | Yes |
Metot | İşlev çağrısı için REST API yöntemi | Desteklenen Dize Türleri: "GET", "POST", "PUT" | Yes |
Üst bilgi | İsteğe gönderilen üst bilgiler. Örneğin, bir istekte dili ve türü ayarlamak için: "headers": { "Accept-Language": "en-us", "Content-Type": "application/json" } | Dize (veya dizenin resultType değeriyle ifade) | Hayır |
Gövde | İşlev api yöntemine istekle birlikte gönderilen gövde | Dize (veya dizenin resultType değerini içeren ifade) veya nesnesi. | PUT/POST yöntemleri için gereklidir |
İstek yükü şemasını İstek yükü şeması bölümünde bulabilirsiniz.
Yönlendirme ve sorgular
Azure İşlev Etkinliği yönlendirmeyi destekler. Örneğin, Azure İşlevinizde uç nokta https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>
functionName
varsa Azure İşlevi Etkinliğinde kullanılacak olan olur<functionName>/<value>
. Çalışma zamanında isteneni functionName
sağlamak için bu işlevi parametreleştirebilirsiniz.
Not
functionName
için Dayanıklı İşlevler, yönlendirme bilgilerini eklemek için işlevin bağlamasının JSON tanımındaki route özelliğinden alınmalıdır. İşlev Uygulaması bulunamadığından, yalnızca yol ayrıntısı dahil edilmeden öğesinin kullanılması functionName
hataya neden olur.
Azure İşlev Etkinliği sorguları da destekler. Sorgunun functionName
bir parçası olarak eklenmesi gerekir. Örneğin, işlev adı ve HttpTriggerCSharp
eklemek istediğiniz sorgu olduğundaname=hello
, Azure İşlev Etkinliği'nde öğesini olarak HttpTriggerCSharp?name=hello
oluşturabilirsinizfunctionName
. Bu işlev parametrelendirilebilir, böylece değer çalışma zamanında belirlenebilir.
Zaman aşımı ve uzun süre çalışan işlevler
Azure İşlevleri ayarlarda yapılandırdığınız ayardan bağımsız olarak functionTimeout
230 saniye sonra zaman aşımına uğrar. Daha fazla bilgi için bu makaleye bakın. Bu davranışa geçici bir çözüm bulmak için zaman uyumsuz bir desen izleyin veya Dayanıklı İşlevler kullanın. Dayanıklı İşlevler avantajı, kendi durum izleme mekanizmalarını sunmalarıdır, bu nedenle kendi durum izlemenizi uygulamanız gerekmez.
Bu makalede Dayanıklı İşlevler hakkında daha fazla bilgi edinin. Dayanıklı İşlev'i çağırmak için bir Azure İşlev Etkinliği ayarlayabilirsiniz; bu örnek gibi farklı bir URI'ye sahip bir yanıt döndürür. statusQueryGetUri
İşlev çalışırken HTTP Durumu 202 döndürdüğünden, web etkinliği kullanarak işlevin durumunu yoklayabilirsiniz. Alanı olarak ayarlanmış bir Web Etkinliği url
ayarlayın @activity('<AzureFunctionActivityName>').output.statusQueryGetUri
. Dayanıklı İşlev tamamlandığında, işlevin çıkışı Web Etkinliğinin çıkışı olur.
Örnek
Tar dosyasının içeriğini ayıklamak için Azure İşlevi kullanan bir örneği burada bulabilirsiniz.
İlgili içerik
İşlem hatlarında ve etkinliklerde desteklenen etkinlikler hakkında daha fazla bilgi edinin.