Ir para o conteúdo

Conexão do Azure Cosmos DB

Introdução

Uma conexão do Azure Cosmos DB, criada usando o conector do Azure Cosmos DB, estabelece acesso ao Azure Cosmos DB. Essas atividades, uma vez configuradas, interagem com o Azure Cosmos DB por meio da conexão.

Criar Ou Editar uma Conexão do Azure Cosmos DB

Uma nova conexão do Azure Cosmos DB é criada usando o conector do Azure Cosmos DB de um destes locais:

Uma conexão existente do Azure Cosmos DB pode ser editada nestes locais:

Configurar uma Conexão do Azure Cosmos DB

Cada elemento da interface do usuário da tela de configuração de conexão do Azure Cosmos DB é descrito abaixo.

Dica

Campos com um ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para usar para identificar a conexão. O nome deve ser exclusivo para cada conexão do Azure Cosmos DB e não deve conter barras (/) ou dois pontos (:). Esse nome também é usado para identificar o endpoint do Azure Cosmos DB, que se refere a uma conexão específica e suas atividades.

  • Endpoint da conta: Insira o endpoint da conta.

  • Esquema de autorização: Selecione o esquema de autorização, um dos seguintes:

    • Chave de Conta

      • Chave da conta: Insira a chave da conta.

      • Tipo de token: Selecione o tipo de token, um dos seguintes:

        • mestre

        • recurso

    • AzureAD

      • Iniciar OAuth: Selecione a configuração OAuth, uma das seguintes:

        • DESLIGADO

          • Token de acesso OAuth: Insira o token de acesso OAuth.

        • OBTENHAEATUALIZE

        • ATUALIZAR

          • Token de acesso OAuth: Insira o token de acesso OAuth.

      • ID do cliente OAuth: Insira o ID do cliente OAuth.

      • Segredo do cliente OAuth: Insira o segredo do cliente OAuth.

      • Token de atualização do OAuth: Insira o token de atualização do OAuth.

    • AzureServicePrincipal

      • Locatário do Azure: Insira o locatário do Azure.

      • Iniciar OAuth: Selecione a configuração OAuth, uma das seguintes:

        • DESLIGADO

          • Token de acesso OAuth: Insira o token de acesso OAuth.

        • OBTENHAEATUALIZE

        • ATUALIZAR

          • Token de acesso OAuth: Insira o token de acesso OAuth.

      • ID do cliente OAuth: Insira o ID do cliente OAuth.

      • Segredo do cliente OAuth: Insira o segredo do cliente OAuth.

      • Token de atualização do OAuth: Insira o token de atualização do OAuth.

    • AzureServicePrincipalCert

      • Locatário do Azure: Insira o locatário do Azure.

      • Iniciar OAuth: Selecione a configuração OAuth, uma das seguintes:

        • DESLIGADO

          • Token de acesso OAuth: Insira o token de acesso OAuth.

        • OBTENHAEATUALIZE

        • ATUALIZAR

          • Token de acesso OAuth: Insira o token de acesso OAuth.

      • ID do cliente OAuth: Insira o ID do cliente OAuth.

      • Token de atualização do OAuth: Insira o token de atualização do OAuth.

      • Certificado OAuth JWT: Insira o certificado OAuth JWT.

      • Tipo de certificado OAuth JWT: Selecione o tipo de certificado OAuth JWT, um dos seguintes:

        • USUÁRIO

        • MÁQUINA

        • ARQUIVO PFX

        • PFXBLOB

        • JKSFILE

        • JKSBLOB

        • ARQUIVO_PEMKEY

        • PEMKEY_BLOB

        • ARQUIVO_DE_CHAVE_PÚBLICA

        • BLOB_DE_CHAVE_PÚBLICA

        • ARQUIVO_DE_CHAVE_SSHPUBLIC

        • BLOB_DE_CHAVE_SSHPUBLIC

        • P7BFILE

        • ARQUIVO PPK

        • ARQUIVO XML

        • XMLBLOB

      • Senha do certificado OAuth JWT: Digite a senha do certificado OAuth JWT.

      • Assunto do certificado OAuth JWT: Insira o assunto do certificado OAuth JWT.

  • Esquema: Insira o esquema.

  • Usar configurações de proxy: Selecione para usar configurações de proxy do agente privado.

  • Configurações avançadas: Quando selecionado, mostra a tabela Propriedades de configurações avançadas, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor.

    Clique no ícone adicionar ícone adicionar para adicionar uma linha à tabela abaixo e inserir um par chave-valor para cada propriedade.

    Para salvar a linha, clique no ícone de envio ícone de envio na coluna mais à direita.

    Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de edição ícone de edição ou excluir ícone excluir ícone.

    Para excluir todas as linhas, clique em Limpar tudo.

    Importante

    Os campos na tabela Configurações avançadas exibem o ícone de variável Ícone de variável somente no modo de edição. Para que os valores variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

  • Teste: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos Passos

Após a criação de uma conexão do conector do Azure Cosmos DB, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

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

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

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

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

  • Executar: Executa um procedimento no Azure Cosmos DB e deve ser usado como um alvo em uma operação.