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:

v2

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

v1

Anda perlu memperbarui kode fungsi dan menambahkan definisi ke file konfigurasi function.json.

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

Proses terisolasi

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.

Sedang dalam proses

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, 
    [Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg, 
    ILogger log)

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.

v4

Contoh pengikatan untuk model Node.js v4 belum tersedia.

v3

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

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.

v2

@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.')

v1

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

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.

v4

Contoh pengikatan untuk model Node.js v4 belum tersedia.

v3

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

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.

Proses terisolasi

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

Sedang dalam proses

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.

v2

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

v1

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:

• Pengikatan output penyimpanan Antrean
• Pengikatan keluaran Azure Cosmos DB

Langkah berikutnya

• Azure Functions memicu dan mengikat konsep