Acceso, creación o procesamiento de documentos en Azure Cosmos DB desde flujos de trabajo en Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo + estándar)

Desde un flujo de trabajo de Azure Logic Apps, puede conectarse a Azure Cosmos DB y trabajar con documentos mediante el conector de Azure Cosmos DB . Por ejemplo, puede usar operaciones de conector para crear, actualizar, leer, consultar o eliminar documentos.

Puede conectarse a Azure Cosmos DB desde flujos de trabajo de aplicaciones lógicas de consumo y estándar mediante las operaciones del conector administrado, que se hospedan, administran y ejecutan en Azure global y multiinquilino. En el caso de los flujos de trabajo estándar, Azure Cosmos DB también proporciona operaciones integradas que se ejecutan junto con el entorno de ejecución para Azure Logic Apps de un solo inquilino. Las operaciones integradas ofrecen un mejor rendimiento, un mayor rendimiento y, a veces, una funcionalidad diferente. Por ejemplo, en un flujo de trabajo Estándar, puede usar el desencadenador integrado para supervisar un contenedor de Azure Cosmos DB para elementos nuevos o actualizados. Puede combinar operaciones de Azure Cosmos DB con otros usuarios de un flujo de trabajo para admitir escenarios como el aprovisionamiento de eventos y el procesamiento general de datos.

Limitaciones

• Actualmente, solo los flujos de trabajo con estado de un flujo de trabajo Estándar pueden usar tanto las operaciones del conector administrado como las operaciones integradas. Los flujos de trabajo sin estado solo pueden usar las operaciones integradas.

• El conector de Azure Cosmos DB solo admite cuentas de Azure Cosmos DB creadas con la Azure Cosmos DB for NoSQL.

Requisitos previos

• Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.

• Una cuenta de Azure Cosmos DB.

• Flujo de trabajo de aplicación lógica desde donde desea acceder a una cuenta de Azure Cosmos DB. Para usar el desencadenador integrado de Azure Cosmos DB, debe empezar con un flujo de trabajo en blanco.

Referencia técnica del conector

• Para obtener información de referencia sobre las operaciones del conector administrado de Azure Cosmos DB, como desencadenadores, acciones y límites, consulte la página de referencia del conector administrado.

• Para obtener información de referencia sobre las operaciones integradas de Azure Cosmos DB, como desencadenadores, acciones y límites, consulte la página de referencia de operaciones integradas.

Adición de un desencadenador de Azure Cosmos DB

En Azure Logic Apps, cada flujo de trabajo debe comenzar con un desencadenador, que se activa cuando se produce un evento específico o cuando se cumple una condición determinada.

Si estás trabajando con un flujo de trabajo estándar, el desencadenador integrado denominado Cuando se crea o modifica un elemento está disponible y se basa en el patrón de diseño de feed de cambios de Azure Cosmos DB. Este desencadenador no está disponible para flujos de trabajo de Consumo.

Adición de una acción de Azure Cosmos DB

En Azure Logic Apps, una acción es un paso de un flujo de trabajo que sigue un desencadenador u otra acción. El conector de Azure Cosmos DB ofrece acciones para flujos de trabajo de consumo y estándar. En los ejemplos siguientes se muestra cómo usar una acción que crea o actualiza un documento.

Conexión a Azure Cosmos DB

Al agregar un desencadenador o una acción que se conecta a un servicio o sistema, y no tiene una conexión existente o activa, Azure Logic Apps le pide que proporcione la información de conexión, que varía en función del tipo de conexión, por ejemplo:

• Las credenciales de la cuenta
• El nombre que se va a usar para la conexión
• Nombre del sistema o servidor
• Tipo de autenticación que se debe usar.
• Una cadena de conexión

Para poder configurar un desencadenador de Azure Cosmos DB o una acción de Azure Cosmos DB, debe conectarse a una cuenta de base de datos.

Configuración de la autenticación de identidad administrada

Para usar una identidad administrada con el conector de Azure Cosmos DB, primero debe asignar el rol de plano de datos Azure Cosmos DB adecuado a la identidad administrada. Azure Cosmos DB usa su propio sistema de control de acceso basado en rol (RBAC) para las operaciones del plano de datos por separado de Azure RBAC.

El rol integrado denominado Colaborador de datos integrado de Cosmos DB (identificador de definición de rol: 00000000-0000-0000-0000-000000000002) concede acceso de lectura y escritura a los datos de Azure Cosmos DB. Para más información, vea Uso del control de acceso basado en rol del plano de datos con Azure Cosmos DB for NoSQL.

Asignación de un rol de plano de datos de Cosmos DB a una identidad administrada asignada por el sistema

Para usar una identidad administrada asignada por el sistema, primero asegúrese de que la identidad está habilitada en el recurso de la aplicación lógica. A continuación, obtenga el identificador principal de la identidad y asigne el rol del plano de datos de Azure Cosmos DB.

1. En el portal de Azure, vaya al recurso de la aplicación lógica. En la barra lateral del recurso, en Configuración, seleccione Identidad.

2. Confirme que la identidad asignada por el sistema está establecida en Activado. Copie el valor de ID de objeto (entidad de seguridad).

3. En CLI de Azure, asigne el rol Colaborador de datos integrado de Cosmos DB a la identidad administrada asignada por el sistema:

   az cosmosdb sql role assignment create \
     --resource-group "<cosmos-db-resource-group>" \
     --account-name "<cosmos-db-account-name>" \
     --role-definition-id "00000000-0000-0000-0000-000000000002" \
     --principal-id "<system-assigned-identity-principal-id>" \
     --scope "/subscriptions/<subscription-id>/resourceGroups/<cosmos-db-resource-group>/providers/Microsoft.DocumentDB/databaseAccounts/<cosmos-db-account-name>"
   

   Nota:

   El --scope parámetro define el nivel de acceso. Puede definir el ámbito de la asignación de roles al nivel de cuenta, una base de datos específica o un contenedor específico. Para más información, vea Uso del control de acceso basado en rol del plano de datos con Azure Cosmos DB for NoSQL.

Asignación del rol de plano de datos de Cosmos DB a una identidad administrada asignada por el usuario

Para poder usar una identidad administrada asignada por el usuario, cree primero la identidad, agréguela a la aplicación lógica y, a continuación, asigne el rol de plano de datos Azure Cosmos DB.

1. Obtenga el identificador de entidad de seguridad de la identidad administrada asignada por el usuario. En la CLI de Azure, ejecute el siguiente comando:

   az identity show \
     --resource-group "<identity-resource-group>" \
     --name "<identity-name>" \
     --query principalId \
     --output tsv
   

2. Asigne el rol Colaborador de datos integrado de Cosmos DB a la identidad administrada asignada por el usuario:

   az cosmosdb sql role assignment create \
     --resource-group "<cosmos-db-resource-group>" \
     --account-name "<cosmos-db-account-name>" \
     --role-definition-id "00000000-0000-0000-0000-000000000002" \
     --principal-id "<user-assigned-identity-principal-id>" \
     --scope "/subscriptions/<subscription-id>/resourceGroups/<cosmos-db-resource-group>/providers/Microsoft.DocumentDB/databaseAccounts/<cosmos-db-account-name>"
   

3. Al crear la conexión de Azure Cosmos DB en el diseñador de flujos de trabajo, proporcione el identificador completo del recurso de la identidad administrada asignada por el usuario como valor de Managed identity, por ejemplo:

   /subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}
   

   Tip

   Para buscar el identificador de recurso completo, siga estos pasos:

   1. En el portal de Azure, vaya al recurso de identidad administrada asignada por el usuario.
   2. En la barra lateral del recurso, seleccione Información general.
   3. En la página Información general , busque la sección Propiedades y, a continuación, copie el valor id .

Procedimientos recomendados de operaciones integradas de Azure Cosmos DB

Obtener resultados iterables de la acción Consultar elementos

En un flujo de trabajo Estándar, la acción integrada Elementos de consulta genera muchos elementos de salida de contenido dinámico para su uso en acciones posteriores. Para obtener los elementos de resultado de la consulta o los metadatos de elementos como un objeto iterable, siga estos pasos:

1. En Azure Portal, abra el flujo de trabajo Estándar en el diseñador.

2. Si el flujo de trabajo está en blanco, agregue cualquier desencadenador que desee.

   Este ejemplo comienza con el desencadenador Periodicidad.

3. En el desencadenador o la acción en la que desea agregar la acción de Azure Cosmos DB, siga estos pasos generales para agregar la acción de Azure Cosmos DB denominada Elementos de consulta.

4. Si se le piden los detalles de la conexión, cree una conexión a su cuenta de Azure Cosmos DB.

5. En el panel de información de acciones, en la pestaña Parámetros , proporcione la siguiente información necesaria:

   Parámetros	Obligatorio	Valor	Descripción
   Id. de base de datos	Sí	< database-ID>	Base de datos a la que se va a conectar.
   Id. de contenedor	Sí	< container-ID>	Contenedor que se va a consultar.
   Consulta SQL	Sí	< consulta sql>	Consulta SQL para la solicitud.

   En el ejemplo siguiente se muestra la acción Elementos de consulta :

   

6. Configure cualquier otro parámetro o configuración según sea necesario.

7. En la acción Elementos de consulta, siga estos pasos generales para agregar una acción que desea ejecutar en todos los elementos de consulta devueltos.

   En este ejemplo se usa la acción integrada de Azure Cosmos DB denominada Eliminar un elemento.

8. En la acción Eliminar un elemento , puede acceder a las salidas de la acción Elementos de consulta siguiendo estos pasos:

   1. Seleccione dentro de cualquier campo de entrada para mostrar las opciones disponibles.

   2. Seleccione el icono del rayo para abrir la lista de contenido dinámico.

   3. En la sección Elementos de consulta de la lista, seleccione la salida que desee o seleccione Ver más para obtener más salidas.

      Por ejemplo, puede seleccionar Elemento de elementos de respuesta para rellenar el campo Id. de elemento con identificadores de los resultados de la consulta.

      Después de seleccionar el elemento Elementos de respuesta, la acción For each se agrega automáticamente para iterar por todos los resultados de la consulta. El bucle For each contiene la acción Eliminar un elemento .

      

9. Agregue cualquier otra acción que desee al bucle.

10. En la barra de herramientas del diseñador, seleccione Save (Guardar).

11. Pruebe el flujo de trabajo para confirmar que las acciones devuelven la salida que espera.

Contenido relacionado

• Conectores gestionados para Azure Logic Apps
• Conectores integrados para Azure Logic Apps
• ¿Qué son los conectores en Azure Logic Apps?