Azure Data Lake Storage

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione DownloadFile

Questa azione ti consente di scaricare i contenuti di un determinato blob da una directory o un container.

Parametri di input dell'azione DownloadFile

Parametri di output dell'azione DownloadFile

Se l'azione va a buon fine, restituisce i contenuti del file o del blob.

Per un esempio di come configurare l'azione DownloadFile, consulta Esempi di azioni.

Azione CreateFile

Questa azione ti consente di creare un blob o un file in un container o una directory.

Parametri di input dell'azione CreateFile

Per un esempio di come configurare l'azione CreateFile, consulta Esempi di azioni.

Azione CopyFile

Questa azione ti consente di copiare i contenuti di un file o di un blob in un altro file o blob nello stesso contenitore o nella stessa directory.

Parametri di input dell'azione CopyFile

Per un esempio di come configurare l'azione CopyFile, consulta Esempi di azioni.

Azione DeleteObject

Questa azione consente di eliminare un file o un blob.

Parametri di input dell'azione Elimina oggetto

Per un esempio di come configurare l'azione DeleteObject, consulta Esempi di azioni.

Azione LeaseBlob

Questa azione ti consente di creare e gestire un blocco su un blob.

Parametri di input dell'azione LeaseBlob

Per un esempio di come configurare l'azione LeaseBlob, consulta Esempi di azioni.

Azione UploadFile

Questa azione consente agli utenti di caricare i contenuti in un determinato blob o contenitore.

Parametri di input dell'azione UploadFile

Per un esempio di come configurare l'azione UploadFile, consulta Esempi di azioni.

Azione RenameObject

Questa azione ti consente di rinominare un file o una cartella.

Parametri di input dell'azione RenameObject

Per un esempio di come configurare l'azione RenameObject, consulta Esempi di azioni.

Esempi di azioni

Esempio: scaricare un file

Questo esempio scarica un file binario.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadFile, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadFile della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: carica un file

Questo esempio carica i contenuti come blob.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UploadFile, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro UploadFile della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "true"
}]

Esempio: creare un file

Questo esempio crea un file nella directory specificata.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateFile, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "path": "testdirectory1/testblob"
   }

Se l'azione ha esito positivo, il parametro CreateFile della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "true"
}]

Esempio: copiare un file

Questo esempio copia un file da una posizione a un'altra.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CopyFile, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro CopyFile della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "true"
}]

Esempio: elimina un blob

Questo esempio elimina il blob specificato.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "path": "testdirectory1/testblob"
   }

Se l'azione ha esito positivo, il parametro DeleteObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "true"
}]

Esempio: noleggiare un blob

Questo esempio acquisisce in lease il blob specificato.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione LeaseBlob, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività LeaseBlob avrà un valore simile al seguente:

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

Esempio: rinominare un blob

Questo esempio rinomina un blob.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RenameObject, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro RenameObject della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": true
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti i record

Questo esempio elenca tutti i record nell'entità Resource.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Resource dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Specifica il valore della clausola di filtro sempre tra virgolette singole (').

Esempio: recuperare un record

Questo esempio recupera un record con l'ID specificato dall'entità Resource.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Resource dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci testdirectory1/testblob1 nel campo Valore predefinito.

   In questo caso, testdirectory1/testblob1 è un ID record univoco nell'entità Resource.