Propriétés du tAzureStorageList Standard - 7.3

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.

Account Name

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.

Authentication type

Configurez le type d'authentification pour vous connecter à Microsoft Azure Blob storage. Deux options sont fournies : Basic et Azure Active Directory.

• Basic : sélectionnez cette option si vous souhaitez accéder à Microsoft Azure Blob storage à l'aide de votre clé d'accès du compte de stockage ou d'une signature d'accès partagé. Consultez Configuration des chaînes de connexion Stockage Azure et Accorder un accès limité aux ressources du Stockage Azure à l’aide des signatures d’accès partagé (SAP) pour plus d'informations.
• Azure Active Directory : sélectionnez cette option pour accéder à Microsoft Azure Blob storage à l'aide de vos identifiants Azure Active Directory (Azure AD). Consultez Autoriser l’accès aux objets blob et aux files d’attente avec Azure Active Directory pour plus d'informations.

Account Key

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 dans la liste déroulante le composant dont les informations de connexion seront utilisées pour configurer la connexion à Azure Storage.

Cette option est disponible uniquement lorsque l'option Basic est sélectionnée dans la liste déroulante Authentication type.

Protocol

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

Cette option est disponible uniquement lorsque l'option Basic est sélectionnée dans la liste déroulante Authentication type.

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. Pour plus d'informations, consultez Utilisation des signatures d'accès partagé (SAP).

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.

Cette option est disponible uniquement lorsque l'option Basic est sélectionnée dans la liste déroulante Authentication type.

Tenant ID

Saisissez l'ID du tenant Azure AD. Consultez Obtenir un jeton à partir d’Azure AD pour autoriser les requêtes à partir d’une application cliente pour plus d'informations.

Cette option est disponible uniquement lorsque vous sélectionnez Azure Active Directory dans la liste déroulante Authentication type.

Client ID

Saisissez l'ID du client de votre application. Consultez Obtenir un jeton à partir d’Azure AD pour autoriser les requêtes à partir d’une application cliente pour plus d'informations.

Cette option est disponible uniquement lorsque vous sélectionnez Azure Active Directory dans la liste déroulante Authentication type.

Client Secret

Saisissez le secret du client de votre application. Consultez Obtenir un jeton à partir d’Azure AD pour autoriser les requêtes à partir d’une application cliente pour plus d'informations.

Cette option est disponible uniquement lorsque vous sélectionnez Azure Active Directory dans la liste déroulante Authentication type.

Container name

Saisissez le nom du conteneur duquel vous souhaitez sélectionner les blobs à lister.

Blob filters

Renseignez cette table afin de sélectionner les blobs à lister. Les paramètres à fournir sont :

Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. 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 avec une colonne unique BlobName de type String, qui indique le nom de chaque blob à lister.

Créez le schéma en cliquant sur le bouton 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.

Die on error

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

Décochez la case pour ignorer les lignes en erreur et terminer le traitement des lignes sans erreur. Lorsque les erreurs sont ignorées, vous pouvez récupérer les lignes en erreur en utilisant la connexion Row > Reject.

tStatCatcher Statistics

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.

Nom du conteneur du blob. Cette variable est une variable After et retourne une chaîne de caractères.

Nom du blob traité par ce composant. Cette variable est une variable After et retourne une chaîne de caractères.

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 peut être utilisé en standalone dans un Job ou un sous-Job.

Prérequis

Des connaissances de Microsoft Azure Storage sont nécessaires.