Azure Data Lake Storage

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Dans cette section, vous trouverez la liste des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action DownloadFile

Cette action permet de télécharger le contenu d'un blob spécifique à partir d'un répertoire ou d'un conteneur.

Paramètres d'entrée de l'action DownloadFile

Paramètres de sortie de l'action DownloadFile

Si l'action aboutit, le contenu du fichier ou du blob est renvoyé.

Pour savoir comment configurer l'action DownloadFile, consultez Exemples d'actions.

Action CreateFile

Cette action permet de créer un blob ou un fichier dans un conteneur ou un répertoire.

Paramètres d'entrée de l'action CreateFile

Pour savoir comment configurer l'action CreateFile, consultez Exemples d'actions.

Action CopyFile

Cette action permet de copier le contenu d'un fichier ou d'un blob vers un autre fichier ou blob dans le même conteneur ou répertoire.

Paramètres d'entrée de l'action CopyFile

Pour savoir comment configurer l'action CopyFile, consultez Exemples d'actions.

Action DeleteObject

Cette action permet de supprimer un fichier ou un blob.

Paramètres d'entrée de l'action DeleteObject

Pour savoir comment configurer l'action DeleteObject, consultez Exemples d'actions.

Action LeaseBlob

Cette action permet de créer et de gérer un verrou sur un blob.

Paramètres d'entrée de l'action LeaseBlob

Pour savoir comment configurer l'action LeaseBlob, consultez Exemples d'actions.

Action UploadFile

Cette action permet aux utilisateurs d'importer le contenu dans un blob ou un conteneur spécifique.

Paramètres d'entrée de l'action UploadFile

Pour savoir comment configurer l'action UploadFile, consultez Exemples d'actions.

Action RenameObject

Cette action permet de renommer un fichier ou un dossier.

Paramètres d'entrée de l'action RenameObject

Pour savoir comment configurer l'action RenameObject, consultez Exemples d'actions.

Exemples d'actions

Exemple : Télécharger un fichier

Cet exemple télécharge un fichier binaire.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DownloadFile, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Path": "testdirectory1/test1.pdf",
   "HasBytes": true
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadFile aura une valeur semblable à la suivante :

[{
"Success": "True",
"ContentBytes": "UEsDBBQABgAIAAAAIQCj77sdZQEAAFIFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooA"
}]

Exemple : Importer un fichier

Cet exemple importe du contenu en tant que blob.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UploadFile, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Path": "testblob4",
   "HasBytes": true,
   "Content": "abcdef\nabcdef"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UploadFile aura une valeur semblable à la suivante :

[{
"Success": "true"
}]

Exemple : Créer un fichier

Cet exemple crée un fichier dans le répertoire spécifié.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateFile, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "path": "testdirectory1/testblob"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateFile aura une valeur semblable à la suivante :

[{
"Success": "true"
}]

Exemple : Copier un fichier

Cet exemple copie un fichier d'un emplacement vers un autre.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CopyFile, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "SourcePath": "testdirectory1/testblob",
   "DestinationPath": "testblob"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CopyFile aura une valeur semblable à la suivante :

[{
"Success": "true"
}]

Exemple : Supprimer un blob

Cet exemple supprime le blob spécifié.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DeleteObject, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "path": "testdirectory1/testblob"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteObject aura une valeur semblable à la suivante :

[{
"Success": "true"
}]

Exemple : Louer un blob

Cet exemple loue le blob spécifié.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action LeaseBlob, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Path": "testblob2",
   "LeaseAction": "Acquire",
   "LeaseDuration": 60.0
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche LeaseBlob aura une valeur semblable à la suivante :

[{
"LeaseId": "7aae9ca2-f015-41b6-9bdf-5fd3401fc493",
"Success": "true"
}]

Exemple : Renommer un blob

Cet exemple renomme un blob.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action RenameObject, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Path": "testblob",
   "RenameTo": "testblob6"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche RenameObject aura une valeur semblable à la suivante :

[{
"Success": true
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les enregistrements

Cet exemple liste tous les enregistrements de l'entité Resource.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Resource dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Indiquez toujours la valeur de la clause de filtre entre guillemets simples (').

Exemple : Récupérer un enregistrement

Cet exemple récupère un enregistrement ayant l'ID spécifié à partir de l'entité Resource.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Resource dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez testdirectory1/testblob1 dans le champ Valeur par défaut.

   Ici, testdirectory1/testblob1 est un ID d'enregistrement unique dans l'entité Resource.