Azure İşlevleri için Azure Tabloları çıkış bağlamaları

Aşağıdaki MyTableData sınıf, tablodaki bir veri satırını temsil eder:

public class MyTableData : Azure.Data.Tables.ITableEntity
{
    public string Text { get; set; }

    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }
}

Kuyruk Depolama tetikleyicisi tarafından başlatılan aşağıdaki işlev, OutputTable adlı bir tabloya yeni MyDataTable bir varlık yazar.

[Function("TableFunction")]
[TableOutput("OutputTable", Connection = "AzureWebJobsStorage")]
public static MyTableData Run(
    [QueueTrigger("table-items")] string input,
    [TableInput("MyTable", "<PartitionKey>", "{queueTrigger}")] MyTableData tableInput,
    FunctionContext context)
{
    var logger = context.GetLogger("TableFunction");

    logger.LogInformation($"PK={tableInput.PartitionKey}, RK={tableInput.RowKey}, Text={tableInput.Text}");

    return new MyTableData()
    {
        PartitionKey = "queue",
        RowKey = Guid.NewGuid().ToString(),
        Text = $"Output record with rowkey {input} created at {DateTime.Now}"
    };
}

Aşağıdaki örnekte, tek bir tablo satırı yazmak için HTTP tetikleyicisi kullanan bir C# işlevi gösterilmektedir.

public class TableStorage
{
    public class MyPoco
    {
        public string PartitionKey { get; set; }
        public string RowKey { get; set; }
        public string Text { get; set; }
    }

    [FunctionName("TableOutput")]
    [return: Table("MyTable")]
    public static MyPoco TableOutput([HttpTrigger] dynamic input, ILogger log)
    {
        log.LogInformation($"C# http trigger function processed: {input.Text}");
        return new MyPoco { PartitionKey = "Http", RowKey = Guid.NewGuid().ToString(), Text = input.Text };
    }
}

import { app, HttpRequest, HttpResponseInit, InvocationContext, output } from '@azure/functions';

const tableOutput = output.table({
    tableName: 'Person',
    connection: 'MyStorageConnectionAppSetting',
});

interface PersonEntity {
    PartitionKey: string;
    RowKey: string;
    Name: string;
}

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const rows: PersonEntity[] = [];
    for (let i = 1; i < 10; i++) {
        rows.push({
            PartitionKey: 'Test',
            RowKey: i.toString(),
            Name: `Name ${i}`,
        });
    }
    context.extraOutputs.set(tableOutput, rows);
    return { status: 201 };
}

app.http('httpTrigger1', {
    methods: ['POST'],
    authLevel: 'anonymous',
    extraOutputs: [tableOutput],
    handler: httpTrigger1,
});

Model v3 için TypeScript örnekleri belgelenmez.

const { app, output } = require('@azure/functions');

const tableOutput = output.table({
    tableName: 'Person',
    connection: 'MyStorageConnectionAppSetting',
});

app.http('httpTrigger1', {
    methods: ['POST'],
    authLevel: 'anonymous',
    extraOutputs: [tableOutput],
    handler: async (request, context) => {
        const rows = [];
        for (let i = 1; i < 10; i++) {
            rows.push({
                PartitionKey: 'Test',
                RowKey: i.toString(),
                Name: `Name ${i}`,
            });
        }
        context.extraOutputs.set(tableOutput, rows);
        return { status: 201 };
    },
});

İşte function.json dosyası:

{
  "bindings": [
    {
      "name": "input",
      "type": "manualTrigger",
      "direction": "in"
    },
    {
      "tableName": "Person",
      "connection": "MyStorageConnectionAppSetting",
      "name": "tableBinding",
      "type": "table",
      "direction": "out"
    }
  ],
  "disabled": false
}

Yapılandırma bölümünde bu özellikler açıklanır.

JavaScript kodu şu şekildedir:

module.exports = async function (context) {

    context.bindings.tableBinding = [];

    for (var i = 1; i < 10; i++) {
        context.bindings.tableBinding.push({
            PartitionKey: "Test",
            RowKey: i.toString(),
            Name: "Name " + i
        });
    }
};

C# sınıf kitaplıklarında, TableInputAttribute aşağıdaki özellikleri destekler:

C# sınıf kitaplıklarında, TableAttribute aşağıdaki özellikleri destekler:

Özniteliğin oluşturucusunun tablo adı alır. Aşağıdaki örnekte gösterildiği gibi özniteliğini bir out parametrede veya işlevin dönüş değerinde kullanın:

[FunctionName("TableOutput")]
[return: Table("MyTable")]
public static MyPoco TableOutput(
    [HttpTrigger] dynamic input, 
    ILogger log)
{
    ...
}

Özelliğini, aşağıdaki örnekte gösterildiği gibi tablo hizmetine bir bağlantı belirtecek şekilde ayarlayabilirsiniz Connection :

[FunctionName("TableOutput")]
[return: Table("MyTable", Connection = "StorageConnectionAppSetting")]
public static MyPoco TableOutput(
    [HttpTrigger] dynamic input, 
    ILogger log)
{
    ...
}

Özniteliği bir Connection özellik alırken depolama hesabı bağlantısı belirtmek için StorageAccountAttribute'u da kullanabilirsiniz. Kitaplıktaki diğer işlevlerden farklı bir depolama hesabı kullanmanız gerektiğinde bunu yapabilirsiniz. Oluşturucu, depolama bağlantı dizesi içeren bir uygulama ayarının adını alır. Özniteliği parametre, yöntem veya sınıf düzeyinde uygulanabilir. Aşağıdaki örnekte sınıf düzeyi ve yöntem düzeyi gösterilmektedir:

[StorageAccount("ClassLevelStorageAppSetting")]
public static class AzureFunctions
{
    [FunctionName("StorageTrigger")]
    [StorageAccount("FunctionLevelStorageAppSetting")]
    public static void Run( //...
{
    ...
}

Kullanılacak depolama hesabı aşağıdaki sırayla belirlenir:

• Tetikleyici veya bağlama özniteliğinin Connection özelliği.
• Tetikleyici StorageAccount veya bağlama özniteliğiyle aynı parametreye uygulanan öznitelik.
• StorageAccount İşleve uygulanan öznitelik.
• StorageAccount sınıfına uygulanan öznitelik.
• uygulama ayarında AzureWebJobsStorage tanımlanan işlev uygulaması için varsayılan depolama hesabı.

Aşağıdaki tabloda, yöntemine geçirilen output.table() nesnede options ayarlayabileceğiniz özellikler açıklanmaktadır.

Aşağıdaki tabloda, function.json dosyasında ayarladığınız bağlama yapılandırma özellikleri açıklanmaktadır.

Yalıtılmış çalışan işlem sınıfı kitaplığı derlenmiş C# işlevi çalışma zamanından yalıtılmış bir işlemde çalışır.

İşlem içi sınıf kitaplığı, İşlevler çalışma zamanıyla aynı işlemde çalıştırılan derlenmiş bir C# işlevidir.

Parametreler ve dönüş türleri için out aşağıdaki türler desteklenir:

• ve RowKey özelliklerini içeren PartitionKey düz eski bir CLR nesnesi (POCO). uygulayarak bu özelliklere ITableEntityeşlik edebilirsiniz.
• ICollector<T>T veya IAsyncCollector<T> ve RowKey özelliklerini içerirPartitionKey. uygulayarak bu özelliklere ITableEntityeşlik edebilirsiniz.

Azure SDK'dan da bağlayabilirsiniz.TableClient Daha sonra tabloya yazmak için bu nesneyi kullanabilirsiniz.

Parametreler ve dönüş türleri için out aşağıdaki türler desteklenir:

• ve RowKey özelliklerini içeren PartitionKey düz eski bir CLR nesnesi (POCO). uygulayarak veya devralarak bu özelliklere ITableEntity TableEntityeşlik edebilirsiniz.
• ICollector<T>T veya IAsyncCollector<T> ve RowKey özelliklerini içerirPartitionKey. uygulayarak veya devralarak bu özelliklere ITableEntity TableEntityeşlik edebilirsiniz.

Depolama SDK'sından yöntemi parametresi olarak da bağlayabilirsiniz.CloudTable Daha sonra tabloya yazmak için bu nesneyi kullanabilirsiniz.

Parametreler ve dönüş türleri için out aşağıdaki türler desteklenir:

• ve RowKey özelliklerini içeren PartitionKey düz eski bir CLR nesnesi (POCO). uygulayarak veya devralarak bu özelliklere ITableEntity TableEntityeşlik edebilirsiniz.
• ICollector<T>T veya IAsyncCollector<T> ve RowKey özelliklerini içerirPartitionKey. uygulayarak veya devralarak bu özelliklere ITableEntity TableEntityeşlik edebilirsiniz.

Depolama SDK'sından yöntemi parametresi olarak da bağlayabilirsiniz.CloudTable Daha sonra tabloya yazmak için bu nesneyi kullanabilirsiniz.

İşlevin tek bir varlığa yazmasını istediğinizde, Azure Tabloları çıkış bağlaması aşağıdaki türlere bağlanabilir:

İşlevin birden çok varlığı yazmasını istediğinizde, Azure Tabloları çıkış bağlaması aşağıdaki türlere bağlanabilir:

Diğer çıkış senaryoları için, doğrudan Azure.Data.Tables'dan diğer türlerle tableclient oluşturun ve kullanın. Azure SDK'dan bir istemci türü oluşturmak için bağımlılık ekleme kullanma örneği için bkz . Azure istemcilerini kaydetme.

Tablo varlığına eşlenebilen özelliklere sahip düz eski bir CLR nesnesi (POCO) döndürür.

İşlevler sürüm 1.x yalıtılmış çalışan işlemini desteklemez.

Değerini döndürerek veya kullanarak context.extraOutputs.set()çıkış satırı verilerini ayarlayın.

function.json özelliğinde name belirtilen değerin nerede <name> olduğunu kullanarak context.bindings.<name> çıkış satırı verilerini ayarlayın.