Propriétés du tAzureStorageInputTable Standard - 6.5

Property Type

Sélectionnez la manière de configurer les informations de connexion.

• Built-In : les paramètres de connexion seront définis localement pour ce composant. Vous devez spécifier manuellement les valeurs pour toutes les propriétés de connexion.

• Repository : les paramètres de connexion stockés centralement dans le Repository > Metadata seront réutilisés par ce composant. Vous devez cliquer sur le bouton [...] et, dans la boîte de dialogue Repository Content, sélectionnez les détails de connexion à réutiliser. Toutes les propriétés de connexion seront automatiquement renseignées.

Cette propriété n'est pas disponible lorsqu'un autre composant de connexion est sélectionné dans la liste Connection Component.

Sélectionnez dans la liste déroulante le composant dont les informations de connexion seront utilisées pour configurer la connexion à Azure Storage.

Saisissez le nom du compte de stockage auquel vous devez accéder. Vous pouvez trouver un nom de compte de stockage dans le dashboard Storage accounts du système Microsoft Azure Storage à utiliser. Assurez-vous que l'administrateur du système a donné les droits d'accès appropriés à ce compte de stockage.

Saisissez la clé associée au compte de stockage auquel vous devez accéder. Deux clés sont disponibles pour chaque compte. Par défaut, n'importe laquelle peut être utilisée pour accéder au compte.

Sélectionnez le protocole de la connexion à créer.

Use Azure Shared Access Signature

Cochez cette case pour utiliser une signature d'accès partagé pour accéder aux ressources du stockage sans utiliser de clé de compte.

Dans le champ Azure Shared Access Signature qui s'affiche, saisissez votre signature d'accès partagé entre guillemets doubles. Vous pouvez obtenir l'URL de la signature d'accès partagé pour chaque service autorisé sur le portail de Microsoft Azure, après génération de la signature. Le format de l'URL est le suivant : https://<$storagename>.<$service>.core.windows.net/<$sastoken>, où <$storagename> est le nom du compte de stockage, <$service> le nom du service autorisé (blob, file, queue ou table) et <$sastoken> est la valeur du jeton de signature d'accès partagé. Pour plus d'informations, consultez Constructing the Account SAS URI (en anglais).

Notez que SAS a une période de validité, vous pouvez configurer l'heure de début de validité de SAS et son heure d'expiration, après laquelle SAS n'est plus valide lors de la génération. Vous devez vous assurer que votre SAS est toujours valide lorsque vous exécutez votre Job.

Spécifiez le nom de la table de laquelle récupérer les entités.

Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) dans le Repository. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.

• Built-in : le schéma est créé et conservé localement pour ce composant seulement.

• Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.

Le schéma de ce composant est prédéfini et contient les colonnes suivantes décrivant les trois propriétés système de chaque entité :

• PartitionKey : clé de partition de la partition à laquelle l'entité appartient.

• RowKey : clé de ligne pour l'entité au sein de la partition.

  PartitionKey et RowKey sont des valeurs de type String identifiant de manière unique chaque entité dans une table. L'utilisateur doit les inclure dans chaque opération insert, update, ou delete (insertion, mise à jour ou suppression).

• Timestamp : heure de dernière modification de l'entité. Cette valeur DateTime est maintenue par le serveur Azure et ne peut être modifiée par l'utilisateur.

Pour plus d'informations concernant ces propriétés système, consultez Understanding the Table Service Data Model (en anglais).

Modifiez le schéma en cliquant sur Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :

• View schema : sélectionnez cette option afin de voir uniquement le schéma.

• Change to built-in property : sélectionnez cette option pour passer le schéma en mode Built-In et effectuer des modifications locales.

• Update repository connection : sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs. Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur No et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre [Repository Content].

Cochez cette case et renseignez la table Filter expressions affichée, afin de spécifier les conditions utilisées pour filtrer les entités à récupérer, en cliquant autant de fois que nécessaire sur le bouton [+], afin d'ajouter une ligne par condition. Configurez la valeur des paramètres suivants pour chaque condition.

• Column: spécifiez le nom de la propriété sur laquelle appliquer la condition.
• Function : cliquez dans la cellule et sélectionnez dans la liste l'opérateur de comparaison à utiliser.
• Value : spécifiez la valeur utilisée pour la comparaison de la propriété.
• Predicate : sélectionnez le prédicat utilisé pour combiner les conditions.
• Field type : cliquez dans la cellule et sélectionnez dans la liste déroulante le type de la colonne.

L'expression de filtre générée s'affiche dans le champ Effective filter, en lecture seule.

Pour plus d'informations concernant les expressions de filtres, consultez Querying Tables and Entities (en anglais).

Cochez cette case pour arrêter l'exécution du Job lorsqu'une erreur survient.

Renseignez cette table pour mapper le nom de la colonne du schéma du composant au nom de la propriété de l'entité de la table Azure s'ils sont différents.

• Schema column name : saisissez le nom de la colonne du schéma du composant, entre guillemets doubles.
• Entity property name : saisissez le nom de la propriété de l'entité de la table Azure, entre guillemets doubles.

Par exemple, si trois colonnes de schéma CompanyID, EmployeeID et EmployeeName sont utilisées pour alimenter les valeurs des propriétés des entités PartitionKey, RowKey et Name, respectivement, puisque les colonnes PartitionKey et RowKey ont été ajoutées automatiquement au schéma et que vous n'avez pas besoin de spécifier la relation de mapping pour celles-ci, vous devez seulement ajouter une ligne et configurer la valeur de la cellule Schema column name à "EmployeeName" et la valeur de la cellule Entity property name à "Name", afin de spécifier la relation de mapping pour la colonne EmployeeName lorsque vous récupérez les données de la table Azure.

Cochez cette case pour collecter les métadonnées de traitement du Job, aussi bien au niveau du Job qu'au niveau de chaque composant.

Nombre de lignes traitées. Cette variable est une variable After et retourne un entier.

Message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères.

Règle d'utilisation

Ce composant est généralement utilisé en tant que composant de début dans un Job ou un sous-Job et nécessite un lien de sortie.