MongoDB (versão 2)

O conetor do MongoDB permite-lhe realizar operações de inserção, eliminação, atualização e leitura numa base de dados do MongoDB.

Versões suportadas

  • Versões 3.6 a 6.1 do MongoDB
  • Mongo Atlas implementado no Google Cloud.

Antes de começar

Antes de usar o conector do MongoDB, conclua as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede. Para obter informações sobre como configurar a conetividade de rede para o cluster do MongoDB Atlas, consulte o artigo Conetividade privada para um cluster do MongoDB Atlas.
    • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
    • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para obter informações sobre como ativar serviços, consulte o artigo Ativar serviços.

      Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

    • Restrinja o acesso à rede ao seu cluster do Atlas com uma firewall:

      Para restringir o acesso à rede ao seu cluster do Atlas, configure o conector do MongoDB para usar um conjunto de endereços IP estáticos para o tráfego proveniente das ligações. Para compreender como permitir que a sua ligação se ligue através de uma firewall, consulte o artigo Estabeleça ligação à sua aplicação de back-end pública através de uma firewall.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + Criar novo para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clicar em Seguinte.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conector: selecione MongoDB na lista pendente de conectores disponíveis.
    2. Versão do conector: selecione a versão 2 na lista de versões.
    3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    8. Base de dados: o nome da base de dados do MongoDB à qual estabelecer ligação.
    9. Tempo limite de ligação: especifique o tempo em segundos a aguardar pela conclusão de uma operação antes de a cancelar.
    10. Tamanho máximo do conjunto de ligações: especifique o número máximo de ligações permitidas no conjunto de ligações.
    11. Tamanho mínimo do conjunto de ligações: especifique o número mínimo de ligações mantidas no conjunto de ligações.
    12. Tempo de inatividade da ligação em segundos: especifique o tempo de inatividade máximo em segundos que uma ligação pode existir no conjunto antes de ser fechada.
    13. Tempo de vida da ligação em segundos: especifique o tempo de vida máximo de uma ligação em segundos. Após este limite de tempo, a ligação é fechada.
    14. Usar SSL: especifique se o SSL está ativado ou não.
    15. Nome da app: nome da app personalizado para o Mongo.
    16. Max Staleness Seconds: tempo em segundos durante o qual um secundário pode estar desatualizado antes de o cliente deixar de o usar para operações de leitura.
    17. Write Concern(opção w): opção para pedir a confirmação de que a operação de escrita foi propagada a um número especificado de instâncias com etiquetas específicas.
    18. Write Concern(opção wtimeoutMS): especifica um limite de tempo, em milissegundos, para o Write Concern.
    19. Write Concern(opção de registo): pede a confirmação do MongoDB de que a operação de escrita foi escrita no registo.
    20. Read Preference: defina esta opção como uma estratégia para leitura a partir de um conjunto de réplicas. Os valores aceites são primary, primaryPreferred, secondary, secondaryPreferred e nearest.
    21. Tipo de cluster: especifique o tipo de cluster do MongoDB.
    22. Ativar encriptação: especifique se a encriptação está ativada.
    23. Tipo de encriptação: especifique o tipo de encriptação ativada. Atualmente, apenas o tipo Local Encryption é suportado.
    24. Esquema de encriptação: especifique as informações do esquema de encriptação, incluindo os campos e o algoritmo de encriptação, o nome alternativo da chave, o tipo de consulta e o fator de contenção. Por exemplo: 
      {
  "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: Secret do Secret Manager que contém a chave principal de encriptação.
    26. encryption_key_vault: valor do cofre de chaves de encriptação.
    27. Base de dados de autenticação: especifique o nome da base de dados do MongoDB para autenticação.
    28. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    29. Clique em SEGUINTE.
  5. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
    1. Tipo de destino: pode especificar os detalhes do destino como um endereço de anfitrião, que pode ser qualquer um dos seguintes:
      • String SRV Mongo única. Por exemplo, mongodb+srv://cluster2.2f.mongodb.net
      • Réplicas individuais. Por exemplo, dasdsf.2f.mongodb01.net
      • Endereço IP. Por exemplo,10.23.123.12

      O prefixo mongodb:// é adicionado ao URL final depois de combinar todas as réplicas na string de ligação se mongodb+srv não for especificado.

      • Endereço do anfitrião: especifique o nome do anfitrião ou o endereço IP do destino.

        Se quiser estabelecer uma ligação privada ao seu back-end, faça o seguinte:

      Para introduzir destinos adicionais, clique em +ADICIONAR DESTINO.

    2. Clique em SEGUINTE.
  6. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação MongoDB:

      • Nome de utilizador e palavra-passe

      2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

    2. Clique em SEGUINTE.
  7. Rever: reveja os detalhes da ligação e da autenticação.
  8. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

  • Nome de utilizador e palavra-passe
    • Nome de utilizador: nome de utilizador do conetor
    • Palavra-passe: Secret do Secret Manager que contém a palavra-passe do utilizador.
    • Esquema de autenticação: o esquema usado para autenticação.

      O esquema de autenticação seguinte é suportado pela ligação MongoDB:

      • Simples
      • SCRAM-SHA-1
      • SCRAM-SHA-256

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

  • Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

    No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.

  • Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

  • Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Limitações do sistema

O conector do MongoDB pode processar um máximo de 70 transações por segundo, por nó, e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Tipos de dados suportados

Seguem-se os tipos de dados suportados para este conector:

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

Configuração do cluster do MongoDB Atlas

A configuração de autenticação para um cluster do MongoDB Atlas difere ligeiramente dos passos documentados anteriormente. Para se autenticar num cluster do Atlas, tem de obter primeiro a string de ligação do Atlas. Para obter a string de ligação do Atlas, siga estes passos:

  1. Na vista Clusters, clique em Associar para o cluster ao qual quer associar.
  2. Clique em Associar a sua aplicação.
  3. Selecione uma das opções de controlador para apresentar uma string de ligação.

Para fazer a autenticação num cluster do Atlas, use a seguinte configuração:

  • Base de dados de autenticação: defina o valor como admin, uma vez que todos os utilizadores do MongoDB Atlas estão associados à base de dados admin.
  • Usar SSL: defina o valor como true.
  • Servidor: defina o valor como mongodb+srv://MongoDB INSTANCE SERVER NAME sem incluir o nome de utilizador e a palavra-passe.

Ações

Esta secção apresenta todas as ações suportadas pela ligação ao MongoDB.

Ação AggregatePipeline

Esta ação agrega as alterações do pipeline numa coleção.

Introduza os parâmetros da ação AggregatePipeline

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
pipeline String Sim Pipeline de agregação que contém fases de campos como uma lista de strings.
page_size Número inteiro Não O número de itens a incluir em cada página do conjunto de resultados.
page_no Número inteiro Não O índice da página a obter do conjunto de resultados. O índice começa em 0.

Para ver um exemplo de como configurar a ação AggregatePipeline, consulte a secção Exemplos.

Ação CountDocuments

Esta ação conta todos os documentos que satisfazem uma determinada condição numa coleção.

Introduza os parâmetros da ação CountDocuments

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade de querytype.

Parâmetros de saída da ação CountDocuments

Esta ação devolve a contagem de todos os documentos que satisfazem uma determinada condição.

Para ver um exemplo de como configurar a ação CountDocuments, consulte a secção Exemplos.

Ação DeleteDocuments

Esta ação elimina documentos numa coleção.

Parâmetros de entrada da ação DeleteDocuments

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade do tipo de consulta.

Parâmetros de saída da ação DeleteDocuments

A ação devolve a contagem de documentos que foram eliminados.

Para ver um exemplo de como configurar a ação DeleteDocuments, consulte a secção Exemplos.

Ação DistinctValues

Esta ação devolve os valores distintos de um campo numa coleção.

Parâmetros de entrada da ação DistinctValues

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
campo String Sim Nome do campo para consultar valores distintos.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade de querytype.

Para ver um exemplo de como configurar a ação DistinctValues, consulte a secção Exemplos.

Ação InsertDocument

Esta ação insere um documento numa coleção.

As tabelas seguintes descrevem os parâmetros de entrada e saída da ação InsertDocument.

Parâmetros de entrada da ação InsertDocument

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
documento String Não Documento a adicionar a uma coleção do MongoDB.

Parâmetros de saída da ação InsertDocument

Esta ação devolve o ID do documento inserido.

Para ver um exemplo de como configurar a ação InsertDocument, consulte a secção Exemplos.

Ação ListDocuments

As tabelas seguintes descrevem os parâmetros de entrada e saída da ação ListDocuments.

Parâmetros de entrada da ação ListDocuments

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade de querytype.
page_size Número inteiro Não O número de itens a incluir em cada página do conjunto de resultados.
page_no Número inteiro Não O índice da página a obter do conjunto de resultados. O índice começa em 0.
projeção String Não O conjunto de campos ou propriedades a incluir na projeção da consulta no formato Mongo.
sort_by String Não A especificação da ordenação dos resultados da consulta através do formato JSON binário (BSON) do MongoDB.

Parâmetros de saída da ação ListDocuments

A ação devolve a lista de documentos que satisfazem a condição de filtro de acordo com o tamanho da página. O tamanho da página predefinido é 25 e o tamanho máximo da página é 50 000.

Para ver um exemplo de como configurar a ação ListDocuments, consulte a secção Exemplos.

Ação UpdateDocuments

As tabelas seguintes descrevem os parâmetros de entrada e saída da ação UpdateDocuments.

Parâmetros de entrada da ação UpdateDocuments

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
valores String Não Valores a atualizar no formato Mongo.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade do tipo de consulta.
upsert Booleano Não Se a operação é de inserção/atualização ou não.

Parâmetros de saída da ação UpdateDocuments

A ação devolve o número de documentos que foram atualizados.

Para ver um exemplo de como configurar a ação UpdateDocuments, consulte a secção Exemplos.

Ação UpdateDocumentsWithEncryption

Esta ação permite ao utilizador atualizar os valores encriptados.As tabelas seguintes descrevem os parâmetros de entrada e saída da ação UpdateDocumentsWithEncryption.

Parâmetros de entrada da ação UpdateDocumentsWithEncryption

Nome do parâmetro Tipo de dados Obrigatória Descrição
colecção String Sim O nome da coleção do MongoDB.
documento String Não Documento que contém os valores a serem atualizados. Os valores podem conter campos que vão ser encriptados através da CSFLE.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Esta condição pode conter campos encriptados se o esquema de encriptação estiver ativado para igualdade de querytype.
upsert Booleano Não Especifica se a operação é upsert.

Parâmetros de saída da ação UpdateDocumentsWithEncryption

A ação devolve o número de documentos que foram atualizados.

Para ver um exemplo de como configurar a ação UpdateDocumentsWithEncryption, consulte a secção Exemplos.

Exemplos

Esta secção descreve como realizar algumas das operações e ações de entidades neste conector.

Exemplo: agregue alterações do pipeline

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AggregatePipeline e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "collection": "restaurants",
  "pipeline": {
    "stages": [
      "{$addFields: { \"new_menu_item\": \"tea\"}}"
    ]
  },
  "page_size": 1,
  "page_no": 0
}

    4. Este exemplo adiciona um novo item de menu a todos os documentos na coleção restaurant e devolve a primeira página do resultado.

Exemplo: contagem de documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CountDocuments e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
"collection":"restaurants",
"filter": "{\"name\": \"CarvelIceCream1\"}"
}

    4. Este exemplo devolve a contagem de documentos que correspondem aos critérios de filtro. Se a ação for bem-sucedida, o parâmetro de resposta ConnectorsconnectorOutputPayload da tarefa terá um valor semelhante ao seguinte:

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

Exemplo: elimine documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DeleteDocuments e, de seguida, clique em Concluído.
  3. Na secção Entrada de tarefas da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza o seguinte no campo Default Value: 
    {
  "collection": "Insurancedocuments",
  "filter": "{\"insurance.provider\":\"ABC\"}"}

    4. Este exemplo elimina todos os documentos que têm a seguradora como ABC.

Exemplo: encontre valores distintos numa coleção

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DistinctValues e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {"collection":"restaurants","field":"contact"}

    4. Este exemplo devolve os valores distintos na coleção restaurants. Se a ação for bem-sucedida, o parâmetro de resposta ConnectorsconnectorOutputPayload da tarefa terá um valor semelhante ao seguinte:

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

Exemplo: inserir um documento

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação InsertDocument e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no 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. Este exemplo insere um documento na coleção Insurancedocuments. O conteúdo do documento é especificado no campo document. Se a inserção for bem-sucedida, recebe o ID do documento inserido no parâmetro de resposta connectorOutputPayload da tarefa Connectors.

Exemplo: listar documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ListDocuments e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
"collection": "Insurancedocuments",
"filter": "{\"insurance.provider\":\"ABC\"}",
"page_size": 10
}

    4. Este exemplo devolve documentos na coleção Insurancedocuments onde o fornecedor de seguros é ABC. O tamanho da página do conjunto de resultados é definido como 10 e a lista de ficheiros fica disponível no formato JSON no parâmetro de resposta connectorOutputPayload da tarefa Connectors.

Exemplo: atualizar documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateDocuments e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {"collection":"Insurancedocuments",
"values":" {$set: { lname:\"Smith\" }}",
"filter":"{\"insurance.provider\":\"ABC\"}"}

    4. Este exemplo atualiza o apelido para Smith nos documentos que correspondem aos critérios de filtragem. Se a atualização for bem-sucedida, recebe a contagem do número de documentos que foram atualizados. A resposta vai estar disponível no parâmetro de resposta da tarefa ConnectorsconnectorOutputPayload.

Exemplo: atualize documentos com encriptação

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateDocumentsWithEncryption e, de seguida, clique em Concluído.
  3. Na secção Entrada de tarefas da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza o seguinte no campo Default Value: 
    { {"collection":"Insurancedocuments",
"document":" { \"insurance.provider\":\"XYZ\" }",
"filter":"{\"insurance.provider\":\"ABC\"}"}

    4. Este exemplo atualiza o fornecedor de seguros para XYZ em todos os documentos que têm o fornecedor de seguros como ABC.

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro Tipo de dados Obrigatória Descrição
base de dados STRING True O nome da base de dados do MongoDB.
tempo limite excedido INTEGER Falso Limite de tempo da ligação em segundos.
enable_ssl BOOLEAN Falso Este campo define se a tecnologia SSL está ativada.
app_name STRING Falso Nome da app personalizado para o MongoDB.
max_staleness_seconds INTEGER Falso Tempo em segundos durante o qual um secundário pode estar desatualizado antes de o cliente deixar de o usar para operações de leitura.
write_concern STRING Falso Opção para pedir a confirmação de que a operação de escrita foi propagada a um número especificado de instâncias com etiquetas especificadas.
write_concern_timeout INTEGER Falso Especifica um limite de tempo, em milissegundos, para a preocupação de escrita.
write_concern_journal BOOLEAN Falso Pede a confirmação do MongoDB de que a operação de escrita foi escrita no registo.
read_preference ENUM Falso Ler as preferências para esta associação. Os valores suportados são: primary, primaryPreferred, secondary, secondaryPreferred, nearest
cluster_type ENUM Falso Especifica o tipo de cluster do MongoDB. Os valores suportados são: REPLICA_SET, STANDALONE, SHARDED, UNKNOWN
enable_encryption BOOLEAN Falso Este campo define se a encriptação está ativada.
encryption_type ENUM Falso Este campo define o tipo de encriptação ativada. Os valores suportados são: local
encryption_schema STRING Falso Informações do esquema de encriptação, incluindo os campos e o algoritmo de encriptação usados.
encryption_master_key SECRET Falso Secret do Secret Manager que contém a chave principal de encriptação.
encryption_key_vault STRING Falso Valor do Encryption Key Vault.
auth_database STRING True O nome da base de dados do MongoDB para autenticação.

Use a ligação do MongoDB numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?