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:
- No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.
- Clique em + Criar novo para abrir a página Criar conexão.
- Na seção Local, escolha o local da conexão.
- Região: selecione um local na lista suspensa.
Para conferir a lista de todas as regiões com suporte, consulte Locais.
- Clique em Próxima.
- Região: selecione um local na lista suspensa.
- Na seção Detalhes da conexão, faça o seguinte:
- Conector: selecione MongoDB na lista suspensa de conectores disponíveis.
- Versão do conector: selecione a versão
2
na lista de versões. - 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.
- Como opção, insira uma Descrição para a instância de conexão.
- Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como
Error
. - Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
- 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.
- Banco de dados: o nome do banco de dados do MongoDB a que se conectar.
- Tempo limite de conexão: especifique o tempo em segundos para aguardar a conclusão de uma operação antes de cancelar.
- Tamanho máximo do pool de conexões: especifique o número máximo de conexões permitidas no pool de conexões.
- Tamanho mínimo do pool de conexões: especifique o número mínimo de conexões mantidas no pool de conexões.
- 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.
- 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.
- Usar SSL: especifique se o SSL está ativado ou não.
- Nome do app: nome personalizado do app para o Mongo.
- 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.
- 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.
- 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.
- 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.
- 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.
- Tipo de cluster: especifique o tipo de cluster do MongoDB.
- Ativar criptografia: especifique se a criptografia está ativada.
- Tipo de criptografia: especifique o tipo de criptografia ativado. No momento, apenas o tipo
Local Encryption
é compatível. - 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 } } } } } } }
- encryption_master_key: o secret do Secret Manager que contém a chave mestra de criptografia.
- encryption_key_vault: valor do cofre de chaves de criptografia.
- Banco de dados de autenticação: especifique o nome do banco de dados do MongoDB para autenticação.
- Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
- Clique em PRÓXIMA.
- Na seção Destinos, insira os detalhes do host remoto (sistema de back-end) ao qual você quer se conectar.
- 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 semongodb+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:
- Crie um anexo do serviço PSC.
- Crie um anexo de endpoint e insira os detalhes dele no campo Endereço do host.
Para inserir outros destinos, clique em +ADICIONAR DESTINO.
- String SRV única do Mongo. Por exemplo,
- Clique em PRÓXIMA.
- Tipo de destino: é possível especificar os detalhes de destino como
um endereço de host, que pode ser qualquer um dos seguintes:
-
Na seção Autenticação, insira os detalhes da autenticação.
- 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
- Clique em PRÓXIMA.
Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.
- Selecione um Tipo de autenticação e insira os detalhes relevantes.
- Revisão: revise os detalhes de conexão e autenticação.
- 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 nó, 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:
- Na visualização de clusters, clique em "Conectar" ao cluster a que você quer se conectar.
- Clique em "Connect Your Application".
- 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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
AggregatePipeline
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "collection": "restaurants", "pipeline": { "stages": [ "{$addFields: { \"new_menu_item\": \"tea\"}}" ] }, "page_size": 1, "page_no": 0 }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
CountDocuments
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "collection":"restaurants", "filter": "{\"name\": \"CarvelIceCream1\"}" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
DeleteDocuments
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira o seguinte no campoDefault Value
:{ "collection": "Insurancedocuments", "filter": "{\"insurance.provider\":\"ABC\"}"}
Este exemplo exclui todos os documentos que têm a seguradora como ABC
.
Exemplo: encontrar valores distintos em uma coleção
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
DistinctValues
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{"collection":"restaurants","field":"contact"}
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
InsertDocument
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ { "collection": "Insurancedocuments", "document": "{\"fname\":\"firstName\", \"lname\":\"lastName\", \"passportId\":\"ABCD1234\", \"bloodType\":\"A\", \"medicalRecords\":[{\"item\":\"name1\"},{\"item\":\"name2\"}], \"insurance\":{\"policyNumber\":\"12345\",\"provider\":\"provider2\"}}" } }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
ListDocuments
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "collection": "Insurancedocuments", "filter": "{\"insurance.provider\":\"ABC\"}", "page_size": 10 }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
UpdateDocuments
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{"collection":"Insurancedocuments", "values":" {$set: { lname:\"Smith\" }}", "filter":"{\"insurance.provider\":\"ABC\"}"}
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
UpdateDocumentsWithEncryption
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira o seguinte no campoDefault Value
:{ {"collection":"Insurancedocuments", "document":" { \"insurance.provider\":\"XYZ\" }", "filter":"{\"insurance.provider\":\"ABC\"}"}
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
- Entenda como suspender e retomar uma conexão.
- Entenda como monitorar o uso do conector.
- Saiba como ver os registros do conector.