İşlem hatlarında REST API'lerini çağırmak için Web etkinliğini kullanma

Web Etkinliği bir Azure Data Factory veya Synapse işlem hattından özel bir REST uç noktasını çağırmak için kullanılabilir. Etkinlik tarafından kullanılacak ve erişilecek veri kümelerini ve bağlı hizmetleri geçirebilirsiniz.

Not

Desteklenen çıktı yanıtı yük boyutu üst sınırı 4 MB'tır.

Önkoşullar

Başlamak için aşağıdaki önkoşulları tamamlamanız gerekir:

Kullanıcı arabirimiyle işlem hattına Web etkinliği ekleme

İşlem hattında Web etkinliği kullanmak için aşağıdaki adımları tamamlayın:

Etkinliği oluşturma

  1. Çalışma alanınızda yeni bir işlem hattı oluşturun.

  2. İşlem hattı Etkinlikleri bölmesinde Web'i arayın ve bunu seçerek işlem hattı tuvaline ekleyin.

    Etkinlikler bölmesinin ve Web etkinliğinin vurgulandığı Doku kullanıcı arabiriminin ekran görüntüsü.

  3. Henüz seçili değilse tuvaldeki yeni Web etkinliğini seçin.

    Web etkinliğinin Genel ayarlar sekmesini gösteren ekran görüntüsü.

    Not

    Ekran çözünürlüğü adının tam olarak yazılmasına izin vermiyorsa, web etkinliği önceki görüntüde gösterildiği gibi araç çubuğunda bir simge olarak görünebilir.

Genel ayarlar sekmesini yapılandırmak için Genel ayarlar kılavuzuna bakın.

Web etkinliği ayarları

  1. Ayarlar sekmesini seçin, Bağlantı açılan listesinden var olan bir bağlantıyı seçin veya yeni bir bağlantı oluşturun ve yapılandırma ayrıntılarını belirtin.

    Arama etkinliği ayarları sekmesini, sekmenin vurgulandığını ve yeni bağlantının nerede seçileceğini gösteren ekran görüntüsü.

  2. Yeni bağlantı oluşturmak için + Yeni'yi seçtiğinizde, bağlanmak için temel URL'yi ve kimlik bilgilerini sağlayabileceğiniz bağlantı oluşturma iletişim kutusunu görürsünüz.

    Web etkinliği için yeni bağlantı iletişim kutusunu gösteren ekran görüntüsü.

    Not

    Bağlantı adı en fazla 80 karakter uzunluğunda olabilir.

Şirket içi veya sanal ağ veri ağ geçidini kullanma

  1. Bağlantınızı oluştururken artık şirket içi veri ağ geçidi (OPDG) veya sanal ağ geçidi kullanmayı seçebilirsiniz. OPDG'nizi oluşturma ve yapılandırma yönergeleri için bkz. Şirket içi veri ağ geçidi oluşturma

  2. Sanal ağ geçidi kullanmak istiyorsanız, sanal ağ veri ağ geçidi oluşturma bölümüne bakın.

  3. Ağ geçidinizi başarıyla oluşturup yapılandırdıktan sonra, bağlantı iletişim kutusundaki Veri Ağ Geçidi açılır listesinin altında görünmelidir.

    Web etkinliği için veri ağ geçidi bağlantısı iletişim kutusunu gösteren ekran görüntüsü.

  4. Bağlantınızı ve veri ağ geçidinizi seçtikten veya oluşturduktan sonra kalan gerekli alanları doldurun, gerekli üst bilgileri ekleyin veya gelişmiş ayarları ayarlayın. Web etkinliği GET, POST, PUT, DELETE ve PATCH yöntemlerini destekler.

  5. Bağlantınızı seçtikten veya oluşturduktan sonra kalan gerekli alanları doldurun, gerekli üst bilgileri ekleyin veya gelişmiş ayarları ayarlayın. Web etkinliği GET, POST, PUT, DELETE ve PATCH yöntemlerini destekler.

İşlem hattını kaydet, çalıştır veya zamanla.

Genellikle, Web etkinliğinin çıkışını diğer etkinliklerle birlikte kullanırsınız, ancak yapılandırıldıktan sonra, diğer etkinlikler olmadan da doğrudan çalıştırılabilir. Bazı eylemler gerçekleştiren ve etkinlikten herhangi bir çıkış gerektirmeyen bir REST API'yi çağırmak için çalıştırıyorsanız işlem hattınız yalnızca Web etkinliğini de içerebilir.

İşlem hattı düzenleyicisinin üst kısmındaki Giriş sekmesine geçin ve işlem hattınızı kaydetmek için kaydet düğmesini seçin. Doğrudan çalıştırmak için Çalıştır'ı veya belirli zamanlarda veya aralıklarda çalıştırmaları zamanlamak için Zamanla'yı seçin. İşlem hattı çalıştırmaları hakkında daha fazla bilgi için bkz. İşlem hattı çalıştırmalarını zamanlama.

İşlem hattı düzenleyicisinde Sekme adı, Kaydet, Çalıştır ve Zamanlama düğmeleri vurgulanmış şekilde Giriş sekmesini gösteren ekran görüntüsü.

Çalıştırdıktan sonra, tuvalin altındaki Çıkış sekmesinden işlem hattı yürütmesini izleyebilir ve çalıştırma geçmişini görüntüleyebilirsiniz.