Liaisons Stockage Blob Azure pour Azure FunctionsAzure Blob storage bindings for Azure Functions

Cet article explique comment utiliser des liaisons Stockage Blob Azure dans Azure Functions.This article explains how to work with Azure Blob storage bindings in Azure Functions. Azure Functions prend en charge les liaisons de déclencheur, d’entrée et de sortie pour les objets blob.Azure Functions supports trigger, input, and output bindings for blobs. Cet article propose une section pour chaque liaison :The article includes a section for each binding:

Il s’agit des informations de référence pour les développeurs Azure Functions.This is reference information for Azure Functions developers. Si vous ne connaissez pas bien Azure Functions, commencez par consulter les ressources suivantes :If you're new to Azure Functions, start with the following resources:

Notes

Utilisez le déclencheur Event Grid au lieu du déclencheur de stockage Blob pour les comptes de stockage blob uniquement, afin de bénéficier d’une scalabilité élevée et pour réduire la latence.Use the Event Grid trigger instead of the Blob storage trigger for blob-only storage accounts, for high scale, or to reduce latency. Pour plus d’informations, consultez la section Déclencheur.For more information, see the Trigger section.

Packages - Functions 1.xPackages - Functions 1.x

Les liaisons du Stockage Blob sont fournies dans le package NuGet Microsoft.Azure.WebJobs, version 2.x.The Blob storage bindings are provided in the Microsoft.Azure.WebJobs Nuget package, version 2.x. Le code source du package se trouve dans le référentiel GitHub azure-webjobs-sdk.Source code for the package is in the azure-webjobs-sdk GitHub repository.

La prise en charge de cette liaison est automatique dans tous les environnements de développement.Support for this binding is automatically provided in all development environments. Vous n’avez pas besoin d’installer manuellement le package ou d’enregistrer l’extension.You don't have to manually install the package or register the extension.

Version du kit SDK Stockage Azure dans Functions 1.xAzure Storage SDK version in Functions 1.x

Dans Functions 1.x, les déclencheurs et les liaisons de stockage utilisent la version 7.2.1 du kit SDK Stockage Azure (package NuGet WindowsAzure.Storage).In Functions 1.x, the Storage triggers and bindings use version 7.2.1 of the Azure Storage SDK (WindowsAzure.Storage NuGet package). Si vous référencez une version différente du kit SDK Stockage Azure et établissez une liaison avec un type du kit SDK Stockage Azure dans votre signature de fonction, le runtime de Functions peut signaler ne pas pouvoir établir de liaison avec ce type.If you reference a different version of the Storage SDK, and you bind to a Storage SDK type in your function signature, the Functions runtime may report that it can't bind to that type. La solution consiste à s’assurer que votre projet référence WindowsAzure.Storage 7.2.1.The solution is to make sure your project references WindowsAzure.Storage 7.2.1.

Packages – Functions 2.x et versions ultérieuresPackages - Functions 2.x and higher

Les liaisons du Stockage Blob sont fournies dans le package NuGet Microsoft.Azure.WebJobs.Extensions.Storage, version 3.x.The Blob storage bindings are provided in the Microsoft.Azure.WebJobs.Extensions.Storage Nuget package, version 3.x. Le code source du package se trouve dans le référentiel GitHub azure-webjobs-sdk.Source code for the package is in the azure-webjobs-sdk GitHub repository.

Le tableau suivant indique comment ajouter la prise en charge de cette liaison dans chaque environnement de développement.The following table tells how to add support for this binding in each development environment.

Environnement de développementDevelopment environment Pour ajouter la prise en chargeTo add support
Développement local - Bibliothèque de classes C#Local development - C# class library Installer le package.Install the package
Développement local - Script C#, JavaScript, F#, Java et PythonLocal development - C# script, JavaScript, F#, Java and Python Enregistrer l’extensionRegister the extension
Développement sur le portailPortal development Installer lors de l’ajout d’une liaison de sortieInstall when adding output binding

Pour apprendre comment mettre à jour les extensions de liaison existantes dans le portail sans avoir à republier votre projet d'application de fonction, voir Mettre à jour vos extensions.To learn how to update existing binding extensions in the portal without having to republish your function app project, see Update your extensions.

DéclencheurTrigger

Le déclencheur de stockage Blob démarre une fonction lors de la détection d’un objet blob nouveau ou mis à jour.The Blob storage trigger starts a function when a new or updated blob is detected. Le contenu de l’objet blob est fourni comme entrée de la fonction.The blob contents are provided as input to the function.

Le déclencheur Event Grid contient la prise en charge intégrée des événements blob et peut également être utilisé pour démarrer une fonction lors de la détection d’un objet blob nouveau ou mis à jour.The Event Grid trigger has built-in support for blob events and can also be used to start a function when a new or updated blob is detected. Pour obtenir un exemple, consultez le tutoriel Redimensionnement d’image avec Event Grid.For an example, see the Image resize with Event Grid tutorial.

Utilisez Event Grid au lieu du déclencheur de stockage Blob pour les scénarios suivants :Use Event Grid instead of the Blob storage trigger for the following scenarios:

  • Comptes de stockage d’objets blobBlob storage accounts
  • Scalabilité élevéeHigh scale
  • Réduction de la latenceMinimizing latency

Comptes de stockage d’objets blobBlob storage accounts

Les comptes Stockage Blob sont pris en charge pour les liaisons d’entrée et de sortie d’objet blob, mais pas pour les déclencheurs d’objet blob.Blob storage accounts are supported for blob input and output bindings but not for blob triggers. Les déclencheurs de stockage d’objets blob nécessitent un compte de stockage à usage général.Blob storage triggers require a general-purpose storage account.

Scalabilité élevéeHigh scale

La scalabilité élevée peut être définie comme des conteneurs qui contiennent plus de 100 000 objets blob ou des comptes de stockage avec plus de 100 mises à jour d’objets blob par seconde.High scale can be loosely defined as containers that have more than 100,000 blobs in them or storage accounts that have more than 100 blob updates per second.

Problèmes de latenceLatency issues

Si votre application de fonction est dans le plan Consommation, il peut y avoir jusqu’à 10 minutes de délai dans le traitement des nouveaux objets blob si une application de fonction est devenue inactive.If your function app is on the Consumption plan, there can be up to a 10-minute delay in processing new blobs if a function app has gone idle. Pour éviter toute latence, vous pouvez passer à un plan App Service dans lequel est activé AlwaysOn.To avoid this latency, you can switch to an App Service plan with Always On enabled. Vous pouvez également utiliser un déclencheur Event Grid avec votre compte de stockage Blob.You can also use an Event Grid trigger with your Blob storage account. Pour obtenir un exemple, consultez le tutoriel Event Grid.For an example, see the Event Grid tutorial.

Déclencheur de stockage de file d’attenteQueue storage trigger

En dehors d’Event Grid, une autre alternative au traitement des objets blob est le déclencheur de stockage de file d’attente, mais il n’intègre pas la prise en charge des événements blob.Besides Event Grid, another alternative for processing blobs is the Queue storage trigger, but it has no built-in support for blob events. Vous devrez créer des messages de file d’attente pendant la création ou la mise à jour des objets blob.You would have to create queue messages when creating or updating blobs. Pour obtenir un exemple qui suppose que vous avez procédé ainsi, consultez l’exemple de liaison d’entrée d’objet blob plus loin dans cet article.For an example that assumes you've done that, see the blob input binding example later in this article.

Déclencheur - exempleTrigger - example

L’exemple suivant montre une fonction C# qui écrit une entrée de journal lorsqu’un objet blob est ajouté ou mis à jour dans le conteneur samples-workitems.The following example shows a C# function that writes a log when a blob is added or updated in the samples-workitems container.

[FunctionName("BlobTriggerCSharp")]        
public static void Run([BlobTrigger("samples-workitems/{name}")] Stream myBlob, string name, ILogger log)
{
    log.LogInformation($"C# Blob trigger function Processed blob\n Name:{name} \n Size: {myBlob.Length} Bytes");
}

La chaîne {name} dans le chemin d’accès du déclencheur d’objet blob samples-workitems/{name} crée une expression de liaison que vous pouvez utiliser dans le code de fonction pour accéder au nom de fichier de l’objet blob déclencheur.The string {name} in the blob trigger path samples-workitems/{name} creates a binding expression that you can use in function code to access the file name of the triggering blob. Pour plus d’informations, consultez la section Modèles de nom d’objet blob dans la suite de cet article.For more information, see Blob name patterns later in this article.

Pour plus d’informations sur l’attribut BlobTrigger, consultez Déclencheur - attributs.For more information about the BlobTrigger attribute, see Trigger - attributes.

Déclencheur - attributsTrigger - attributes

Dans les bibliothèques de classes C#, utilisez les attributs suivants pour configurer un déclencheur d’objet blob :In C# class libraries, use the following attributes to configure a blob trigger:

  • BlobTriggerAttributeBlobTriggerAttribute

    Le constructeur de l’attribut prend une chaîne de chemin qui indique le conteneur à surveiller et éventuellement un modèle de nom d’objet blob.The attribute's constructor takes a path string that indicates the container to watch and optionally a blob name pattern. Voici un exemple :Here's an example:

    [FunctionName("ResizeImage")]
    public static void Run(
        [BlobTrigger("sample-images/{name}")] Stream image,
        [Blob("sample-images-md/{name}", FileAccess.Write)] Stream imageSmall)
    {
        ....
    }
    

    Vous pouvez définir la propriété Connection pour spécifier le compte de stockage à utiliser, comme indiqué dans l’exemple suivant :You can set the Connection property to specify the storage account to use, as shown in the following example:

    [FunctionName("ResizeImage")]
    public static void Run(
        [BlobTrigger("sample-images/{name}", Connection = "StorageConnectionAppSetting")] Stream image,
        [Blob("sample-images-md/{name}", FileAccess.Write)] Stream imageSmall)
    {
        ....
    }
    

    Pour obtenir un exemple complet, consultez Exemple de déclencheur.For a complete example, see Trigger example.

  • StorageAccountAttributeStorageAccountAttribute

    Fournit une autre manière de spécifier le compte de stockage à utiliser.Provides another way to specify the storage account to use. Le constructeur prend le nom d’un paramètre d’application comportant une chaîne de connexion de stockage.The constructor takes the name of an app setting that contains a storage connection string. L’attribut peut être appliqué au niveau du paramètre, de la méthode ou de la classe.The attribute can be applied at the parameter, method, or class level. L’exemple suivant montre le niveau de la classe et celui de la méthode :The following example shows class level and method level:

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

Le compte de stockage à utiliser est déterminé dans l’ordre suivant :The storage account to use is determined in the following order:

  • La propriété Connection de l’attribut BlobTrigger.The BlobTrigger attribute's Connection property.
  • L’attribut StorageAccount appliqué au même paramètre que l’attribut BlobTrigger.The StorageAccount attribute applied to the same parameter as the BlobTrigger attribute.
  • L’attribut StorageAccount appliqué à la fonction.The StorageAccount attribute applied to the function.
  • L’attribut StorageAccount appliqué à la classe.The StorageAccount attribute applied to the class.
  • Le compte de stockage par défaut pour l’application de fonction (paramètre d’application « AzureWebJobsStorage »).The default storage account for the function app ("AzureWebJobsStorage" app setting).

Déclencheur - configurationTrigger - configuration

Le tableau suivant décrit les propriétés de configuration de liaison que vous définissez dans le fichier function.json et l’attribut BlobTrigger.The following table explains the binding configuration properties that you set in the function.json file and the BlobTrigger attribute.

Propriété function.jsonfunction.json property Propriété d’attributAttribute property DescriptionDescription
typetype n/an/a Cette propriété doit être définie sur blobTrigger.Must be set to blobTrigger. Cette propriété est définie automatiquement lorsque vous créez le déclencheur dans le portail Azure.This property is set automatically when you create the trigger in the Azure portal.
directiondirection n/an/a Cette propriété doit être définie sur in.Must be set to in. Cette propriété est définie automatiquement lorsque vous créez le déclencheur dans le portail Azure.This property is set automatically when you create the trigger in the Azure portal. Les exceptions sont notées à la section utilisation.Exceptions are noted in the usage section.
namename n/an/a Nom de la variable qui représente l’objet blob dans le code de la fonction.The name of the variable that represents the blob in function code.
pathpath BlobPathBlobPath Conteneur à superviser.The container to monitor. Peut être un modèle de nom d’objet blob.May be a blob name pattern.
connectionconnection ConnectionConnection Nom d’un paramètre d’application comportant la chaîne de connexion de stockage à utiliser pour cette liaison.The name of an app setting that contains the Storage connection string to use for this binding. Si le nom du paramètre d’application commence par « AzureWebJobs », vous ne pouvez spécifier que le reste du nom ici.If the app setting name begins with "AzureWebJobs", you can specify only the remainder of the name here. Par exemple, si vous définissez connection sur « MyStorage », le runtime Functions recherche un paramètre d’application qui est nommé « AzureWebJobsMyStorage ».For example, if you set connection to "MyStorage", the Functions runtime looks for an app setting that is named "AzureWebJobsMyStorage." Si vous laissez connection vide, le runtime Functions utilise la chaîne de connexion de stockage par défaut dans le paramètre d’application nommé AzureWebJobsStorage.If you leave connection empty, the Functions runtime uses the default Storage connection string in the app setting that is named AzureWebJobsStorage.

La chaîne de connexion doit être destinée à un compte de stockage à usage général, et non pas à un compte Stockage Blob.The connection string must be for a general-purpose storage account, not a Blob storage account.

Quand vous développez localement, les paramètres d’application vont dans le fichier local.settings.json.When you're developing locally, app settings go into the local.settings.json file.

Déclencheur - utilisationTrigger - usage

Vous pouvez utiliser les types de paramètres suivants pour l’objet blob déclencheur :You can use the following parameter types for the triggering blob:

  • Stream
  • TextReader
  • string
  • Byte[]
  • Un objet POCO sérialisable au format JSONA POCO serializable as JSON
  • ICloudBlob1ICloudBlob1
  • CloudBlockBlob1CloudBlockBlob1
  • CloudPageBlob1CloudPageBlob1
  • CloudAppendBlob1CloudAppendBlob1

1 requiert la liaison « inout » direction dans function.json ou FileAccess.ReadWrite dans une bibliothèque de classes C#.1 Requires "inout" binding direction in function.json or FileAccess.ReadWrite in a C# class library.

Si vous essayez de lier à un des types de SDK Stockage et obtenez un message d’erreur, vérifiez que vous avez une référence à la bonne version du SDK Stockage.If you try to bind to one of the Storage SDK types and get an error message, make sure that you have a reference to the correct Storage SDK version.

La liaison avec string, Byte[] ou POCO est recommandée uniquement si la taille de l’objet blob est petite, car tout le contenu de l’objet blob est chargé en mémoire.Binding to string, Byte[], or POCO is only recommended if the blob size is small, as the entire blob contents are loaded into memory. En général, il est préférable d’utiliser un type Stream ou CloudBlockBlob.Generally, it is preferable to use a Stream or CloudBlockBlob type. Pour plus d’informations, consultez Concurrence et utilisation de la mémoire plus loin dans cet article.For more information, see Concurrency and memory usage later in this article.

Déclencheur - modèles de nom d’objet blobTrigger - blob name patterns

Vous pouvez spécifier un modèle de nom d’objet blob dans la propriété path du fichier function.json ou dans le constructeur d’attribut BlobTrigger.You can specify a blob name pattern in the path property in function.json or in the BlobTrigger attribute constructor. Le modèle de nom peut être une expression de filtre ou de liaison.The name pattern can be a filter or binding expression. Les sections suivantes fournissent des exemples.The following sections provide examples.

Obtenir l’extension et le nom de fichierGet file name and extension

L’exemple suivant montre comment se lier séparément à l’extension et au nom de fichier de l’objet blob :The following example shows how to bind to the blob file name and extension separately:

"path": "input/{blobname}.{blobextension}",

Si l’objet blob est nommé original-Blob1.txt, les valeurs des variables blobname et blobextension dans le code de la fonction sont original-Blob1 et txt.If the blob is named original-Blob1.txt, the values of the blobname and blobextension variables in function code are original-Blob1 and txt.

Filtrer sur le nom de l’objet blobFilter on blob name

L’exemple suivant déclenche uniquement sur les objets blob du conteneur input qui commencent par la chaîne « original- » :The following example triggers only on blobs in the input container that start with the string "original-":

"path": "input/original-{name}",

Si le nom de l’objet blob est original-Blob1.txt, la valeur de la variable name dans le code de la fonction est Blob1.If the blob name is original-Blob1.txt, the value of the name variable in function code is Blob1.

Filtrer sur le type de fichierFilter on file type

L’exemple suivant ne déclenche que sur des fichiers .png :The following example triggers only on .png files:

"path": "samples/{name}.png",

Filtrer sur les accolades dans les noms de fichiersFilter on curly braces in file names

Pour rechercher les accolades dans les noms de fichiers, utilisez une séquence d’échappement sous la forme de deux accolades.To look for curly braces in file names, escape the braces by using two braces. L’exemple suivant filtre en recherchant les objets blob qui contiennent des accolades dans le nom :The following example filters for blobs that have curly braces in the name:

"path": "images/{{20140101}}-{name}",

Si l’objet blob est nommé {20140101}-soundfile.mp3, la valeur de la variable name dans le code de la fonction est soundfile.mp3.If the blob is named {20140101}-soundfile.mp3, the name variable value in the function code is soundfile.mp3.

Déclencheur - métadonnéesTrigger - metadata

Le déclencheur d’objet blob fournit plusieurs propriétés de métadonnées.The blob trigger provides several metadata properties. Ces propriétés peuvent être utilisées dans les expressions de liaison dans d’autres liaisons ou en tant que paramètres dans votre code.These properties can be used as part of binding expressions in other bindings or as parameters in your code. Ces valeurs ont la même sémantique que le type CloudBlob.These values have the same semantics as the CloudBlob type.

PropriétéProperty TypeType DescriptionDescription
BlobTrigger string Chemin de l’objet blob déclencheur.The path to the triggering blob.
Uri System.Uri URI de l’objet blob pour l’emplacement principal.The blob's URI for the primary location.
Properties BlobPropertiesBlobProperties Propriétés système de l’objet blob.The blob's system properties.
Metadata IDictionary<string,string> Métadonnées définies par l’utilisateur pour l’objet blob.The user-defined metadata for the blob.

Par exemple, les exemples JavaScript et Script C# suivants enregistrent le chemin d’accès à l’objet blob déclencheur, notamment le conteneur :For example, the following C# script and JavaScript examples log the path to the triggering blob, including the container:

public static void Run(string myBlob, string blobTrigger, ILogger log)
{
    log.LogInformation($"Full blob path: {blobTrigger}");
} 

Déclencheur - reçus d’objet blobTrigger - blob receipts

Le runtime Azure Functions vérifie qu’aucune fonction de déclencheur d’objet blob n’est appelée plusieurs fois pour un même objet blob, nouveau ou mis à jour.The Azure Functions runtime ensures that no blob trigger function gets called more than once for the same new or updated blob. Pour déterminer si la version d’un objet blob donné a été traitée, il gère des reçus d’objet blob.To determine if a given blob version has been processed, it maintains blob receipts.

Azure Functions stocke les reçus d’objet blob dans un conteneur appelé azure-webjobs-hosts dans le compte de stockage Azure de votre application de fonction (définie par le paramètre d’application AzureWebJobsStorage).Azure Functions stores blob receipts in a container named azure-webjobs-hosts in the Azure storage account for your function app (defined by the app setting AzureWebJobsStorage). Un reçu d’objet blob contient les informations suivantes :A blob receipt has the following information:

  • Fonction déclenchée (« <nom de l’application de fonction> .Functions. <nom de la fonction>  », par exemple : « MyFunctionApp.Functions.CopyBlob »)The triggered function ("<function app name>.Functions.<function name>", for example: "MyFunctionApp.Functions.CopyBlob")
  • Nom du conteneurThe container name
  • Type d’objet blob (« BlockBlob » ou « PageBlob »)The blob type ("BlockBlob" or "PageBlob")
  • Nom de l’objet blobThe blob name
  • Étiquette d’entité (identificateur de version de l’objet blob, par exemple : « 0x8D1DC6E70A277EF »)The ETag (a blob version identifier, for example: "0x8D1DC6E70A277EF")

Pour forcer le retraitement d’un objet blob, supprimez manuellement le reçu de l’objet blob du conteneur azure-webjobs-hosts.To force reprocessing of a blob, delete the blob receipt for that blob from the azure-webjobs-hosts container manually. Si le retraitement n’a pas lieu immédiatement, il se produira ultérieurement.While reprocessing might not occur immediately, it's guaranteed to occur at a later point in time.

Déclencheur - objets blob incohérentsTrigger - poison blobs

En cas d’échec d’une fonction de déclencheur d’objet blob, Azure Functions réessaie cette fonction jusqu’à 5 fois par défaut.When a blob trigger function fails for a given blob, Azure Functions retries that function a total of 5 times by default.

Si les 5 tentatives échouent, Azure Functions ajoute un message à une file d’attente de stockage nommée webjobs-blobtrigger-poison.If all 5 tries fail, Azure Functions adds a message to a Storage queue named webjobs-blobtrigger-poison. Le message en file d’attente associé aux objets blob incohérents correspond à un objet JSON, qui contient les propriétés suivantes :The queue message for poison blobs is a JSON object that contains the following properties:

  • FunctionId (au format <nom de l’application de fonctions> .Functions. <nom de la fonction> )FunctionId (in the format <function app name>.Functions.<function name>)
  • BlobType (« BlockBlob » ou « PageBlob »)BlobType ("BlockBlob" or "PageBlob")
  • ContainerNameContainerName
  • BlobNameBlobName
  • Étiquette d’entité (identificateur de version de l’objet blob, par exemple : « 0x8D1DC6E70A277EF »)ETag (a blob version identifier, for example: "0x8D1DC6E70A277EF")

Déclencheur : concurrence et utilisation de la mémoireTrigger - concurrency and memory usage

Le déclencheur de blob utilise une file d’attente en interne. Le nombre maximal d’appels de fonction concurrents est par conséquent contrôlé par la configuration des files d’attente dans host.json.The blob trigger uses a queue internally, so the maximum number of concurrent function invocations is controlled by the queues configuration in host.json. Les paramètres par défaut limitent la concurrence à 24 appels.The default settings limit concurrency to 24 invocations. Cette limite s’applique séparément à chaque fonction qui utilise un déclencheur de blob.This limit applies separately to each function that uses a blob trigger.

Le plan de consommation limite une application de fonction sur une machine virtuelle (VM) à 1,5 Go de mémoire.The consumption plan limits a function app on one virtual machine (VM) to 1.5 GB of memory. La mémoire est utilisée par chaque instance de la fonction qui s’exécutent simultanément et par le runtime de fonctions lui-même.Memory is used by each concurrently executing function instance and by the Functions runtime itself. Si une fonction déclenchée par blob charge le blob entier en mémoire, la mémoire maximale utilisée par cette fonction uniquement pour les blobs est 24 * la taille maximale du blob.If a blob-triggered function loads the entire blob into memory, the maximum memory used by that function just for blobs is 24 * maximum blob size. Par exemple, une application de fonction avec trois fonctions déclenchées par blob et les paramètres par défaut aurait une concurrence par machine virtuelle maximale de 3 * 24 = 72 appels de fonction.For example, a function app with three blob-triggered functions and the default settings would have a maximum per-VM concurrency of 3*24 = 72 function invocations.

Les fonctions JavaScript et Java chargent l’objet blob entier en mémoire et les fonctions C# le font si vous faites la liaison avec string, Byte[] ou POCO.JavaScript and Java functions load the entire blob into memory, and C# functions do that if you bind to string, Byte[], or POCO.

Déclencheur : interrogationTrigger - polling

L’interrogation fonctionne de façon hybride entre l’inspection des journaux et l’exécution d’analyses régulières des conteneurs.Polling works as a hybrid between inspecting logs and running periodic container scans. Les objets blob sont analysés dans des groupes de 10 000 à la fois avec un jeton de continuation utilisé entre les intervalles.Blobs are scanned in groups of 10,000 at a time with a continuation token used between intervals.

Avertissement

En outre, les journaux d’activité de stockage sont créés selon le principe du meilleur effort.In addition, storage logs are created on a "best effort" basis. Il n’existe aucune garantie que tous les événements sont capturés.There's no guarantee that all events are captured. Dans certaines conditions, des journaux d’activité peuvent être omis.Under some conditions, logs may be missed.

Si vous avez besoin de traitement d’objets blob plus rapide ou plus fiable, envisagez de créer un message de file d’attente quand vous créez l’objet blob.If you require faster or more reliable blob processing, consider creating a queue message when you create the blob. Ensuite, utilisez un déclencheur de file d’attente plutôt qu’un déclencheur d’objet blob pour traiter l’objet blob.Then use a queue trigger instead of a blob trigger to process the blob. Une autre option consiste à utiliser Event Grid ; consultez le didacticiel Automatiser le redimensionnement des images téléchargées à l’aide d’Event Grid.Another option is to use Event Grid; see the tutorial Automate resizing uploaded images using Event Grid.

EntréeInput

Utilisez une liaison d’entrée de stockage blob pour lire des objets blob.Use a Blob storage input binding to read blobs.

Entrée - exempleInput - example

L’exemple suivant est une fonction C# qui utilise un déclencheur de file d’attente et une liaison d’entrée d’objet blob.The following example is a C# function that uses a queue trigger and an input blob binding. Le message en file d’attente contient le nom du blob et la fonction journalise la taille du blob.The queue message contains the name of the blob, and the function logs the size of the blob.

[FunctionName("BlobInput")]
public static void Run(
    [QueueTrigger("myqueue-items")] string myQueueItem,
    [Blob("samples-workitems/{queueTrigger}", FileAccess.Read)] Stream myBlob,
    ILogger log)
{
    log.LogInformation($"BlobInput processed blob\n Name:{myQueueItem} \n Size: {myBlob.Length} bytes");
}

Entrée - attributsInput - attributes

Dans les bibliothèques de classes C#, utilisez l’attribut BlobAttribute.In C# class libraries, use the BlobAttribute.

Le constructeur de l’attribut prend le chemin de l’objet blob et un paramètre FileAccess indiquant la lecture ou l’écriture, comme indiqué dans l’exemple suivant :The attribute's constructor takes the path to the blob and a FileAccess parameter indicating read or write, as shown in the following example:

[FunctionName("BlobInput")]
public static void Run(
    [QueueTrigger("myqueue-items")] string myQueueItem,
    [Blob("samples-workitems/{queueTrigger}", FileAccess.Read)] Stream myBlob,
    ILogger log)
{
    log.LogInformation($"BlobInput processed blob\n Name:{myQueueItem} \n Size: {myBlob.Length} bytes");
}

Vous pouvez définir la propriété Connection pour spécifier le compte de stockage à utiliser, comme indiqué dans l’exemple suivant :You can set the Connection property to specify the storage account to use, as shown in the following example:

[FunctionName("BlobInput")]
public static void Run(
    [QueueTrigger("myqueue-items")] string myQueueItem,
    [Blob("samples-workitems/{queueTrigger}", FileAccess.Read, Connection = "StorageConnectionAppSetting")] Stream myBlob,
    ILogger log)
{
    log.LogInformation($"BlobInput processed blob\n Name:{myQueueItem} \n Size: {myBlob.Length} bytes");
}

Vous pouvez utiliser l’attribut StorageAccount pour spécifier le compte de stockage au niveau de la classe, de la méthode ou du paramètre.You can use the StorageAccount attribute to specify the storage account at class, method, or parameter level. Pour plus d’informations, consultez Déclencheur - attributs.For more information, see Trigger - attributes.

Entrée - configurationInput - configuration

Le tableau suivant décrit les propriétés de configuration de liaison que vous définissez dans le fichier function.json et l’attribut Blob.The following table explains the binding configuration properties that you set in the function.json file and the Blob attribute.

Propriété function.jsonfunction.json property Propriété d’attributAttribute property DescriptionDescription
typetype n/an/a Cette propriété doit être définie sur blob.Must be set to blob.
directiondirection n/an/a Cette propriété doit être définie sur in.Must be set to in. Les exceptions sont notées à la section utilisation.Exceptions are noted in the usage section.
namename n/an/a Nom de la variable qui représente l’objet blob dans le code de la fonction.The name of the variable that represents the blob in function code.
pathpath BlobPathBlobPath Chemin de l’objet blob.The path to the blob.
connectionconnection ConnectionConnection Nom d’un paramètre d’application comportant la chaîne de connexion de stockage à utiliser pour cette liaison.The name of an app setting that contains the Storage connection string to use for this binding. Si le nom du paramètre d’application commence par « AzureWebJobs », vous ne pouvez spécifier que le reste du nom ici.If the app setting name begins with "AzureWebJobs", you can specify only the remainder of the name here. Par exemple, si vous définissez connection sur « MyStorage », le runtime Functions recherche un paramètre d’application qui est nommé « AzureWebJobsMyStorage ».For example, if you set connection to "MyStorage", the Functions runtime looks for an app setting that is named "AzureWebJobsMyStorage." Si vous laissez connection vide, le runtime Functions utilise la chaîne de connexion de stockage par défaut dans le paramètre d’application nommé AzureWebJobsStorage.If you leave connection empty, the Functions runtime uses the default Storage connection string in the app setting that is named AzureWebJobsStorage.

La chaîne de connexion doit être pour un compte de stockage à usage général, et non pour un compte de stockage d’objets blob uniquement.The connection string must be for a general-purpose storage account, not a blob-only storage account.
n/an/a y accéderAccess Indique si vous lirez ou écrirez.Indicates whether you will be reading or writing.

Quand vous développez localement, les paramètres d’application vont dans le fichier local.settings.json.When you're developing locally, app settings go into the local.settings.json file.

Entrée - utilisationInput - usage

Vous pouvez utiliser les types de paramètres suivants pour la liaison d’entrée d’objet blob :You can use the following parameter types for the blob input binding:

  • Stream
  • TextReader
  • string
  • Byte[]
  • CloudBlobContainer
  • CloudBlobDirectory
  • ICloudBlob1ICloudBlob1
  • CloudBlockBlob1CloudBlockBlob1
  • CloudPageBlob1CloudPageBlob1
  • CloudAppendBlob1CloudAppendBlob1

1 requiert la liaison « inout » direction dans function.json ou FileAccess.ReadWrite dans une bibliothèque de classes C#.1 Requires "inout" binding direction in function.json or FileAccess.ReadWrite in a C# class library.

Si vous essayez de lier à un des types de SDK Stockage et obtenez un message d’erreur, vérifiez que vous avez une référence à la bonne version du SDK Stockage.If you try to bind to one of the Storage SDK types and get an error message, make sure that you have a reference to the correct Storage SDK version.

La liaison à string ou Byte[] est recommandée uniquement si la taille de l’objet blob est petite, car tout le contenu de l’objet blob est chargé en mémoire.Binding to string or Byte[] is only recommended if the blob size is small, as the entire blob contents are loaded into memory. En général, il est préférable d’utiliser un type Stream ou CloudBlockBlob.Generally, it is preferable to use a Stream or CloudBlockBlob type. Pour plus d’informations, consultez Concurrence et utilisation de la mémoire plus haut dans cet article.For more information, see Concurrency and memory usage earlier in this article.

OutputOutput

Utilisez les liaisons de sortie de stockage blob pour écrire des objets blob.Use Blob storage output bindings to write blobs.

Sortie - exempleOutput - example

L’exemple suivant est une fonction C# qui utilise un déclencheur d’objet blob et deux liaisons de sortie d’objet blob.The following example is a C# function that uses a blob trigger and two output blob bindings. La fonction est déclenchée par la création d’un objet blob d’image dans le conteneur sample-images.The function is triggered by the creation of an image blob in the sample-images container. Il crée des copies de petite et moyenne taille de l’objet blob d’image.It creates small and medium size copies of the image blob.

using System.Collections.Generic;
using System.IO;
using Microsoft.Azure.WebJobs;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Formats;
using SixLabors.ImageSharp.PixelFormats;
using SixLabors.ImageSharp.Processing;

public class ResizeImages
{
    [FunctionName("ResizeImage")]
    public static void Run([BlobTrigger("sample-images/{name}")] Stream image,
        [Blob("sample-images-sm/{name}", FileAccess.Write)] Stream imageSmall,
        [Blob("sample-images-md/{name}", FileAccess.Write)] Stream imageMedium)
    {
        IImageFormat format;

        using (Image<Rgba32> input = Image.Load<Rgba32>(image, out format))
        {
            ResizeImage(input, imageSmall, ImageSize.Small, format);
        }

        image.Position = 0;
        using (Image<Rgba32> input = Image.Load<Rgba32>(image, out format))
        {
            ResizeImage(input, imageMedium, ImageSize.Medium, format);
        }
    }

    public static void ResizeImage(Image<Rgba32> input, Stream output, ImageSize size, IImageFormat format)
    {
        var dimensions = imageDimensionsTable[size];

        input.Mutate(x => x.Resize(dimensions.Item1, dimensions.Item2));
        input.Save(output, format);
    }

    public enum ImageSize { ExtraSmall, Small, Medium }

    private static Dictionary<ImageSize, (int, int)> imageDimensionsTable = new Dictionary<ImageSize, (int, int)>() {
        { ImageSize.ExtraSmall, (320, 200) },
        { ImageSize.Small,      (640, 400) },
        { ImageSize.Medium,     (800, 600) }
    };

}

Sortie - attributsOutput - attributes

Dans les bibliothèques de classes C#, utilisez l’attribut BlobAttribute.In C# class libraries, use the BlobAttribute.

Le constructeur de l’attribut prend le chemin de l’objet blob et un paramètre FileAccess indiquant la lecture ou l’écriture, comme indiqué dans l’exemple suivant :The attribute's constructor takes the path to the blob and a FileAccess parameter indicating read or write, as shown in the following example:

[FunctionName("ResizeImage")]
public static void Run(
    [BlobTrigger("sample-images/{name}")] Stream image,
    [Blob("sample-images-md/{name}", FileAccess.Write)] Stream imageSmall)
{
    ...
}

Vous pouvez définir la propriété Connection pour spécifier le compte de stockage à utiliser, comme indiqué dans l’exemple suivant :You can set the Connection property to specify the storage account to use, as shown in the following example:

[FunctionName("ResizeImage")]
public static void Run(
    [BlobTrigger("sample-images/{name}")] Stream image,
    [Blob("sample-images-md/{name}", FileAccess.Write, Connection = "StorageConnectionAppSetting")] Stream imageSmall)
{
    ...
}

Pour obtenir un exemple complet, consultez Exemple de sortie.For a complete example, see Output example.

Vous pouvez utiliser l’attribut StorageAccount pour spécifier le compte de stockage au niveau de la classe, de la méthode ou du paramètre.You can use the StorageAccount attribute to specify the storage account at class, method, or parameter level. Pour plus d’informations, consultez Déclencheur - attributs.For more information, see Trigger - attributes.

Sortie - configurationOutput - configuration

Le tableau suivant décrit les propriétés de configuration de liaison que vous définissez dans le fichier function.json et l’attribut Blob.The following table explains the binding configuration properties that you set in the function.json file and the Blob attribute.

Propriété function.jsonfunction.json property Propriété d’attributAttribute property DescriptionDescription
typetype n/an/a Cette propriété doit être définie sur blob.Must be set to blob.
directiondirection n/an/a Cette propriété doit être définie sur out pour une liaison de type sortie.Must be set to out for an output binding. Les exceptions sont notées à la section utilisation.Exceptions are noted in the usage section.
namename n/an/a Nom de la variable qui représente l’objet blob dans le code de la fonction.The name of the variable that represents the blob in function code. La valeur doit être $return pour faire référence à la valeur de retour de la fonction.Set to $return to reference the function return value.
pathpath BlobPathBlobPath Chemin du conteneur d’objet blob.The path to the blob container.
connectionconnection ConnectionConnection Nom d’un paramètre d’application comportant la chaîne de connexion de stockage à utiliser pour cette liaison.The name of an app setting that contains the Storage connection string to use for this binding. Si le nom du paramètre d’application commence par « AzureWebJobs », vous ne pouvez spécifier que le reste du nom ici.If the app setting name begins with "AzureWebJobs", you can specify only the remainder of the name here. Par exemple, si vous définissez connection sur « MyStorage », le runtime Functions recherche un paramètre d’application qui est nommé « AzureWebJobsMyStorage ».For example, if you set connection to "MyStorage", the Functions runtime looks for an app setting that is named "AzureWebJobsMyStorage." Si vous laissez connection vide, le runtime Functions utilise la chaîne de connexion de stockage par défaut dans le paramètre d’application nommé AzureWebJobsStorage.If you leave connection empty, the Functions runtime uses the default Storage connection string in the app setting that is named AzureWebJobsStorage.

La chaîne de connexion doit être pour un compte de stockage à usage général, et non pour un compte de stockage d’objets blob uniquement.The connection string must be for a general-purpose storage account, not a blob-only storage account.
n/an/a y accéderAccess Indique si vous lirez ou écrirez.Indicates whether you will be reading or writing.

Quand vous développez localement, les paramètres d’application vont dans le fichier local.settings.json.When you're developing locally, app settings go into the local.settings.json file.

Sortie - utilisationOutput - usage

Vous pouvez lier aux types suivants pour écrire des blobs :You can bind to the following types to write blobs:

  • TextWriter
  • out string
  • out Byte[]
  • CloudBlobStream
  • Stream
  • CloudBlobContainer1CloudBlobContainer1
  • CloudBlobDirectory
  • ICloudBlob2ICloudBlob2
  • CloudBlockBlob2CloudBlockBlob2
  • CloudPageBlob2CloudPageBlob2
  • CloudAppendBlob2CloudAppendBlob2

1 requiert la liaison « in » direction dans function.json ou FileAccess.Read dans une bibliothèque de classes C#.1 Requires "in" binding direction in function.json or FileAccess.Read in a C# class library. Toutefois, vous pouvez utiliser l’objet conteneur fourni par le runtime pour les opérations d’écriture, telles que le chargement de blobs dans le conteneur.However, you can use the container object that the runtime provides to do write operations, such as uploading blobs to the container.

2 requiert la liaison « inout » direction dans function.json ou FileAccess.ReadWrite dans une bibliothèque de classes C#.2 Requires "inout" binding direction in function.json or FileAccess.ReadWrite in a C# class library.

Si vous essayez de lier à un des types de SDK Stockage et obtenez un message d’erreur, vérifiez que vous avez une référence à la bonne version du SDK Stockage.If you try to bind to one of the Storage SDK types and get an error message, make sure that you have a reference to the correct Storage SDK version.

Dans les fonctions asynchrones, utilisez la valeur de retour ou IAsyncCollector au lieu d’un paramètre out.In async functions, use the return value or IAsyncCollector instead of an out parameter.

La liaison à string ou Byte[] est recommandée uniquement si la taille de l’objet blob est petite, car tout le contenu de l’objet blob est chargé en mémoire.Binding to string or Byte[] is only recommended if the blob size is small, as the entire blob contents are loaded into memory. En général, il est préférable d’utiliser un type Stream ou CloudBlockBlob.Generally, it is preferable to use a Stream or CloudBlockBlob type. Pour plus d’informations, consultez Concurrence et utilisation de la mémoire plus haut dans cet article.For more information, see Concurrency and memory usage earlier in this article.

Exceptions et codes de retourExceptions and return codes

LiaisonBinding Informations de référenceReference
Objet blobBlob Codes d’erreur du service BLOBBlob Error Codes
Objet blob, Table, File d’attenteBlob, Table, Queue Codes d’erreur de stockageStorage Error Codes
Objet blob, Table, File d’attenteBlob, Table, Queue DépannageTroubleshooting

Étapes suivantesNext steps