Ir para o conteúdo

Conexão do IBM Cloud Data Engine

Introdução

Uma conexão do IBM Cloud Data Engine, criada usando o conector do IBM Cloud Data Engine, estabelece acesso ao IBM Cloud Data Engine. Essas atividades, uma vez configuradas, interagem com o IBM Cloud Data Engine através da conexão.

Criar ou editar uma conexão do IBM Cloud Data Engine

Uma nova conexão do IBM Cloud Data Engine é criada usando o conector do IBM Cloud Data Engine a partir de uma destas localizações:

Uma conexão existente do IBM Cloud Data Engine pode ser editada a partir destas localizações:

Configurar uma conexão do IBM Cloud Data Engine

Cada elemento da interface do usuário da tela de configuração da conexão do IBM Cloud Data Engine é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do IBM Cloud Data Engine e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do IBM Cloud Data Engine, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Chave da API: Insira a chave da API.

  • CRN do Armazenamento de Objetos em Nuvem: Insira o CRN do armazenamento de objetos em nuvem.

  • CRN da Consulta SQL: Insira o CRN da consulta SQL.

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

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

    • Adicionar: Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
    • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Descartar: Descartar uma nova linha ou quaisquer edições feitas em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
    • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
    • Limpar Tudo: Exclui todas as linhas da tabela.

    Importante

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

    Os campos na tabela Propriedades de Configurações Avançadas não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando {"success": "true"}; torna-se {\"success\": \"true\"};.

  • 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 Desativar Atualização Automática do Conector política da organização.

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 que você confirme 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão com um conector do IBM Cloud Data Engine, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Conceitos básicos do conector.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera registros de uma tabela no IBM Cloud Data Engine e é destinado a ser usado como uma fonte em uma operação.

  • Executar: Executa um procedimento no IBM Cloud Data Engine e é destinado a ser usado como um alvo em uma operação.