Ir para o conteúdo

Conector do Azure Cosmos DB para o Jitterbit Studio

Resumo

O conector do Azure Cosmos DB estabelece acesso ao Azure Cosmos DB.

O conector do Azure Cosmos DB fornece uma interface para criar uma conexão do Azure Cosmos DB, que é a base utilizada para gerar instâncias de atividades do Azure Cosmos DB. Essas atividades, uma vez configuradas, interagem com o Azure Cosmos DB por meio da conexão.

O conector do Azure Cosmos DB é acessado na aba Endpoints e conectores do projeto da paleta de componentes de design (veja a Paleta de componentes de design).

Nota

Este conector pode ser usado apenas com agentes privados. Além disso, é um conector baseado no Connector SDK, que pode ser mencionado pelo Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

Endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Documentação da conexão

Além da conexão do Azure Cosmos DB, consulte a página abrangente de detalhes da conexão do Azure Cosmos DB. Detalhes de configuração como estes estão incluídos nessa página:

  • Introdução: Passos iniciais para estabelecer uma conexão.
  • Recursos Avançados: Visualizações definidas pelo usuário e configuração de SSL.
  • Modelo de Dados: O modelo de dados que o conector usa para representar o endpoint.
  • Propriedades de Configurações Avançadas: Propriedades que podem ser definidas para configurar uma conexão para configurações básicas e avançadas.

Documentação da atividade

Juntas, uma conexão específica do Azure Cosmos DB e suas atividades são referidas como um endpoint do Azure Cosmos DB:

Tipos de atividade do Azure Cosmos DB

  • Consulta: Recupera registros de uma tabela no Azure Cosmos DB e é destinado a ser usado como uma fonte em uma operação.

  • Criar: Insere um registro em uma tabela no Azure Cosmos DB e é destinado a ser usado como um destino em uma operação.

  • Atualizar: Atualiza um registro em uma tabela no Azure Cosmos DB e é destinado a ser usado como um destino em uma operação.

  • Excluir: Exclui um registro de uma tabela no Azure Cosmos DB e é destinado a ser usado como um destino em uma operação.

  • Executar: Executa um procedimento no Azure Cosmos DB e é destinado a ser usado como um destino em uma operação.

Pré-requisitos e versões de API suportadas

O conector do Azure Cosmos DB requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

Este conector requer o uso de um agente privado.

Consulte a documentação do endpoint para obter informações sobre os nós e campos do esquema.

Solução de problemas

Se você encontrar problemas com o conector do Azure Cosmos DB, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

  2. Certifique-se de que quaisquer registros de aplicativos do Microsoft Entra ID associados à conexão não estejam usando o Azure AD Graph obsoleto.

  3. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  4. Ative o registro de depuração de operação para agentes privados para gerar arquivos de log e dados adicionais.

  5. Ative o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.verbose.logging.CosmosDB" level="TRACE"/>
    

    Para mais informações sobre o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

  6. Verifique os logs do agente para mais informações.

  7. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.