Bagikan melalui


Menyambungkan fungsi ke layanan Azure menggunakan pengikatan

Saat Anda membuat fungsi, kode pemicu khusus bahasa ditambahkan dalam proyek Anda dari sekumpulan templat pemicu. Jika Anda ingin menghubungkan fungsi Anda ke layanan lain dengan menggunakan pengikatan input atau output, Anda harus menambahkan definisi pengikatan tertentu dalam fungsi Anda. Untuk mempelajari lebih lanjut, lihat konsep pemicu dan pengikatan Azure Functions.

Pengembangan lokal

Ketika Anda mengembangkan fungsi secara lokal, Anda perlu memperbarui kode fungsi untuk menambahkan pengikatan. Untuk bahasa yang menggunakan function.json, Visual Studio Code menyediakan alat untuk menambahkan pengikatan ke fungsi.

Menambahkan pengikatan secara manual berdasarkan contoh

Saat menambahkan pengikatan ke fungsi yang ada, Anda perlu menambahkan atribut khusus pengikatan ke definisi fungsi dalam kode.

Saat menambahkan pengikatan ke fungsi yang ada, Anda perlu menambahkan anotasi khusus pengikatan ke definisi fungsi dalam kode.

Saat menambahkan pengikatan ke fungsi yang ada, Anda perlu memperbarui kode fungsi dan menambahkan definisi ke file konfigurasi function.json.

Saat menambahkan pengikatan ke fungsi yang ada, Anda perlu memperbarui definisi fungsi, tergantung pada model Anda:

Anda perlu menambahkan anotasi khusus pengikatan ke definisi fungsi dalam kode.

Contoh berikut menunjukkan definisi fungsi setelah menambahkan pengikatan output Queue Storage ke fungsi yang dipicu HTTP:

Karena fungsi yang dipicu HTTP juga mengembalikan respons HTTP, fungsi mengembalikan MultiResponse objek, yang mewakili output HTTP dan antrean.

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequest req,
    FunctionContext executionContext)
{

Contoh ini adalah definisi MultiResponse objek yang mencakup pengikatan output:

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public IActionResult HttpResponse { get; set; }
}

Saat menerapkan contoh tersebut ke proyek Anda sendiri, Anda mungkin perlu mengubah HttpRequest ke HttpRequestData dan IActionResult ke HttpResponseData, tergantung pada apakah Anda menggunakan integrasi ASP.NET Core atau tidak.

Pesan dikirim ke antrean ketika fungsi selesai. Cara Anda menentukan pengikatan output tergantung pada model proses Anda. Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {

Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

Contoh pengikatan untuk model Node.js v4 belum tersedia.

Cara Anda menentukan pengikatan output tergantung pada versi model Node.js Anda. Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

$outputMsg = $name
Push-OutputBinding -name msg -Value $outputMsg

Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

Cara Anda menentukan pengikatan output tergantung pada versi model Python Anda. Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

Contoh pengikatan untuk model Node.js v4 belum tersedia.

Cara Anda menentukan pengikatan output tergantung pada versi model Node.js Anda. Untuk informasi selengkapnya, termasuk tautan ke contoh kode pengikatan yang dapat Anda rujuk, lihat Menambahkan pengikatan ke fungsi.

Gunakan tabel berikut ini untuk menemukan contoh tipe pengikatan tertentu yang bisa Anda gunakan untuk memandu Anda dalam memperbarui fungsi yang sudah ada. Pertama, pilih tab bahasa yang sesuai dengan proyek Anda.

Kode pengikatan untuk C# tergantung pada model proses tertentu.

Layanan Contoh Sampel
Penyimpanan Blob Pemicu
Input
Hasil
Tautan
Azure Cosmos DB Pemicu
Input
Hasil
Tautan
Azure Data Explorer Input
Hasil
Tautan
Azure SQL Pemicu
Input
Hasil
Tautan
Event Grid Pemicu
Hasil
Tautan
Event Hubs Pemicu
Hasil
IoT Hub Pemicu
Hasil
HTTP Pemicu Tautan
Antrean Penyimpanan Pemicu
Hasil
Tautan
RabbitMQ Pemicu
Hasil
SendGrid Hasil
Service Bus Pemicu
Hasil
Tautan
SignalR Pemicu
Input
Hasil
Penyimpanan Tabel Input
Hasil
Pengatur Waktu Pemicu Tautan
Twilio Hasil Tautan
Layanan Contoh Sampel
Penyimpanan Blob Pemicu
Input
Hasil
Tautan
Azure Cosmos DB Pemicu
Input
Hasil
Tautan
Azure Data Explorer Input
Hasil
Tautan
Azure SQL Pemicu
Input
Hasil
Event Grid Pemicu
Hasil
Tautan
Event Hubs Pemicu
Hasil
IoT Hub Pemicu
Hasil
HTTP Pemicu Tautan
Antrean Penyimpanan Pemicu
Hasil
Tautan
RabbitMQ Pemicu
Hasil
SendGrid Hasil
Service Bus Pemicu
Hasil
Tautan
SignalR Pemicu
Input
Hasil
Penyimpanan Tabel Input
Hasil
Pengatur Waktu Pemicu Tautan
Twilio Hasil Tautan
Layanan Contoh Sampel
Penyimpanan Blob Pemicu
Input
Hasil
Tautan
Azure Cosmos DB Pemicu
Input
Hasil
Tautan
Azure Data Explorer Input
Hasil
Azure SQL Pemicu
Input
Hasil
Tautan
Event Grid Pemicu
Hasil
Tautan
Event Hubs Pemicu
Hasil
IoT Hub Pemicu
Hasil
HTTP Pemicu Tautan
Antrean Penyimpanan Pemicu
Hasil
Tautan
RabbitMQ Pemicu
Hasil
SendGrid Hasil
Service Bus Pemicu
Hasil
Tautan
SignalR Pemicu
Input
Hasil
Penyimpanan Tabel Input
Hasil
Pengatur Waktu Pemicu Tautan
Twilio Hasil Tautan
Layanan Contoh Sampel
Penyimpanan Blob Pemicu
Input
Hasil
Tautan
Azure Cosmos DB Pemicu
Input
Hasil
Tautan
Azure SQL Pemicu
Input
Hasil
Event Grid Pemicu
Hasil
Tautan
Event Hubs Pemicu
Hasil
IoT Hub Pemicu
Hasil
HTTP Pemicu Tautan
Antrean Penyimpanan Pemicu
Hasil
Tautan
RabbitMQ Pemicu
Hasil
SendGrid Hasil
Service Bus Pemicu
Hasil
Tautan
SignalR Pemicu
Input
Hasil
Penyimpanan Tabel Input
Hasil
Pengatur Waktu Pemicu Tautan
Twilio Hasil Tautan

Kode pengikatan untuk Python tergantung pada versi model Python.

Layanan Contoh Sampel
Penyimpanan Blob Pemicu
Input
Hasil
Tautan
Azure Cosmos DB Pemicu
Input
Hasil
Tautan
Azure Data Explorer Input
Hasil
Azure SQL Pemicu
Input
Hasil
Tautan
Event Grid Pemicu
Hasil
Tautan
Event Hubs Pemicu
Hasil
IoT Hub Pemicu
Hasil
HTTP Pemicu Tautan
Antrean Penyimpanan Pemicu
Hasil
Tautan
RabbitMQ Pemicu
Hasil
SendGrid Hasil
Service Bus Pemicu
Hasil
Tautan
SignalR Pemicu
Input
Hasil
Penyimpanan Tabel Input
Hasil
Pengatur Waktu Pemicu Tautan
Twilio Hasil Tautan

Visual Studio Code

Saat Anda menggunakan Visual Studio Code untuk mengembangkan fungsi dan fungsi Anda menggunakan file function.jspada, ekstensi Azure Functions dapat secara otomatis menambahkan pengikatan ke file function.json yang sudah ada. Untuk mempelajari selengkapnya, lihat Menambahkan pengikatan input dan output.

Portal Azure

Saat Anda mengembangkan fungsi Anda di portal Microsoft Azure, Anda menambahkan pengikatan input dan output di tab Integrasi untuk fungsi tertentu. Pengikatan baru ditambahkan ke file function.json atau ke atribut metode, tergantung pada bahasa Anda. Artikel berikut ini memperlihatkan contoh cara menambahkan pengikatan ke fungsi yang sudah ada di portal:

Langkah berikutnya