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

  • Versiones de MongoDB de la 3.6 a la 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 configura 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 obtener información sobre 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.

    • Restringe el acceso a la red a tu clúster de Atlas con un firewall:

      Para restringir el acceso a la red de tu clúster de Atlas, configura el conector de MongoDB para que use un conjunto de direcciones IP estáticas para el tráfico que se origina en las conexiones. Para comprender cómo permitir que tu conexión se conecte a través de un firewall, consulta Cómo conectarte a tu aplicación de backend pública a través de un firewall.

Configura el conector

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, haz lo siguiente:

  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 de la lista de versiones.
    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.

    8. Base de datos: Es el nombre de la base de datos de MongoDB a la que se conectará.
    9. Tiempo de espera de conexión: Especifica el tiempo en segundos que se espera para que se complete una operación antes de cancelarla.
    10. Tamaño máximo del grupo de conexiones: Especifica la cantidad máxima de conexiones permitidas en el grupo de conexiones.
    11. Tamaño mínimo del grupo de conexiones: Especifica la cantidad mínima de conexiones que se mantienen en el grupo de conexiones.
    12. Tiempo de inactividad de la conexión en segundos: Especifica el tiempo de inactividad máximo en segundos que una conexión puede existir en el grupo antes de cerrarse.
    13. Duración de la conexión en segundos: Especifica la duración máxima de una conexión en segundos. Una vez que transcurre este tiempo, la conexión se cierra.
    14. Usar SSL: Especifica si SSL está habilitado o no.
    15. Nombre de la app: Es el nombre personalizado de la app para Mongo.
    16. Max Staleness Seconds: Es el tiempo en segundos que puede estar inactivo un servidor secundario antes de que el cliente deje de usarlo para las operaciones de lectura.
    17. Confirmación de escritura(opción w): Opción para solicitar la confirmación de que la operación de escritura se propagó a una cantidad especificada de instancias con etiquetas específicas.
    18. Write Concern(opción wtimeoutMS): Especifica un límite de tiempo, en milisegundos, para la confirmación de escritura.
    19. Write Concern(opción de registro): Solicita la confirmación de MongoDB de que la operación de escritura se registró.
    20. 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.
    21. Cluster Type: Especifica el tipo de clúster de MongoDB.
    22. Enable Encryption: Especifica si la encriptación está habilitada.
    23. Tipo de encriptación: Especifica el tipo de encriptación habilitado. Actualmente, solo se admite el tipo Local Encryption.
    24. 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
            }
          }
        }
      }
    }
  }
}
    25. encryption_master_key: Es el Secret de Secret Manager que contiene la clave maestra de encriptación.
    26. encryption_key_vault: Es el valor del almacén de claves de encriptación.
    27. Base de datos de autenticación: Especifica el nombre de la base de datos de MongoDB para la autenticación.
    28. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    29. 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:
      • Es una sola cadena de SRV de Mongo. Por ejemplo, mongodb+srv://cluster2.2f.mongodb.net
      • Son 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:

      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

      2. 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.

  • 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:

    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, esas operaciones no admitidas no se incluirán 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.

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, Integration Connectors asigna 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.

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 para un clúster de MongoDB Atlas difiere un poco de los pasos documentados anteriormente. 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 Clusters, haz clic en Connect para el clúster al que deseas conectarte.
  2. Haz clic en Connect Your Application.
  3. Selecciona cualquiera de las opciones de controlador 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.
  • Usar SSL: Establece el valor en verdadero.
  • 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.

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í Nombre de la colección de MongoDB.
canalización String Sí Canalización de agregación que contiene etapas de campos 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 Í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í Nombre de la colección de MongoDB.
filtrar 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 devuelve 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í Nombre de la colección de MongoDB.
filtrar 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 devuelve el recuento de los documentos que se borraron.

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

Acción DistinctValues

Esta acción devuelve 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í Nombre de la colección de MongoDB.
campo String Sí Nombre del campo para el que se consultarán los valores distintos.
filtrar 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í 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 devuelve el ID del documento insertado.

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

Acción de 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í Nombre de la colección de MongoDB.
filtrar 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 Í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 de 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 devuelve la lista de documentos que satisfacen la condición de filtro según el tamaño de la página. El tamaño de página predeterminado es 25 y el tamaño máximo de página es 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í Nombre de la colección de MongoDB.
valores String No Son los valores que se actualizarán en formato de Mongo.
filtrar 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 upsert o no.

Parámetros de salida de la acción UpdateDocuments

La acción devuelve 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í Nombre de la colección de MongoDB.
documento String No Documento que contiene los valores que se actualizarán. Los valores pueden contener campos que se encriptarán con CSFLE.
filtrar 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 Especifica si la operación es upsert.

Parámetros de salida de la acción UpdateDocumentsWithEncryption

La acción devuelve 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 en la canalización de agregació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
}

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

Ejemplo: Recuento de 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\"}"
}

    4. En este ejemplo, se devuelve 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\"}"}

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

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"}

    4. En este ejemplo, se devuelven 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: Inserta 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\"}}"
} }

    4. 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
}

    4. En este ejemplo, se muestran los documentos de 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\"}"}

    4. 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\"}"}

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

Crea conexiones con Terraform

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 Nombre de la base de datos de MongoDB.
tiempo de espera agotado INTEGER Falso Tiempo de espera de conexión en segundos.
enable_ssl BOOLEAN Falso Este campo configura si SSL está habilitado.
app_name STRING Falso Nombre personalizado de la app para MongoDB.
max_staleness_seconds INTEGER Falso Es el tiempo en segundos que puede estar desactualizada una réplica secundaria antes de que el cliente deje de usarla para las operaciones de lectura.
write_concern STRING Falso Opción para solicitar la confirmación de que la operación de escritura se propagó a una cantidad especificada de instancias con etiquetas especificadas.
write_concern_timeout INTEGER Falso Especifica un límite de tiempo, en milisegundos, para la confirmación de escritura.
write_concern_journal BOOLEAN Falso Es la confirmación de MongoDB de que la operación de escritura se registró en el diario.
read_preference ENUM Falso Lee las preferencias para 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 y UNKNOWN.
enable_encryption BOOLEAN Falso Este campo establece si la encriptación está habilitada.
encryption_type ENUM Falso Este campo establece el tipo de encriptación habilitado. Los valores admitidos son: local
encryption_schema STRING Falso Es la información del esquema de encriptación, incluidos los campos y el algoritmo de encriptación que se usaron.
encryption_master_key SECRET Falso Secret de Secret Manager que contiene la clave maestra de encriptación.
encryption_key_vault STRING Falso Es el valor de Key Vault de la clave de encriptación.
auth_database STRING Verdadero 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 Application Integration. 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 Apigee Integration, 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?