Vstupní vazby tabulek Azure pro Azure Functions

Vstupní vazbu tabulek Azure slouží ke čtení tabulky ve službě Azure Cosmos DB pro tabulky nebo Azure Table Storage.

Informace o nastavení a konfiguraci najdete v přehledu.

Důležité

Tento článek používá karty pro podporu více verzí programovacího modelu Node.js. Model v4 je obecně dostupný a je navržený tak, aby měl flexibilnější a intuitivnější prostředí pro vývojáře v JavaScriptu a TypeScriptu. Další podrobnosti o tom, jak model v4 funguje, najdete v příručce pro vývojáře služby Azure Functions Node.js. Další informace o rozdílech mezi v3 a v4 najdete v průvodci migrací.

Příklad

Podpora Go pro toto vázání momentálně není dostupná.

Použití vazby závisí na verzi balíčku rozšíření a režimu jazyka C# používaném ve vaší aplikaci funkcí, což může být jedna z následujících možností:

Izolovaný model pracovního procesu

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

Model v procesu

Důležité

Podpora modelu v procesu skončí 10. listopadu 2026. Důrazně doporučujeme migrovat aplikace do izolovaného modelu pracovního procesu pro plnou podporu.

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

Zvolte verzi, abyste viděli příklady pro režim a verzi.

Rozšíření Azure Tables

Následující příklad ukazuje funkci jazyka C#, která čte jeden řádek tabulky. Pro každou zprávu poslanou do fronty se funkce aktivuje.

Hodnota {queueTrigger} klíče řádku sváže klíč řádku s metadaty zprávy, což je řetězec zprávy.

public class TableStorage
{
    public class MyPoco : 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; }
    }


    [FunctionName("TableInput")]
    public static void TableInput(
        [QueueTrigger("table-items")] string input, 
        [Table("MyTable", "MyPartition", "{queueTrigger}")] MyPoco poco, 
        ILogger log)
    {
        log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
    }
}

TableClient Ke čtení tabulky pomocí sady Azure SDK použijte parametr metody. Tady je příklad funkce, která se dotazuje na tabulku protokolu Azure Functions:

using Microsoft.Azure.WebJobs;
using Microsoft.Extensions.Logging;
using Azure.Data.Tables;
using System;
using System.Threading.Tasks;
using Azure;
namespace FunctionAppCloudTable2
{
    public class LogEntity : ITableEntity
    {
        public string OriginalName { get; set; }

        public string PartitionKey { get; set; }
        public string RowKey { get; set; }
        public DateTimeOffset? Timestamp { get; set; }
        public ETag ETag { get; set; }
    }
    public static class CloudTableDemo
    {
        [FunctionName("CloudTableDemo")]
        public static async Task Run(
            [TimerTrigger("0 */1 * * * *")] TimerInfo myTimer,
            [Table("AzureWebJobsHostLogscommon")] TableClient tableClient,
            ILogger log)
        {
            log.LogInformation($"C# Timer trigger function executed at: {DateTime.Now}");
            AsyncPageable<LogEntity> queryResults = tableClient.QueryAsync<LogEntity>(filter: $"PartitionKey eq 'FD2' and RowKey gt 't'");
            await foreach (LogEntity entity in queryResults)
            {
                log.LogInformation($"{entity.PartitionKey}\t{entity.RowKey}\t{entity.Timestamp}\t{entity.OriginalName}");
            }
        }
    }
}

Další informace o použití TableClientnajdete v referenčních informacích k rozhraní API Azure.Data.Tables.

Kombinované rozšíření Azure Storage

Následující příklad ukazuje funkci jazyka C#, která čte jeden řádek tabulky. Pro každou zprávu poslanou do fronty se funkce aktivuje.

Hodnota {queueTrigger} klíče řádku sváže klíč řádku s metadaty zprávy, což je řetězec zprávy.

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

    [FunctionName("TableInput")]
    public static void TableInput(
        [QueueTrigger("table-items")] string input, 
        [Table("MyTable", "MyPartition", "{queueTrigger}")] MyPoco poco, 
        ILogger log)
    {
        log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
    }
}

CloudTable Ke čtení tabulky pomocí sady SDK služby Azure Storage použijte parametr metody. Tady je příklad funkce, která se dotazuje na tabulku protokolu Azure Functions:

using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Host;
using Microsoft.Extensions.Logging;
using Microsoft.Azure.Cosmos.Table;
using System;
using System.Threading.Tasks;

namespace FunctionAppCloudTable2
{
    public class LogEntity : TableEntity
    {
        public string OriginalName { get; set; }
    }
    public static class CloudTableDemo
    {
        [FunctionName("CloudTableDemo")]
        public static async Task Run(
            [TimerTrigger("0 */1 * * * *")] TimerInfo myTimer, 
            [Table("AzureWebJobsHostLogscommon")] CloudTable cloudTable,
            ILogger log)
        {
            log.LogInformation($"C# Timer trigger function executed at: {DateTime.Now}");

            TableQuery<LogEntity> rangeQuery = new TableQuery<LogEntity>().Where(
                TableQuery.CombineFilters(
                    TableQuery.GenerateFilterCondition("PartitionKey", QueryComparisons.Equal, 
                        "FD2"),
                    TableOperators.And,
                    TableQuery.GenerateFilterCondition("RowKey", QueryComparisons.GreaterThan, 
                        "t")));

            // Execute the query and loop through the results
            foreach (LogEntity entity in 
                await cloudTable.ExecuteQuerySegmentedAsync(rangeQuery, null))
            {
                log.LogInformation(
                    $"{entity.PartitionKey}\t{entity.RowKey}\t{entity.Timestamp}\t{entity.OriginalName}");
            }
        }
    }
}

Další informace o tom, jak používat CloudTable, najdete v tématu Začínáme s Azure Table Storage.

Pokud se pokusíte vytvořit vazbu a CloudTable zobrazí se chybová zpráva, ujistěte se, že máte odkaz na správnou verzi sady SDK služby Storage.

Funkce 1.x

Následující příklad ukazuje funkci jazyka C#, která čte jeden řádek tabulky. Pro každou zprávu poslanou do fronty se funkce aktivuje.

Hodnota {queueTrigger} klíče řádku sváže klíč řádku s metadaty zprávy, což je řetězec zprávy.

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

    [FunctionName("TableInput")]
    public static void TableInput(
        [QueueTrigger("table-items")] string input, 
        [Table("MyTable", "MyPartition", "{queueTrigger}")] MyPoco poco, 
        ILogger log)
    {
        log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
    }
}

Následující příklad ukazuje funkci jazyka pochází .

public class TableStorage
{
    public class MyPoco : TableEntity
    {
        public string Text { get; set; }
    }

    [FunctionName("TableInput")]
    public static void TableInput(
        [QueueTrigger("table-items")] string input, 
        [Table("MyTable", "MyPartition")] IQueryable<MyPoco> pocos, 
        ILogger log)
    {
        foreach (MyPoco poco in pocos)
        {
            log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
        }
    }
}

Rozšíření Azure Tables

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, čte klíč řádku z fronty, která slouží k získání řádku ze vstupní tabulky. Výraz {queueTrigger} sváže klíč řádku s metadaty zprávy, což je řetězec zprávy.

[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í funkce aktivovaná frontou vrátí prvních 5 entit jako hodnotu IEnumerable<T>klíče oddílu nastavenou jako zprávu fronty.

[Function("TestFunction")]
public static void Run([QueueTrigger("myqueue", Connection = "AzureWebJobsStorage")] string partition,
    [TableInput("inTable", "{queueTrigger}", Take = 5, Filter = "Text eq 'test'", 
    Connection = "AzureWebJobsStorage")] IEnumerable<MyTableData> tableInputs,
    FunctionContext context)
{
    var logger = context.GetLogger("TestFunction");
    logger.LogInformation(partition);
    foreach (MyTableData tableInput in tableInputs)
    {
        logger.LogInformation($"PK={tableInput.PartitionKey}, RK={tableInput.RowKey}, Text={tableInput.Text}");
    }
}

Filter Vlastnosti Take se používají k omezení počtu vrácených entit.

Kombinované rozšíření Azure Storage

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

{
    var tableEntities = table.QueryAsync<TableEntity>(filter: $"RowKey eq '{rowKey}'");

    await foreach (TableEntity entity in tableEntities)
    {
        _logger.LogInformation("PK={pk}, RK={rk}, Text={t}", entity.PartitionKey, entity.RowKey, entity["Text"]);
    }

Následující funkce, která je spuštěna triggerem Queue Storage, čte klíč řádku z fronty, která slouží k získání řádku ze vstupní tabulky. Výraz {queueTrigger} sváže klíč řádku s metadaty zprávy, což je řetězec zprávy.

namespace SampleApp
{
    public class TableFunction
    {
        private readonly ILogger<TableFunction> _logger;

        public TableFunction(ILogger<TableFunction> logger)
        {
            _logger = logger;
        }

        /// <summary>
        /// This function demonstrates binding to a single <see cref="TableClient"/>
        /// and using the client for output.
        /// </summary>
        [Function(nameof(TableFunction))]
        public async Task Run(
            [QueueTrigger("table-items")] string rowKey,

Následující funkce aktivovaná frontou vrátí prvních 5 entit jako hodnotu IEnumerable<T>klíče oddílu nastavenou jako zprávu fronty.

[Function("TestFunction")]
public static void Run([QueueTrigger("myqueue", Connection = "AzureWebJobsStorage")] string partition,
    [TableInput("inTable", "{queueTrigger}", Take = 5, Filter = "Text eq 'test'", 
    Connection = "AzureWebJobsStorage")] IEnumerable<MyTableData> tableInputs,
    FunctionContext context)
{
    var logger = context.GetLogger("TestFunction");
    logger.LogInformation(partition);
    foreach (MyTableData tableInput in tableInputs)
    {
        logger.LogInformation($"PK={tableInput.PartitionKey}, RK={tableInput.RowKey}, Text={tableInput.Text}");
    }
}

Filter Vlastnosti Take se používají k omezení počtu vrácených entit.

Funkce 1.x

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

Následující příklad ukazuje funkci aktivovanou protokolem HTTP, která vrátí seznam objektů osob, které jsou v zadaném oddílu v Table Storage. V příkladu se klíč oddílu extrahuje ze trasy HTTP a název tabulky a připojení jsou z nastavení funkce.

public class Person {
    private String PartitionKey;
    private String RowKey;
    private String Name;

    public String getPartitionKey() { return this.PartitionKey; }
    public void setPartitionKey(String key) { this.PartitionKey = key; }
    public String getRowKey() { return this.RowKey; }
    public void setRowKey(String key) { this.RowKey = key; }
    public String getName() { return this.Name; }
    public void setName(String name) { this.Name = name; }
}

@FunctionName("getPersonsByPartitionKey")
public Person[] get(
        @HttpTrigger(name = "getPersons", methods = {HttpMethod.GET}, authLevel = AuthorizationLevel.FUNCTION, route="persons/{partitionKey}") HttpRequestMessage<Optional<String>> request,
        @BindingName("partitionKey") String partitionKey,
        @TableInput(name="persons", partitionKey="{partitionKey}", tableName="%MyTableName%", connection="MyConnectionString") Person[] persons,
        final ExecutionContext context) {

    context.getLogger().info("Got query for person related to persons with partition key: " + partitionKey);

    return persons;
}

Poznámka TableInput může také extrahovat vazby z textu json požadavku, jak ukazuje následující příklad.

@FunctionName("GetPersonsByKeysFromRequest")
public HttpResponseMessage get(
        @HttpTrigger(name = "getPerson", methods = {HttpMethod.GET}, authLevel = AuthorizationLevel.FUNCTION, route="query") HttpRequestMessage<Optional<String>> request,
        @TableInput(name="persons", partitionKey="{partitionKey}", rowKey = "{rowKey}", tableName="%MyTableName%", connection="MyConnectionString") Person person,
        final ExecutionContext context) {

    if (person == null) {
        return request.createResponseBuilder(HttpStatus.NOT_FOUND)
                    .body("Person not found.")
                    .build();
    }

    return request.createResponseBuilder(HttpStatus.OK)
                    .header("Content-Type", "application/json")
                    .body(person)
                    .build();
}

Následující příklad používá filtr k dotazování na osoby s konkrétním názvem v tabulce Azure a omezuje počet možných shod na 10 výsledků.

@FunctionName("getPersonsByName")
public Person[] get(
        @HttpTrigger(name = "getPersons", methods = {HttpMethod.GET}, authLevel = AuthorizationLevel.FUNCTION, route="filter/{name}") HttpRequestMessage<Optional<String>> request,
        @BindingName("name") String name,
        @TableInput(name="persons", filter="Name eq '{name}'", take = "10", tableName="%MyTableName%", connection="MyConnectionString") Person[] persons,
        final ExecutionContext context) {

    context.getLogger().info("Got query for person related to persons with name: " + name);

    return persons;
}

Následující příklad ukazuje vstupní vazbu tabulky, která používá trigger fronty ke čtení jednoho řádku tabulky. Vazba určuje a partitionKeyrowKey. Hodnota rowKey {queueTrigger} označuje, že klíč řádku pochází z řetězce zprávy fronty.

Model v4

import { app, input, InvocationContext } from '@azure/functions';

const tableInput = input.table({
    tableName: 'Person',
    partitionKey: 'Test',
    rowKey: '{queueTrigger}',
    connection: 'MyStorageConnectionAppSetting',
});

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

export async function storageQueueTrigger1(queueItem: unknown, context: InvocationContext): Promise<void> {
    context.log('Node.js queue trigger function processed work item', queueItem);
    const person = <PersonEntity>context.extraInputs.get(tableInput);
    context.log('Person entity name: ' + person.Name);
}

app.storageQueue('storageQueueTrigger1', {
    queueName: 'myqueue-items',
    connection: 'MyStorageConnectionAppSetting',
    extraInputs: [tableInput],
    handler: storageQueueTrigger1,
});

Model v3

Ukázky TypeScriptu nejsou zdokumentované pro model v3.

Model v4

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

const tableInput = input.table({
    tableName: 'Person',
    partitionKey: 'Test',
    rowKey: '{queueTrigger}',
    connection: 'MyStorageConnectionAppSetting',
});

app.storageQueue('storageQueueTrigger1', {
    queueName: 'myqueue-items',
    connection: 'MyStorageConnectionAppSetting',
    extraInputs: [tableInput],
    handler: (queueItem, context) => {
        context.log('Node.js queue trigger function processed work item', queueItem);
        const person = context.extraInputs.get(tableInput);
        context.log('Person entity name: ' + person.Name);
    },
});

Model v3

{
  "bindings": [
    {
      "queueName": "myqueue-items",
      "connection": "MyStorageConnectionAppSetting",
      "name": "myQueueItem",
      "type": "queueTrigger",
      "direction": "in"
    },
    {
      "name": "personEntity",
      "type": "table",
      "tableName": "Person",
      "partitionKey": "Test",
      "rowKey": "{queueTrigger}",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "in"
    }
  ],
  "disabled": false
}

Oddíl konfigurace vysvětluje tyto vlastnosti.

Tady je javascriptový kód:

module.exports = async function (context, myQueueItem) {
    context.log('Node.js queue trigger function processed work item', myQueueItem);
    context.log('Person entity name: ' + context.bindings.personEntity.Name);
};

Následující funkce používá trigger fronty ke čtení jednoho řádku tabulky jako vstupu do funkce.

V tomto příkladu konfigurace vazby určuje explicitní hodnotu tabulky partitionKey a používá výraz k předání do objektu rowKey. Výraz rowKey označuje, {queueTrigger}že klíč řádku pochází z řetězce zprávy fronty.

Konfigurace vazby v function.json:

{
  "bindings": [
    {
      "queueName": "myqueue-items",
      "connection": "MyStorageConnectionAppSetting",
      "name": "MyQueueItem",
      "type": "queueTrigger",
      "direction": "in"
    },
    {
      "name": "PersonEntity",
      "type": "table",
      "tableName": "Person",
      "partitionKey": "Test",
      "rowKey": "{queueTrigger}",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "in"
    }
  ],
  "disabled": false
}

Kód PowerShellu v souboru run.ps1:

param($MyQueueItem, $PersonEntity, $TriggerMetadata)
Write-Host "PowerShell queue trigger function processed work item: $MyQueueItem"
Write-Host "Person entity name: $($PersonEntity.Name)"

Následující funkce používá trigger HTTP ke čtení jednoho řádku tabulky jako vstupu do funkce.

V tomto příkladu konfigurace vazby určuje explicitní hodnotu tabulky partitionKey a používá výraz k předání do objektu rowKey. Výraz rowKey označuje, {id} že klíč řádku pochází z {id} části trasy v požadavku.

v2

import json
import azure.functions as func

app = func.FunctionApp()

@app.route(route="messages/{id}")
@app.table_input(arg_name="messageJSON",
                 connection="AzureWebJobsStorage",
                 table_name="messages",
                 row_key='{id}',
                 partition_key="message")
def table_in_binding(req: func.HttpRequest, messageJSON):
    message = json.loads(messageJSON)
    return func.HttpResponse(f"Table row: {messageJSON}")

Pomocí této jednoduché vazby nemůžete programově zpracovat případ, ve kterém se nenajde žádný řádek s ID klíče řádku. K podrobnějšímu výběru dat použijte sadu SDK úložiště.

v1

Konfigurace vazby v souboru function.json :

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "messageJSON",
      "type": "table",
      "tableName": "messages",
      "partitionKey": "message",
      "rowKey": "{id}",
      "connection": "AzureWebJobsStorage",
      "direction": "in"
    },
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ],
      "route": "messages/{id}"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    }
  ],
  "disabled": false
}

Kód Pythonu v souboru __init__.py :

import json

import azure.functions as func

def main(req: func.HttpRequest, messageJSON) -> func.HttpResponse:

    message = json.loads(messageJSON)
    return func.HttpResponse(f"Table row: {messageJSON}")

Pomocí této jednoduché vazby nemůžete programově zpracovat případ, ve kterém se nenajde žádný řádek s ID klíče řádku. K podrobnějšímu výběru dat použijte sadu SDK úložiště.

Atributy

Knihovny C# v procesu i izolovaného pracovního procesu používají atributy k definování funkce. Skript jazyka C# místo toho používá konfigurační soubor function.json, jak je popsáno v průvodci skriptováním jazyka C#.

Izolovaný model pracovního procesu

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

Vlastnost atributu	Popis
Název tabulky	Název tabulky.
PartitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst.
RowKey	Nepovinné. Klíč řádku entity tabulky, který se má přečíst.
Vzít	Nepovinné. Maximální počet entit, které se mají načíst do objektu IEnumerable<T>. Nelze použít s RowKey.
Filtr	Nepovinné. Výraz filtru OData pro entity, které se mají číst do objektu IEnumerable<T>. Nelze použít s RowKey.
Připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Model v procesu

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

Vlastnost atributu	Popis
Název tabulky	Název tabulky.
PartitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst. Pokyny k použití této vlastnosti najdete v části Využití .
RowKey	Nepovinné. Klíč řádku jedné entity tabulky, která se má přečíst. Nelze použít s Take nebo Filter.
Vzít	Nepovinné. Maximální počet entit, které se mají vrátit. Nelze použít s RowKey.
Filtr	Nepovinné. Výraz filtru OData pro entity, které se mají vrátit z tabulky. Nelze použít s RowKey.
Připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Konstruktor atributu přebírá název tabulky, klíč oddílu a klíč řádku, jak je znázorněno v následujícím příkladu:

[FunctionName("TableInput")]
public static void Run(
    [QueueTrigger("table-items")] string input, 
    [Table("MyTable", "Http", "{queueTrigger}")] MyPoco poco, 
    ILogger log)
{
    ...
}

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

[FunctionName("TableInput")]
public static void Run(
    [QueueTrigger("table-items")] string input, 
    [Table("MyTable", "Http", "{queueTrigger}", Connection = "StorageConnectionAppSetting")] MyPoco poco, 
    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.

Poznámky

V knihovně modulu runtime funkcí Java použijte poznámku @TableInput k parametrům, jejichž hodnota pochází z table storage. Tuto poznámku lze použít s nativními typy Javy, POJOs nebo hodnotami null s použitím Optional<T>. Tato poznámka podporuje následující prvky:

Element (Prvek)	Popis
Jméno	Název proměnné, která představuje tabulku nebo entitu v kódu funkce.
tableName	Název tabulky.
partitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst.
rowKey	Nepovinné. Klíč řádku entity tabulky, který se má přečíst.
vzít	Nepovinné. Maximální počet entit, které se mají přečíst.
filtr	Nepovinné. Výraz filtru OData pro vstup tabulky.
připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Konfigurace

Model v4

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

Vlastnost	Popis
tableName	Název tabulky.
partitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst.
rowKey	Nepovinné. Klíč řádku entity tabulky, který se má přečíst. Nelze použít s take nebo filter.
vzít	Nepovinné. Maximální počet entit, které se mají vrátit. Nelze použít s rowKey.
filtr	Nepovinné. Výraz filtru OData pro entity, které se mají vrátit z tabulky. Nelze použít s rowKey.
připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Model v3

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

Vlastnost	Popis
typ	Musí být nastavena na tablehodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
směr	Musí být nastavena na inhodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
Jméno	Název proměnné, která představuje tabulku nebo entitu v kódu funkce.
tableName	Název tabulky.
partitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst.
rowKey	Nepovinné. Klíč řádku entity tabulky, který se má přečíst. Nelze použít s take nebo filter.
vzít	Nepovinné. Maximální počet entit, které se mají vrátit. Nelze použít s rowKey.
filtr	Nepovinné. Výraz filtru OData pro entity, které se mají vrátit z tabulky. Nelze použít s rowKey.
připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Konfigurace

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

vlastnost function.json	Popis
typ	Musí být nastavena na tablehodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
směr	Musí být nastavena na inhodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
Jméno	Název proměnné, která představuje tabulku nebo entitu v kódu funkce.
tableName	Název tabulky.
partitionKey	Nepovinné. Klíč oddílu entity tabulky, který se má přečíst.
rowKey	Nepovinné. Klíč řádku entity tabulky, který se má přečíst. Nelze použít s take nebo filter.
vzít	Nepovinné. Maximální počet entit, které se mají vrátit. Nelze použít s rowKey.
filtr	Nepovinné. Výraz filtru OData pro entity, které se mají vrátit z tabulky. Nelze použít s rowKey.
připojení	Název nastavení aplikace nebo nastavení kolekce, která určuje, jak se připojit ke službě Table Service. Viz Připojení.

Při místním vývoji přidejte nastavení aplikace do souboru local.settings.json v kolekci Values .

Propojení

Vlastnost connection je nastavena na klíč v nastavení aplikace, který vrací hodnotu používanou runtime Functions k připojení k úložnému účtu používanému rozšířením. Hodnota nastavení vlastnosti spojení závisí na typu spojení:

• Spravované připojení identity: Vlastnost connection je sdílená <CONNECTION_NAME_PREFIX> skupinou nastavení, která společně definují připojení založené na identitě k úložnému účtu. Pro více informací viz Definujte identity connections.
• Key Vault reference: Nastavení connection vlastnosti vrací Azure Key Vault reference na místo, kde je připojovací řetězec centrálně udržován. Pro více informací viz Definujte spojení Key Vault.
• App Configuration reference: Nastavení connection vlastnosti vrací referenci Azure App Configuration, která vrací připojovací řetězec nebo Key Vault reference. Pro více informací viz Azure App Configuration v článku o připojeních.
• Connection string: Nastavení connection vlastnosti vrací skutečný storage account připojovací řetězec. Protože připojovací řetězec obsahuje sdílené tajné klíče, měli byste zvážit použití spravovaného identity connection, pokud je to možné. Pro více informací viz Definujte souvislosti.

Pro více informací o vazbách spojení viz Správa spojení v Azure Functions. Pokud chcete získat připojovací řetězec, postupujte podle kroků uvedených v tématu Správa klíčů k účtu úložiště.

Když nastavíte connection klíč nebo prefix klíče jménem AzureWebJobsStorage nebo prázdný řetězec, rozšíření vázání používá výchozí účet hostitelského úložiště. Pro více informací viz Optimalizace výkonu úložiště.

Využití

Použití vazby závisí na verzi balíčku rozšíření a na způsobu použití jazyka C# ve vaší aplikaci funkcí, což může být jedna z následujících možností:

Izolovaný model pracovního procesu

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

Model v procesu

Knihovna tříd v procesu je zkompilovaná funkce jazyka C#, která běží ve stejném procesu jako modul runtime služby Functions.

Zvolte verzi, abyste zobrazili podrobnosti o využití pro režim a verzi.

Rozšíření Azure Tables

Pokud chcete vrátit konkrétní entitu podle klíče, použijte parametr vazby, který je odvozen od TableEntity.

Pokud chcete spouštět dotazy, které vracejí více entit, vytvořte vazbu na objekt [TableClient]. Pomocí tohoto objektu pak můžete vytvářet a spouštět dotazy vůči vázané tabulce. Všimněte si, že [TableClient] a související rozhraní API patří do oboru názvů Azure.Data.Tables .

Kombinované rozšíření Azure Storage

Pokud chcete vrátit konkrétní entitu podle klíče, použijte parametr vazby, který je odvozen od TableEntity.

Pokud chcete spouštět dotazy, které vracejí více entit, vytvořte vazbu na objekt CloudTable . Pomocí tohoto objektu pak můžete vytvářet a spouštět dotazy vůči vázané tabulce. Všimněte si, že CloudTable a související rozhraní API patří do oboru názvů Microsoft.Azure.Cosmos.Table .

Funkce 1.x

Pokud chcete vrátit konkrétní entitu podle klíče, použijte parametr vazby, který je odvozen od TableEntity. TableNameKonkrétní , PartitionKeya RowKey slouží k pokusu a získání konkrétní entity z tabulky.

Pokud chcete spouštět dotazy, které vracejí více entit, vytvořte vazbu na IQueryable<T> typ, který dědí z TableEntity.

Rozšíření Azure Tables

Při práci s jednou entitou tabulky může vstupní vazba Azure Tables svázat s následujícími typy:

Typ	Popis
Serializovatelný typ JSON, který implementuje ITableEntity	Funkce se pokusí deserializovat entitu do prostého typu objektu CLR (POCO). Typ musí implementovat ITableEntity nebo musí mít řetězcovou RowKey vlastnost a řetězcovou PartitionKey vlastnost.
TableEntity1	Entita jako typ podobný slovníku.

Při práci s více entitami z dotazu může vstupní vazba Tabulek Azure svázat s následujícími typy:

Typ	Popis
IEnumerable<T> kde T implementuje ITableEntity	Výčet entit vrácených dotazem. Každá položka představuje jednu entitu. Typ musí implementovat T nebo musí mít řetězcovou vlastnost a řetězcovou RowKeyPartitionKey vlastnost.
TableClient1	Klient připojený k tabulce. To nabízí největší kontrolu nad zpracováním tabulky a lze ji použít k zápisu, pokud má připojení dostatečná oprávnění.

¹ Pokud chcete použít tyto typy, musíte odkazovat na Microsoft.Azure.Functions.Worker.Extensions.Tables 1.2.0 nebo novější a běžné závislosti pro vazby typu sady SDK.

Kombinované rozšíření Azure Storage

Pokud chcete vrátit konkrétní entitu podle klíče, použijte prostý starý objekt CLR (POCO). TableNameKonkrétní , PartitionKeya RowKey slouží k pokusu a získání konkrétní entity z tabulky.

Při vracení více entit jako objektu IEnumerable<T>můžete místo toho použít Take a Filter vlastnosti k omezení sady výsledků.

Funkce 1.x

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

Atribut TableInput poskytuje přístup k řádku tabulky, který funkci aktivoval.

Model v4

Získání vstupních dat řádku pomocí .context.extraInputs.get()

Model v3

Získejte vstupní data řádku pomocí místa context.bindings.<name> , kde <name> je hodnota zadaná ve name vlastnosti function.json.

Data se předávají vstupnímu parametru zadanému name klíčem v souboru function.json . Určení typu The partitionKey a rowKey umožňuje filtrovat podle konkrétních záznamů.

Data tabulky se funkci předávají jako řetězec JSON. De-serializace zprávy voláním json.loads , jak je znázorněno ve vstupním příkladu.

Konkrétní podrobnosti o využití najdete v příkladu.

Další kroky

• Zápis dat tabulky z funkce