MongoDB (versión 2)

El conector de MongoDB te permite realizar operaciones de inserción, eliminación, actualización y lectura en una base de datos de MongoDB.

Versiones compatibles

• MongoDB versiones 3.6 a 6.1
• Mongo Atlas implementado en Google Cloud

Antes de comenzar

Antes de usar el conector de MongoDB, realiza las siguientes tareas:

• En tu proyecto de Google Cloud, haz lo siguiente:
  • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red. Para obtener información sobre cómo configurar la conectividad de red para el clúster de MongoDB Atlas, consulta Conectividad privada para un clúster de MongoDB Atlas.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configure el conector.
  • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API de Secret Manager)
    • connectors.googleapis.com (API de conectores)

    Para comprender cómo habilitar servicios, consulta Habilita servicios.

  Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

   Ir a la página Conexiones

2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
3. En la sección Ubicación, elige la ubicación para la conexión.
   1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

   2. Haz clic en Siguiente.
4. En la sección Detalles de la conexión, completa lo siguiente:
   1. Conector: Selecciona MongoDB en la lista desplegable de conectores disponibles.
   2. Versión del conector: Selecciona la versión 2 2 de la lista desplegable de versiones disponibles.
   3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
   4. De manera opcional, ingresa una Descripción para la instancia de conexión.
   5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
   6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
   7. De manera opcional, configura los parámetros de nodo de conexión:
      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

   Nota: Puedes personalizar los valores de los nodos de conexión solo si eres un cliente de pago por uso.
   8. Base de datos: el nombre de la base de datos de MongoDB.
   9. Connection Timeout: Es el tiempo de espera de conexión en segundos.
   10. Use SSL: Especifica si SSL está habilitado o no.
   11. Nombre de la app: Es el nombre personalizado de la app para Mongo.
   12. Max Staleness Seconds: Es el tiempo, en segundos, que puede estar inactivo un elemento secundario antes de que el cliente deje de usarlo para operaciones de lectura.
   13. Preocupación por la escritura(opción w): Es la opción para solicitar el acuse de recibo de que la operación de escritura se propagó a una cantidad especificada de instancias con etiquetas específicas.
   14. Write Concern(wtimeoutMS Option): Especifica un límite de tiempo, en milisegundos, para la preocupación por la escritura.
   15. Write Concern(journal Option): Solicita una confirmación de MongoDB de que la operación de escritura se escribió en el diario.
   16. Preferencia de lectura: establece esto en una estrategia para leer desde un conjunto de réplicas. Los valores aceptados son primarios, primarios preferidos, secundarios, secundarios preferidos y más cercanos.
   17. Tipo de clúster: Especifica el tipo de clúster de MongoDB.
   18. Habilitar encriptación: Especifica si la encriptación está habilitada.
   19. Tipo de encriptación: Especifica el tipo de encriptación habilitado. Actualmente, solo se admite el tipo Local Encryption.
   20. Esquema de encriptación: Especifica la información del esquema de encriptación, incluidos los campos y el algoritmo de encriptación, el nombre alternativo de la clave, el tipo de consulta y el factor de contención. Por ejemplo:

       {
         "database.collection": {
           "encryptMetadata": {
             "algorithm": "parentAlgo"
           },
           "properties": {
             "passportId": {},
             "medicalRecords": {
               "encryptMetadata": {
                 "algorithm": "medicalRecordParentAlgo"
               },
               "properties": {
                 "medicalRecord1": {},
                 "medicalRecord2": {
                   "encrypt": {
                     "algorithm": "medicalRecord2Algo",
                     "keyAltName": "medicalRecord2Altkey",
                     "queryType": "equality",
                     "contentionFactor": 3
                   }
                 }
               }
             },
             "insuranceProperties": {
               "properties": {
                 "policyNumber": {},
                 "insuranceRecord1": {
                   "encrypt": {
                     "algorithm": "insuranceRecord1Algo",
                     "keyAltName": "insuranceRecord1AltKey"
                   }
                 },
                 "insuranceRecord2": {
                   "encrypt": {
                     "algorithm": "insuranceRecord2Algo",
                     "keyAltName": "insuranceRecord2AltKey",
                     "contentionFactor": 5
                   }
                 }
               }
             }
           }
         }
       }

   21. encryption_master_key: Secreto de Secret Manager que contiene la clave maestra de encriptación.
   22. encryption_key_vault: Es el valor de la bóveda de claves de encriptación.
   23. Base de datos de autenticación: Especifica el nombre de la base de datos de MongoDB para la autenticación.
   24. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
   25. Haga clic en SIGUIENTE.
5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
   1. Tipo de destino: Puedes especificar los detalles del destino como una dirección de host, que puede ser cualquiera de las siguientes:
      • Cadena SRV de Mongo única. Por ejemplo, mongodb+srv://cluster2.2f.mongodb.net
      • Réplicas individuales Por ejemplo, dasdsf.2f.mongodb01.net
      • dirección IP. Por ejemplo,10.23.123.12

      El prefijo mongodb:// se agregará a la URL final después de combinar todas las réplicas en la cadena de conexión si no se especifica mongodb+srv.

      • Dirección del host: Especifica el nombre de host o la dirección IP del destino.

        Si deseas establecer una conexión privada a tu backend, haz lo siguiente:

        • Crea un adjunto de servicio de PSC.
        • Crea un adjunto de extremo y, luego, ingresa los detalles del adjunto del extremo en el campo Dirección del host.
        Nota: Si deseas conectarte a un clúster de MongoDB Atlas que se ejecuta en una red privada dentro de Google Cloud, consulta Conectividad privada para un clúster de Atlas.

      Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.

   2. Haga clic en SIGUIENTE.
6. En la sección Autenticación, ingresa los detalles de autenticación.
   1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de MongoDB admite los siguientes tipos de autenticación:

      • Nombre de usuario y contraseña

   Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

   2. Haz clic en SIGUIENTE.
7. Revisa: Revisa tus detalles de conexión y autenticación.
8. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

• Nombre de usuario y contraseña
  • Username: Nombre de usuario para el conector
  • Contraseña: El Secret de Secret Manager que contiene la contraseña del usuario.
  • Esquema de autenticación: Es el esquema que se usa para la autenticación.

    La conexión de MongoDB admite los siguientes esquemas de autenticación:

    • Sin formato
    • SCRAM-SHA-1
    • SCRAM-SHA-256

Entidades, operaciones y acciones

Todos los Integration Connectors 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 expone como entidades, operaciones y acciones.

Nota: Puedes ver las entidades, operaciones y acciones de un conector en la tarea de conectores.

• Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

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

• Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Lista
  • Obtén
  • Crear
  • Actualizar
  • Borrar

  Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista Operations.

• Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, 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.

Nota: Todas las entidades y acciones tendrán un esquema asociado. Por ejemplo, un esquema de acción tendrá los detalles de los parámetros, como los nombres de los parámetros y su tipo de datos correspondiente. La conexión recupera el esquema (metadatos) de las entidades y las acciones durante el tiempo de ejecución desde tu backend. Si hay actualizaciones en el esquema, estas no se reflejarán automáticamente en tus conexiones existentes. Debes actualizar el esquema de forma manual. Para actualizar el esquema de una conexión, abre la página Detalles de la conexión de la conexión y, luego, haz clic en Actualizar esquema de conexión.

Nota: El conector de MongoDB no admite ninguna operación de entidad.

Limitaciones del sistema

El conector de MongoDB puede procesar un máximo de 70 transacciones por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, los conectores de integración asignan 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Nota: La cantidad de nodos de Integration Connectors se ajustará automáticamente de forma dinámica según tu uso. Sin embargo, si deseas reservar capacidad para volúmenes grandes sin esperar al ajuste de escala automático, puedes ajustar el valor de nodo mínimo para una conexión. Se requieren más nodos para procesar más transacciones para una conexión. Por el contrario, se requieren menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

• Si eres cliente de pago por uso, configura el valor mínimo y máximo de los nodos en la página de edición de la conexión.
• Si eres un cliente con suscripción, comunícate con el equipo de asistencia.

Las transacciones máximas que puede controlar un nodo dependen de varios factores. Por lo tanto, antes de ajustar los nodos mínimos para obtener una mejor capacidad de procesamiento, te recomendamos que verifiques si tus sistemas de backend están configurados de manera óptima para controlar el tráfico requerido.

Tipos de datos admitidos

Los siguientes son los tipos de datos admitidos para este conector:

• BIGINT
• BINARY
• BIT
• BOOLEAN
• CHAR
• DATE
• DECIMAL
• DOUBLE
• FLOAT
• INTEGER
• LONGN VARCHAR
• LONG VARCHAR
• NCHAR
• NUMERIC
• NVARCHAR
• REAL
• SMALL INT
• TIME
• TIMESTAMP
• TINY INT
• VARBINARY
• VARCHAR

Configuración del clúster de MongoDB Atlas

La configuración de autenticación de un clúster de MongoDB Atlas difiere un poco de los pasos documentados con anterioridad. Para autenticarte en un clúster de Atlas, primero debes obtener la cadena de conexión de Atlas. Para obtener la cadena de conexión de Atlas, sigue estos pasos:

1. En la vista de clústeres, haz clic en Conectar para el clúster al que deseas conectarte.
2. Haz clic en Conectar tu aplicación.
3. Selecciona cualquiera de las opciones de controladores para mostrar una cadena de conexión.

Para autenticarte en un clúster de Atlas, usa la siguiente configuración:

• Base de datos de autenticación: Establece el valor en admin, ya que todos los usuarios de MongoDB Atlas están asociados con la base de datos admin.
• Use SSL: Establece el valor en true.
• Servidor: Establece el valor en mongodb+srv://MongoDB INSTANCE SERVER NAME sin incluir el nombre de usuario ni la contraseña.

Acciones

En esta sección, se enumeran todas las acciones que admite la conexión de MongoDB.

Nota: Los resultados de todas las acciones estarán disponibles como una respuesta JSON en el parámetro de respuesta connectorOutputPayload de la tarea Connectors después de ejecutar la integración.

Acción de AggregatePipeline

Esta acción agrega los cambios de la canalización en una colección.

Parámetros de entrada de la acción AggregatePipeline

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
pipeline	String	Sí	Canalización de agregación que contiene etapas de campo como una lista de cadenas.
page_size	Número entero	No	Es la cantidad de elementos que se incluirán en cada página del conjunto de resultados.
page_no	Número entero	No	Es el índice de la página que se recuperará del conjunto de resultados. El índice comienza en 0.

Para ver ejemplos sobre cómo configurar la acción AggregatePipeline, consulta Ejemplos.

Acción CountDocuments

Esta acción cuenta todos los documentos que satisfacen una condición determinada en una colección.

Parámetros de entrada de la acción CountDocuments

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	El nombre de la colección de MongoDB.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de querytype.

Parámetros de salida de la acción CountDocuments

Esta acción muestra el recuento de todos los documentos que satisfacen una condición determinada.

Para ver ejemplos sobre cómo configurar la acción CountDocuments, consulta Ejemplos.

Acción DeleteDocuments

Esta acción borra documentos de una colección.

Parámetros de entrada de la acción DeleteDocuments

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de tipo de consulta.

Parámetros de salida de la acción DeleteDocuments

La acción muestra el recuento de documentos que se borraron.

Para ver ejemplos sobre cómo configurar la acción DeleteDocuments, consulta Ejemplos.

Acción DistinctValues

Esta acción muestra los valores distintos de un campo en una colección.

Parámetros de entrada de la acción DistinctValues

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	El nombre de la colección de MongoDB.
campo	String	Sí	Es el nombre del campo para consultar valores distintos.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de querytype.

Para ver ejemplos sobre cómo configurar la acción DistinctValues, consulta Ejemplos.

Acción InsertDocument

Esta acción inserta un documento en una colección.

En las siguientes tablas, se describen los parámetros de entrada y salida de la acción InsertDocument.

Parámetros de entrada de la acción InsertDocument

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
documento	String	No	Es el documento que se agregará a una colección de MongoDB.

Parámetros de salida de la acción InsertDocument

Esta acción muestra el ID del documento insertado.

Para ver ejemplos sobre cómo configurar la acción InsertDocument, consulta Ejemplos.

Acción ListDocuments

En las siguientes tablas, se describen los parámetros de entrada y salida de la acción ListDocuments.

Parámetros de entrada de la acción ListDocuments

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de querytype.
page_size	Número entero	No	Es la cantidad de elementos que se incluirán en cada página del conjunto de resultados.
page_no	Número entero	No	Es el índice de la página que se recuperará del conjunto de resultados. El índice comienza en 0.
proyección	String	No	Es el conjunto de campos o propiedades que se incluirán en la proyección de la consulta en formato Mongo.
sort_by	String	No	Es la especificación del orden de los resultados de la consulta con el formato JSON binario (BSON) de MongoDB.

Parámetros de salida de la acción ListDocuments

La acción muestra la lista de documentos que cumplen con la condición del filtro según el tamaño de la página. El tamaño de página predeterminado es de 25 y el máximo es de 50,000.

Para ver ejemplos sobre cómo configurar la acción ListDocuments, consulta Ejemplos.

Acción UpdateDocuments

En las siguientes tablas, se describen los parámetros de entrada y salida de la acción UpdateDocuments.

Parámetros de entrada de la acción UpdateDocuments

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
valores	String	No	Valores que se actualizarán en el formato Mongo.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de tipo de consulta.
Actualizar o insertar	Booleano	No	Indica si la operación es de inserción o actualización.

Parámetros de salida de la acción UpdateDocuments

La acción muestra la cantidad de documentos que se actualizaron.

Para ver ejemplos sobre cómo configurar la acción UpdateDocuments, consulta Ejemplos.

Acción UpdateDocumentsWithEncryption

Esta acción permite al usuario actualizar los valores encriptados.En las siguientes tablas, se describen los parámetros de entrada y salida de la acción UpdateDocumentsWithEncryption.

Parámetros de entrada de la acción UpdateDocumentsWithEncryption

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
colección	String	Sí	Es el nombre de la colección de MongoDB.
documento	String	No	Es el documento que contiene los valores que se actualizarán. Los valores pueden contener campos que se encriptarán con CSFLE.
filter	String	No	Es una condición de filtro expresada en formato de consulta de MongoDB. Esta condición puede contener campos encriptados si el esquema de encriptación está habilitado para la igualdad de querytype.
Actualizar o insertar	Booleano	No	Especifica si la operación es upsert.

Parámetros de salida de la acción UpdateDocumentsWithEncryption

La acción muestra la cantidad de documentos que se actualizaron.

Para ver ejemplos sobre cómo configurar la acción UpdateDocumentsWithEncryption, consulta Ejemplos.

Ejemplos

En esta sección, se describe cómo realizar algunas de las operaciones y acciones de la entidad en este conector.

Ejemplo: Cambios agregados en la canalización

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción AggregatePipeline y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   {
     "collection": "restaurants",
     "pipeline": {
       "stages": [
         "{$addFields: { \"new_menu_item\": \"tea\"}}"
       ]
     },
     "page_size": 1,
     "page_no": 0
   }

En este ejemplo, se agrega un nuevo elemento de menú a todos los documentos de la colección restaurant y se muestra la primera página del resultado.

Ejemplo: Cómo contar documentos

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CountDocuments y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   {
   "collection":"restaurants",
   "filter": "{\"name\": \"CarvelIceCream1\"}"
   }

En este ejemplo, se muestra el recuento de documentos que coinciden con los criterios de filtro. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Connectors tendrá un valor similar al siguiente:

{
  "results": [
   {
    "count": 5
   }
  ]
}

Ejemplo: Borra documentos

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DeleteDocuments y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa lo siguiente en el campo Default Value:

   {
     "collection": "Insurancedocuments",
     "filter": "{\"insurance.provider\":\"ABC\"}"}

En este ejemplo, se borran todos los documentos que tienen el proveedor de seguros como ABC.

Ejemplo: Busca valores distintos en una colección

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DistinctValues y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   {"collection":"restaurants","field":"contact"}

En este ejemplo, se muestran los valores distintos de la colección restaurants. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Connectors tendrá un valor similar al siguiente:

{
 "results": [
  {
   "DistinctValues": [
    "3217902323",
    "8747479023",
    "3492619023"
   ]
  }
 ]
}

Ejemplo: Cómo insertar un documento

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción InsertDocument y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   { {
   "collection": "Insurancedocuments",
   "document": "{\"fname\":\"firstName\",
   \"lname\":\"lastName\",
   \"passportId\":\"ABCD1234\",
   \"bloodType\":\"A\",
   \"medicalRecords\":[{\"item\":\"name1\"},{\"item\":\"name2\"}],
   \"insurance\":{\"policyNumber\":\"12345\",\"provider\":\"provider2\"}}"
   } }

En este ejemplo, se inserta un documento en la colección Insurancedocuments. El contenido del documento se especifica en el campo document. Si la挿挿 inserción se realiza correctamente, obtendrás el ID del documento insertado en el parámetro de respuesta connectorOutputPayload de la tarea Connectors.

Ejemplo: Lista de documentos

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción ListDocuments y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   {
   "collection": "Insurancedocuments",
   "filter": "{\"insurance.provider\":\"ABC\"}",
   "page_size": 10
   }

En este ejemplo, se muestran documentos en la colección Insurancedocuments en los que el proveedor de seguros es ABC. El tamaño de página del conjunto de resultados se establece en 10, y la lista de archivos estará disponible en formato JSON en el parámetro de respuesta connectorOutputPayload de la tarea Connectors.

Ejemplo: Actualiza documentos

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción UpdateDocuments y haz clic en Listo.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en campo Default Value:

   {"collection":"Insurancedocuments",
   "values":" {$set: { lname:\"Smith\" }}",
   "filter":"{\"insurance.provider\":\"ABC\"}"}

En este ejemplo, se actualiza el apellido a Smith en los documentos que coinciden con los criterios de filtro. Si la actualización se realiza correctamente, obtendrás el recuento de la cantidad de documentos que se actualizaron. La respuesta estará disponible en el parámetro de respuesta connectorOutputPayload de la tarea Connectors.

Ejemplo: Actualiza documentos con encriptación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción UpdateDocumentsWithEncryption y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa lo siguiente en el campo Default Value:

   { {"collection":"Insurancedocuments",
   "document":" { \"insurance.provider\":\"XYZ\" }",
   "filter":"{\"insurance.provider\":\"ABC\"}"}

En este ejemplo, se actualiza el proveedor de seguros a XYZ en todos los documentos que tienen el proveedor de seguros como ABC.

Usa Terraform para crear conexiones

Puedes usar el recurso de Terraform para crear una conexión nueva.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para la creación de conexiones, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
base de datos	STRING	Verdadero	Es el nombre de la base de datos de MongoDB.
tiempo de espera agotado	INTEGER	Falso	Tiempo de espera de la conexión en segundos
enable_ssl	BOOLEAN	Falso	Este campo configura si SSL está habilitado.
app_name	STRING	Falso	Es el nombre de la app personalizado para MongoDB.
max_staleness_seconds	INTEGER	Falso	Es el tiempo, en segundos, que puede estar inactivo un elemento secundario antes de que el cliente deje de usarlo para operaciones de lectura.
write_concern	STRING	Falso	Es una opción para solicitar el acuse de recibo de que la operación de escritura se propagó a una cantidad específica de instancias con etiquetas específicas.
write_concern_timeout	INTEGER	Falso	Especifica un límite de tiempo, en milisegundos, para la preocupación de escritura.
write_concern_journal	BOOLEAN	Falso	Solicita el acuse de recibo de MongoDB de que la operación de escritura se escribió en el registro.
read_preference	ENUM	Falso	Lee las preferencias de esta conexión. Los valores admitidos son: primary, primaryPreferred, secondary, secondaryPreferred, nearest
cluster_type	ENUM	Falso	Especifica el tipo de clúster de MongoDB. Los valores admitidos son: REPLICA_SET, STANDALONE, SHARDED, UNKNOWN
enable_encryption	BOOLEAN	Falso	Este campo establece si la encriptación está habilitada.
encryption_type	ENUM	Falso	En este campo, se establece el tipo de encriptación habilitado. Los valores admitidos son: local
encryption_schema	STRING	Falso	Información del esquema de encriptación, incluidos los campos y el algoritmo de encriptación que se usó
encryption_master_key	SECRET	Falso	Secreto de Secret Manager que contiene la clave maestra de encriptación
encryption_key_vault	STRING	Falso	Es el valor de Key Vault de encriptación.
auth_database	STRING	Verdadero	Es el nombre de la base de datos de MongoDB para la autenticación.

Usa la conexión de MongoDB en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. Puedes usar la conexión en una integración a través de la tarea Connectors.

• Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
• Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?

• Obtén información para suspender y reanudar una conexión.
• Obtén información para supervisar el uso de los conectores.
• Obtén información para ver los registros de los conectores.