Ir para o conteúdo

Conector do Azure Cosmos DB no 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, a base usada para gerar instâncias de atividades do Azure Cosmos DB. Essas atividades, uma vez configuradas, interagem com o Azure Cosmos DB através da conexão.

Acessa-se o conector do Azure Cosmos DB a partir da aba Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

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

Documentação de conexão

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

  • Primeiros passos: Etapas 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 de atividades

Juntos, uma conexão específica do Azure Cosmos DB e suas atividades são chamados de endpoint do Azure Cosmos DB:

Tipos de atividades do Azure Cosmos DB

  • Consulta: Recupera registros de uma tabela no Azure Cosmos DB e destina-se a ser usado como uma origem em uma operação.

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

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

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

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

Pré-requisitos e versões de API suportadas

Este conector pode ser usado apenas com agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Desabilitar atualização automática de conectores.

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

Solução de problemas

Se você tiver problemas com o conector do Azure Cosmos DB, recomenda-se seguir estas etapas de solução de problemas:

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

  2. Certifique-se de que qualquer registro de aplicativo do Microsoft Entra ID associado à conexão não esteja usando o Azure AD Graph descontinuado.

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

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

  5. Ative o log 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 log detalhado do conector, consulte Log 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.