Azure Data Lake Storage

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción DownloadFile

Esta acción te permite descargar el contenido de un blob concreto de un directorio o un contenedor.

Parámetros de entrada de la acción DownloadFile

Parámetros de salida de la acción DownloadFile

Si la acción se realiza correctamente, devuelve el contenido del archivo o del blob.

Para ver un ejemplo de cómo configurar la acción DownloadFile, consulta los ejemplos de acciones.

Acción CreateFile

Esta acción te permite crear un blob o un archivo en un contenedor o un directorio.

Parámetros de entrada de la acción CreateFile

Para ver un ejemplo de cómo configurar la acción CreateFile, consulta Ejemplos de acciones.

Acción CopyFile

Esta acción te permite copiar el contenido de un archivo o un blob en otro archivo o blob del mismo contenedor o directorio.

Parámetros de entrada de la acción CopyFile

Para ver un ejemplo de cómo configurar la acción CopyFile, consulta Ejemplos de acciones.

Acción DeleteObject

Esta acción te permite eliminar un archivo o un blob.

Parámetros de entrada de la acción DeleteObject

Para ver un ejemplo de cómo configurar la acción DeleteObject, consulta los ejemplos de acciones.

Acción LeaseBlob

Esta acción te permite crear y gestionar un bloqueo en un blob.

Parámetros de entrada de la acción LeaseBlob

Para ver un ejemplo de cómo configurar la acción LeaseBlob, consulta Ejemplos de acciones.

Acción UploadFile

Esta acción permite a los usuarios subir el contenido a un blob o contenedor concreto.

Parámetros de entrada de la acción UploadFile

Para ver un ejemplo de cómo configurar la acción UploadFile, consulta Ejemplos de acciones.

Acción RenameObject

Esta acción te permite cambiar el nombre de un archivo o una carpeta.

Parámetros de entrada de la acción RenameObject

Para ver un ejemplo de cómo configurar la acción RenameObject, consulta Ejemplos de acciones.

Ejemplos de acciones

Ejemplo: descargar un archivo

En este ejemplo se descarga un archivo binario.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadFile y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DownloadFile tendrá un valor similar al siguiente:

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

Ejemplo: subir un archivo

En este ejemplo se sube contenido como un blob.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadFile y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UploadFile tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: crear un archivo

En este ejemplo se crea un archivo en el directorio especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateFile y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "path": "testdirectory1/testblob"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CreateFile tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: copiar un archivo

En este ejemplo se copia un archivo de una ubicación a otra.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CopyFile y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CopyFile tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: eliminar un blob

En este ejemplo se elimina el blob especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeleteObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "path": "testdirectory1/testblob"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DeleteObject tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: arrendar un blob

En este ejemplo se alquila el blob especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción LeaseBlob y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea LeaseBlob tendrá un valor similar al siguiente:

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

Ejemplo: cambiar el nombre de un blob

En este ejemplo se cambia el nombre de un blob.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción RenameObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea RenameObject tendrá un valor similar al siguiente:

[{
"Success": true
}]

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: listar todos los registros

En este ejemplo se enumeran todos los registros de la entidad Resource.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Resource en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. Opcionalmente, en la sección Entrada de tarea de la tarea Conectores, puedes filtrar el conjunto de resultados especificando una cláusula de filtro. Especifica siempre el valor de la cláusula de filtro entre comillas simples (').

Ejemplo: obtener un registro

En este ejemplo se obtiene un registro con el ID especificado de la entidad Resource.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Resource en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en EntityId y, a continuación, introduzca testdirectory1/testblob1 en el campo Valor predeterminado.

   En este caso, testdirectory1/testblob1 es un ID de registro único de la entidad Resource.