MongoDB (versão 2)

O conector do MongoDB permite executar operações de inserção, exclusão, atualização e leitura em um banco de dados do MongoDB.

Versões compatíveis

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

Antes de começar

Antes de usar o conector do MongoDB, faça o seguinte:

  • No seu projeto do Google Cloud, faça o seguinte:
    • Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede. Para saber como configurar a conectividade de rede para o cluster do MongoDB Atlas, consulte Conectividade particular para um cluster do MongoDB Atlas.
    • Conceda o papel do IAM roles/connectors.admin ao usuário que está configurando o conector.
    • Conceda os seguintes papéis de IAM à conta de serviço que você quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google. Se você não tiver uma conta de serviço, será necessário criar uma. Para mais informações, consulte Como criar uma conta de serviço.

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

      Para informações sobre como ativar serviços, consulte Como ativar serviços.

      Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

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

      Para restringir o acesso à rede do cluster do Atlas, configure o conector do MongoDB para usar um conjunto de endereços IP estáticos para o tráfego originado das conexões. Para entender como permitir que sua conexão se conecte por um firewall, consulte Conectar-se ao aplicativo de back-end público por um firewall.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + Criar novo para abrir a página Criar conexão.
  3. Na seção Local, escolha o local da conexão.
    1. Região: selecione um local na lista suspensa.

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em Próxima.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione MongoDB na lista suspensa de conectores disponíveis.
    2. Versão do conector: selecione a versão 2 na lista de versões.
    3. No campo Nome da conexão, insira um nome para a instância de conexão

      Os nomes de conexão precisam atender aos seguintes critérios:

      • Os nomes de conexões podem usar letras, números ou hifens.
      • As letras precisam ser minúsculas.
      • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das conexões não podem exceder 49 caracteres.
    4. Como opção, insira uma Descrição para a instância de conexão.
    5. Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    7. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    8. Banco de dados: o nome do banco de dados do MongoDB a que se conectar.
    9. Tempo limite de conexão: especifique o tempo em segundos para aguardar a conclusão de uma operação antes de cancelar.
    10. Tamanho máximo do pool de conexões: especifique o número máximo de conexões permitidas no pool de conexões.
    11. Tamanho mínimo do pool de conexões: especifique o número mínimo de conexões mantidas no pool de conexões.
    12. Tempo de inatividade da conexão em segundos: especifique o tempo máximo de inatividade em segundos que uma conexão pode existir no pool antes de ser fechada.
    13. Tempo de vida da conexão em segundos: especifique o tempo máximo de vida de uma conexão em segundos. Após esse limite, a conexão é fechada.
    14. Usar SSL: especifique se o SSL está ativado ou não.
    15. Nome do app: nome personalizado do app para o Mongo.
    16. Segundos de desatualização máxima: tempo em segundos que um secundário pode ficar desatualizado antes que o cliente pare de usá-lo para operações de leitura.
    17. Nível de confirmação de gravação(opção w): opção para solicitar o reconhecimento de que a operação de gravação foi propagada para um número especificado de instâncias com tags específicas.
    18. Nível de confirmação de gravação(opção wtimeoutMS): especifica um limite de tempo, em milissegundos, para o nível de confirmação de gravação.
    19. Write Concern(opção de diário): solicita o reconhecimento do MongoDB de que a operação de gravação foi gravada no diário.
    20. Preferência de leitura: defina como uma estratégia para ler a partir de um conjunto de réplicas. Os valores aceitos são primary, primaryPreferencial, secondary, secondaryPreference e nearest.
    21. Tipo de cluster: especifique o tipo de cluster do MongoDB.
    22. Ativar criptografia: especifique se a criptografia está ativada.
    23. Tipo de criptografia: especifique o tipo de criptografia ativado. No momento, apenas o tipo Local Encryption é compatível.
    24. Esquema de criptografia: especifique as informações do esquema de criptografia, incluindo os campos e o algoritmo de criptografia, o nome alternativo da chave, o tipo de consulta e o fator de disputa. 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: o secret do Secret Manager que contém a chave mestra de criptografia.
    26. encryption_key_vault: valor do cofre de chaves de criptografia.
    27. Banco de dados de autenticação: especifique o nome do banco de dados do MongoDB para autenticação.
    28. Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
    29. Clique em PRÓXIMA.
  5. Na seção Destinos, insira os detalhes do host remoto (sistema de back-end) ao qual você quer se conectar.
    1. Tipo de destino: é possível especificar os detalhes de destino como um endereço de host, que pode ser qualquer um dos seguintes:
      • String SRV única do Mongo. Por exemplo, mongodb+srv://cluster2.2f.mongodb.net.
      • Réplicas individuais. Por exemplo, dasdsf.2f.mongodb01.net.
      • ele vai receber um novo endereço IP. Por exemplo,10.23.123.12

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

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

        Se quiser estabelecer uma conexão particular com seu back-end, faça o seguinte:

      Para inserir outros destinos, clique em +ADICIONAR DESTINO.

    2. Clique em PRÓXIMA.
  6. Na seção Autenticação, insira os detalhes da autenticação.
    1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      Os seguintes tipos de autenticação são compatíveis com a conexão do MongoDB:

      • Nome de usuário e senha
    2. Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

    3. Clique em PRÓXIMA.
  7. Revisão: revise os detalhes de conexão e autenticação.
  8. Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

  • Nome de usuário e senha
    • Nome de usuário: nome de usuário para o conector
    • Senha: o Secret do Secret Manager que contém a senha do usuário.
    • Esquema de autenticação: o esquema usado para autenticação.

      Os seguintes esquemas de autenticação são compatíveis com a conexão do MongoDB:

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

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

  • Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

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

  • Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações não serão listadas na lista Operations.

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

Limitações do sistema

O conector do MongoDB pode processar no máximo 70 transações por segundo, por , e limita qualquer transação além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

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

Tipos de dados compatíveis

Estes são os tipos de dados compatíveis com esse conector:

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

Configuração do cluster do MongoDB Atlas

A configuração de autenticação de um cluster do MongoDB Atlas é um pouco diferente das etapas documentadas anteriormente. Para autenticar em um cluster do Atlas, você precisa primeiro receber a string de conexão do Atlas. Para receber a string de conexão do Atlas, execute as seguintes etapas:

  1. Na visualização de clusters, clique em "Conectar" ao cluster a que você quer se conectar.
  2. Clique em "Connect Your Application".
  3. Selecione uma das opções de driver para exibir uma string de conexão.

Para autenticar em um cluster do Atlas, use a seguinte configuração:

  • Banco de dados do Auth: defina o valor como admin, já que todos os usuários do MongoDB Atlas são associados ao banco 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 usuário e a senha.

Ações

Esta seção lista todas as ações compatíveis com a conexão do MongoDB.

Ação AggregatePipeline

Essa ação agrega as mudanças do pipeline em uma coleção.

Parâmetros de entrada da ação AggregatePipeline

Nome do parâmetro Tipo de dados Obrigatório Descrição
coleção String Sim O nome da coleção do MongoDB.
pipeline String Sim Pipeline de agregação que contém estágios de campo como uma lista de strings.
page_size Número inteiro Não O número de itens a serem incluídos em cada página do conjunto de resultados.
page_no Número inteiro Não O índice da página a ser extraída do conjunto de resultados. O índice começa em 0.

Veja como configurar a ação AggregatePipeline em Exemplos.

Ação CountDocuments

Essa ação conta todos os documentos que atendem a uma determinada condição em uma coleção.

Parâmetros de entrada da ação CountDocuments

Nome do parâmetro Tipo de dados Obrigatório Descrição
coleçã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. Essa condição pode conter campos criptografados se o esquema de criptografia estiver ativado para igualdade de querytype.

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

Essa ação retorna a contagem de todos os documentos que atendem a uma determinada condição.

Veja como configurar a ação CountDocuments em Exemplos.

Ação DeleteDocuments

Essa ação exclui documentos em uma coleção.

Parâmetros de entrada da ação DeleteDocuments

Nome do parâmetro Tipo de dados Obrigatório Descrição
coleçã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. Essa condição pode conter campos criptografados se o esquema de criptografia estiver ativado para igualdade do tipo de consulta.

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

A ação retorna a contagem de documentos excluídos.

Veja como configurar a ação DeleteDocuments em Exemplos.

Ação DistinctValues

Essa ação retorna os valores distintos de um campo em uma coleção.

Parâmetros de entrada da ação DistinctValues

Nome do parâmetro Tipo de dados Obrigatório Descrição
coleçã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. Essa condição pode conter campos criptografados se o esquema de criptografia estiver ativado para igualdade de querytype.

Veja como configurar a ação DistinctValues em Exemplos.

Ação InsertDocument

Essa ação insere um documento em uma coleção.

As tabelas a seguir 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ório Descrição
coleção String Sim O nome da coleção do MongoDB.
documento String Não Documento a ser adicionado a uma coleção do MongoDB.

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

Essa ação retorna o ID do documento inserido.

Veja como configurar a ação InsertDocument em Exemplos.

Ação ListDocuments

As tabelas a seguir 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ório Descrição
coleçã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. Essa condição pode conter campos criptografados se o esquema de criptografia estiver ativado para igualdade de querytype.
page_size Número inteiro Não O número de itens a serem incluídos em cada página do conjunto de resultados.
page_no Número inteiro Não O índice da página a ser extraída do conjunto de resultados. O índice começa em 0.
projeção String Não O conjunto de campos ou propriedades a serem incluídos na projeção de consulta no formato do MongoDB.
sort_by String Não A especificação da ordenação dos resultados da consulta usando o formato JSON binário (BSON) do MongoDB.

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

A ação retorna a lista de documentos que atendem à condição de filtro de acordo com o tamanho da página. O tamanho padrão da página é 25, e o máximo é 50.000.

Veja como configurar a ação ListDocuments em Exemplos.

Ação UpdateDocuments

As tabelas a seguir 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ório Descrição
coleção String Sim O nome da coleção do MongoDB.
values String Não Valores a serem atualizados no formato do Mongo.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Essa condição pode conter campos criptografados se o esquema de criptografia estiver ativado para igualdade do tipo de consulta.
upsert Booleano Não A operação é de upsert ou não.

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

A ação retorna o número de documentos atualizados.

Veja como configurar a ação UpdateDocuments em Exemplos.

Ação UpdateDocumentsWithEncryption

Essa ação permite que o usuário atualize os valores criptografados.As tabelas a seguir 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ório Descrição
coleçã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 serão criptografados usando CSFLE.
filtrar String Não Uma condição de filtro expressa no formato de consulta do MongoDB. Essa condição pode conter campos criptografados se o esquema de criptografia 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 retorna o número de documentos atualizados.

Veja como configurar a ação UpdateDocumentsWithEncryption em Exemplos.

Exemplos

Nesta seção, descrevemos como executar algumas das operações e ações da entidade neste conector.

Exemplo: mudanças agregadas no pipeline

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AggregatePipeline e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 retorna a primeira página do resultado.

Exemplo: contar documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CountDocuments e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:
    {
    "collection":"restaurants",
    "filter": "{\"name\": \"CarvelIceCream1\"}"
    }
  4. Este exemplo retorna a contagem de documentos que correspondem aos critérios de filtro. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connectors terá um valor semelhante a este:

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

Exemplo: excluir documentos

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DeleteDocuments e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira o seguinte no campo Default Value:
    {
      "collection": "Insurancedocuments",
      "filter": "{\"insurance.provider\":\"ABC\"}"}
  4. Este exemplo exclui todos os documentos que têm a seguradora como ABC.

Exemplo: encontrar valores distintos em uma coleção

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DistinctValues e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:
    {"collection":"restaurants","field":"contact"}
  4. Este exemplo retorna os valores distintos na coleção restaurants. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connectors terá um valor semelhante a este:

    {
     "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 clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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, você vai receber 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 clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:
    {
    "collection": "Insurancedocuments",
    "filter": "{\"insurance.provider\":\"ABC\"}",
    "page_size": 10
    }
  4. Este exemplo retorna documentos na coleção Insurancedocuments em que o provedor de seguros é ABC. O tamanho da página do conjunto de resultados é definido como 10, e a lista de arquivos estará 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 clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:
    {"collection":"Insurancedocuments",
    "values":" {$set: { lname:\"Smith\" }}",
    "filter":"{\"insurance.provider\":\"ABC\"}"}
  4. Este exemplo atualiza o sobrenome para Smith nos documentos que correspondem aos critérios de filtro. Se a atualização for bem-sucedida, você vai receber a contagem do número de documentos atualizados. A resposta vai estar disponível no parâmetro de resposta connectorOutputPayload da tarefa Connectors.

Exemplo: atualizar documentos com criptografia

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateDocumentsWithEncryption e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira o seguinte no campo Default Value:
    { {"collection":"Insurancedocuments",
    "document":" { \"insurance.provider\":\"XYZ\" }",
    "filter":"{\"insurance.provider\":\"ABC\"}"}
  4. Este exemplo atualiza o provedor de seguros para XYZ em todos os documentos que têm o provedor de seguros como ABC.

Criar conexões usando o Terraform

Use o recurso do Terraform para criar uma conexão.

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

Para conferir um modelo de exemplo do Terraform para criação de conexão, consulte modelo de exemplo.

Ao criar essa conexão usando o Terraform, defina as seguintes variáveis no arquivo de configuração do Terraform:

Nome do parâmetro Tipo de dados Obrigatório Descrição
database STRING Verdadeiro O nome do banco de dados do MongoDB.
timeout INTEGER Falso Tempo limite de conexão em segundos.
enable_ssl BOOLEAN Falso Esse campo define se o SSL está ativado.
app_name STRING Falso Nome do app personalizado para o MongoDB.
max_staleness_seconds INTEGER Falso Tempo em segundos que uma réplica secundária pode ficar desatualizada antes que o cliente pare de usá-la para operações de leitura.
write_concern STRING Falso Opção para solicitar o reconhecimento de que a operação de gravação foi propagada para um número especificado de instâncias com tags especificadas.
write_concern_timeout INTEGER Falso Especifica um limite de tempo, em milissegundos, para a confirmação de gravação.
write_concern_journal BOOLEAN Falso Solicita o reconhecimento do MongoDB de que a operação de gravação foi gravada no diário.
read_preference ENUM Falso Leia as preferências desta conexão. Os valores aceitos são: primary, primaryPreferred, secondary, secondaryPreferred, nearest
cluster_type ENUM Falso Especifica o tipo de cluster do MongoDB. Os valores aceitos são: REPLICA_SET, STANDALONE, SHARDED, UNKNOWN
enable_encryption BOOLEAN Falso Esse campo define se a criptografia está ativada.
encryption_type ENUM Falso Esse campo define o tipo de criptografia ativada. Os valores aceitos são: local
encryption_schema STRING Falso Informações do esquema de criptografia, incluindo os campos e o algoritmo de criptografia usados.
encryption_master_key SECRET Falso Secret do Secret Manager que contém a chave mestra de criptografia.
encryption_key_vault STRING Falso Valor do Key Vault da chave de criptografia.
auth_database STRING Verdadeiro O nome do banco de dados do MongoDB para autenticação.

Usar a conexão do MongoDB em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
  • Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir