Výstupní vazby tabulek Azure pro Azure Functions

Následující MyTableData třída představuje řádek dat v tabulce:

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; }
}

Následující funkce, která je spuštěna triggerem Queue Storage, zapíše novou MyDataTable entitu do tabulky s názvem OutputTable.

[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}"
    };
}

Následující příklad ukazuje funkci jazyka C#, která používá trigger HTTP k zápisu jednoho řádku tabulky.

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,
});

Ukázky TypeScriptu nejsou zdokumentované pro model v3.

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 };
    },
});

Tady je soubor function.json :

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

Oddíl konfigurace vysvětluje tyto vlastnosti.

Tady je javascriptový kód:

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
        });
    }
};

V knihovnách tříd jazyka TableInputAttribute C# podporuje následující vlastnosti:

V knihovnách tříd jazyka TableAttribute C# podporuje následující vlastnosti:

Konstruktor atributu přebírá název tabulky. Použijte atribut pro out parametr nebo návratovou hodnotu funkce, jak je znázorněno v následujícím příkladu:

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

Vlastnost můžete nastavit Connection tak, aby určila připojení ke službě Table Service, jak je znázorněno v následujícím příkladu:

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

Zatímco atribut přebírá Connection vlastnost, můžete také použít StorageAccountAttribute k určení připojení účtu úložiště. Můžete to udělat, když potřebujete použít jiný účet úložiště než jiné funkce v knihovně. Konstruktor přebírá název nastavení aplikace, které obsahuje připojovací řetězec úložiště. Atribut lze použít na úrovni parametru, metody nebo třídy. Následující příklad ukazuje úroveň třídy a úroveň metody:

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

Účet úložiště, který se má použít, se určuje v následujícím pořadí:

• Vlastnost aktivační události nebo vazby atributu Connection .
• Atribut StorageAccount použitý na stejný parametr jako aktivační událost nebo atribut vazby.
• Atribut StorageAccount použitý na funkci.
• Atribut StorageAccount použitý pro třídu.
• Výchozí účet úložiště pro aplikaci funkcí, který je definován v AzureWebJobsStorage nastavení aplikace.

Následující tabulka vysvětluje vlastnosti, které můžete nastavit u objektu předaného options metodě output.table() .

Následující tabulka vysvětluje vlastnosti konfigurace vazby, které jste nastavili v souboru function.json .

Kompilovaná funkce C# v izolované knihovně tříd pracovních procesů běží v procesu izolovaném od modulu runtime.

Knihovna tříd v procesu je kompilovaná funkce jazyka C# spuštěná ve stejném procesu jako modul runtime služby Functions.

Parametry a návratové typy jsou podporovány out následujícími typy:

• Prostý starý objekt CLR (POCO), který zahrnuje PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity.
• ICollector<T> nebo IAsyncCollector<T> kde T obsahuje vlastnosti PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity.

Můžete se také svázat ze TableClient sady Azure SDK. Tento objekt pak můžete použít k zápisu do tabulky.

Parametry a návratové typy jsou podporovány out následujícími typy:

• Prostý starý objekt CLR (POCO), který zahrnuje PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity nebo děděním TableEntity.
• ICollector<T> nebo IAsyncCollector<T> kde T obsahuje vlastnosti PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity nebo děděním TableEntity.

Jako parametr metody můžete také vytvořit vazbu ze CloudTable sady SDK služby Storage. Tento objekt pak můžete použít k zápisu do tabulky.

Parametry a návratové typy jsou podporovány out následujícími typy:

• Prostý starý objekt CLR (POCO), který zahrnuje PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity nebo děděním TableEntity.
• ICollector<T> nebo IAsyncCollector<T> kde T obsahuje vlastnosti PartitionKey a RowKey vlastnosti. Tyto vlastnosti můžete doprovázet implementací ITableEntity nebo děděním TableEntity.

Jako parametr metody můžete také vytvořit vazbu ze CloudTable sady SDK služby Storage. Tento objekt pak můžete použít k zápisu do tabulky.

Pokud chcete, aby funkce zapisuje do jedné entity, výstupní vazba Azure Tables může svázat s následujícími typy:

Pokud chcete, aby funkce zapisovat do více entit, výstupní vazba Azure Tables může svázat s následujícími typy:

V případě jiných výstupních scénářů můžete přímo vytvářet a používat typy z Azure.Data.Tables .

Vrátí prostý starý objekt CLR (POCO) s vlastnostmi, které lze mapovat na entitu tabulky.

Funkce verze 1.x nepodporuje izolovaný pracovní proces.

Nastavte data výstupního řádku tak, že vrátíte hodnotu nebo použijete context.extraOutputs.set().

Nastavte data výstupního řádku pomocí tohocontext.bindings.<name>, kde <name> je hodnota zadaná ve name vlastnosti function.json.