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:

  1. İş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.

  2. 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.

    Azure İşlevi etkinliğinin kullanıcı arabirimini gösterir.

  3. 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.

    Yeni Azure İşlevi bağlı hizmet oluşturma bölmesini gösterir.

  4. 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 JObjectolmalı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 functionNamebir 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=hellooluş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.

İşlem hatlarında ve etkinliklerde desteklenen etkinlikler hakkında daha fazla bilgi edinin.