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

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 C#, která čte více řádků tabulky, ze TableEntitykterých MyPoco třída 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}");
    }
}

Take Vlastnosti Filter 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}");
    }
}

Take Vlastnosti Filter 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.

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
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.
Vezměte si	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í iony.

Model v procesu

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

Vlastnost atributu	Popis
TableName	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.
Vezměte si	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í iony.

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.
filter	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í iony.

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.
filter	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í iony.

Model v3

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

Vlastnost	Popis
type	Musí být nastavena na tablehodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
direction	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.
filter	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í iony.

Konfigurace

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

vlastnost function.json	Popis
type	Musí být nastavena na tablehodnotu . Tato vlastnost se nastaví automaticky při vytváření vazby na webu Azure Portal.
direction	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.
filter	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í iony.

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

Propojení

Vlastnost connection je odkazem na konfiguraci prostředí, která určuje, jak se má aplikace připojit k tabulkové službě. Může zadat:

• Název nastavení aplikace obsahující připojovací řetězec
• Název sdílené předpony pro více nastavení aplikace, společně definující připojení založené na identitě

Pokud je nakonfigurovaná hodnota přesná shoda pro jedno nastavení i shodu předpony pro jiná nastavení, použije se přesná shoda.

Connection string

Pokud chcete získat připojovací řetězec pro tabulky ve službě Azure Table Storage, postupujte podle kroků uvedených v tématu Správa přístupových klíčů účtu úložiště. Pokud chcete získat připojovací řetězec pro tabulky ve službě Azure Cosmos DB for Table, postupujte podle kroků uvedených v nejčastějších dotazech ke službě Azure Cosmos DB for Table.

Tato připojovací řetězec by měla být uložena v nastavení aplikace s názvem, který connection odpovídá hodnotě určené vlastností konfigurace vazby.

Pokud název nastavení aplikace začíná na "AzureWebJobs", můžete zde zadat pouze zbytek názvu. Pokud například nastavíte connection "MyStorage", modul runtime Functions vyhledá nastavení aplikace s názvem AzureWebJobsMyStorage. Pokud necháte connection prázdné, modul runtime Služby Functions použije výchozí připojovací řetězec úložiště v nastavení aplikace, které je pojmenované AzureWebJobsStorage.

Připojení založená na identitách

Pokud používáte rozšíření Api pro tabulky, nemusíte používat připojovací řetězec s tajným kódem, můžete aplikaci použít identitu Microsoft Entra. To platí jenom při přístupu k tabulkám ve službě Azure Storage. Pokud chcete použít identitu, definujete nastavení pod běžnou předponou, která se mapuje na connection vlastnost v konfiguraci triggeru a vazby.

Pokud nastavujete connection azureWebJobsStorage, přečtěte si, Připojení hostování úložiště s identitou. Pro všechna ostatní připojení rozšíření vyžaduje následující vlastnosti:

Vlastnost	Šablona proměnné prostředí	Popis	Příklad hodnoty
Table Service URI	<CONNECTION_NAME_PREFIX>__tableServiceUri1	Identifikátor URI roviny dat služby Azure Storage, ke které se připojujete, pomocí schématu HTTPS.	<https:// storage_account_name.table.core.windows.net>

¹<CONNECTION_NAME_PREFIX>__serviceUri lze použít jako alias. Pokud jsou k dispozici oba formuláře, použije se tableServiceUri formulář. Formulář serviceUri nelze použít, pokud se má použít celková konfigurace připojení napříč objekty blob, frontami a/nebo tabulkami.

Pro přizpůsobení připojení mohou být nastaveny další vlastnosti. Viz Běžné vlastnosti pro připojení založená na identitě.

Formulář serviceUri se nedá použít, pokud se má celková konfigurace připojení použít napříč objekty blob, frontami a/nebo tabulkami ve službě Azure Storage. Identifikátor URI může určit pouze službu tabulky. Jako alternativu můžete zadat identifikátor URI speciálně pro každou službu pod stejnou předponou, což umožňuje použití jediného připojení.

Při hostovaní ve službě Azure Functions používají připojení založená na identitách spravovanou identitu. Identita přiřazená systémem se používá ve výchozím nastavení, i když je možné zadat identitu přiřazenou uživatelem s vlastnostmi a clientID vlastnostmicredential. Všimněte si, že konfigurace identity přiřazené uživatelem s ID prostředku se nepodporuje . Při spuštění v jiných kontextech, jako je místní vývoj, se místo toho použije vaše identita vývojáře, i když je možné ji přizpůsobit. Viz Místní vývoj s připojeními založenými na identitách.

Udělení oprávnění identitě

Jakákoli identita, kterou používáte, musí mít oprávnění k provedení zamýšlených akcí. U většiny služeb Azure to znamená, že potřebujete přiřadit roli v Azure RBAC pomocí předdefinovaných nebo vlastních rolí, které tato oprávnění poskytují.

Důležité

Cílová služba může zpřístupnit některá oprávnění, která nejsou nutná pro všechny kontexty. Pokud je to možné, dodržujte zásadu nejnižšího oprávnění a udělte identitě pouze požadovaná oprávnění. Pokud například aplikace potřebuje jen číst ze zdroje dat, použijte roli, která má oprávnění jen ke čtení. Přiřazení role, která také umožňuje zápis do této služby, by bylo nevhodné, protože by to bylo nadměrné oprávnění pro operaci čtení. Podobně byste chtěli zajistit, aby přiřazení role bylo vymezeno pouze nad prostředky, které je potřeba číst.

Budete muset vytvořit přiřazení role, které poskytuje přístup k tabulkové službě Azure Storage za běhu. Role správy, jako je vlastník , nestačí. Následující tabulka ukazuje předdefinované role, které se doporučují při použití rozšíření Azure Tables pro Azure Storage v normálním provozu. Vaše aplikace může vyžadovat další oprávnění na základě kódu, který napíšete.

Typ vazby	Příklad předdefinovaných rolí (Azure Storage1)
Vstupní vazba	Čtenář dat tabulky služby Storage
Výstupní vazba	Přispěvatel dat tabulky úložiště

¹ Pokud se vaše aplikace místo toho připojuje k tabulkám ve službě Azure Cosmos DB for Table, použití identity se nepodporuje a připojení musí používat připojovací řetězec.

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> where T implements ITableEntity	Výčet entit vrácených dotazem. Každá položka představuje jednu entitu. Typ musí implementovat ITableEntity nebo musí mít řetězcovou RowKey vlastnost a řetězcovou PartitionKeyT 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