Conexão Couchbase
Introdução
Uma conexão Couchbase, criada usando o conector Couchbase, estabelece acesso ao Couchbase. Essas atividades, uma vez configuradas, interagem com o Couchbase através da conexão.
Criar ou editar uma conexão Couchbase
Uma nova conexão Couchbase é criada usando o conector Couchbase a partir de uma destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).
Uma conexão Couchbase existente pode ser editada a partir destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
- A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).
Configurar uma conexão Couchbase
Cada elemento da interface do usuário da tela de configuração da conexão Couchbase é 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 com 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 Couchbase e não deve conter barras (
/) ou dois pontos (:). Este nome também é usado para identificar o endpoint Couchbase, que se refere tanto a uma conexão específica quanto às suas atividades. -
Servidor: Insira o servidor.
-
Esquema de Autenticação: Selecione o esquema de autorização, um dos seguintes:
-
Básico
-
Usuário: Insira o usuário.
-
Senha: Insira a senha.
-
-
ArquivoDeCredenciais
- Arquivo de Credenciais: Insira o arquivo de credenciais.
-
CertificadoSSL
-
Certificado SSL do Cliente: Insira o certificado SSL do cliente.
-
Tipo de Certificado SSL do Cliente: Selecione o tipo de certificado SSL do cliente, um dos seguintes:
-
USUÁRIO
-
MÁQUINA
-
ARQUIVO_PFX
-
BLOB_PFX
-
ARQUIVO_JKS
-
BLOB_JKS
-
ARQUIVO_PEMKEY
-
BLOB_PEMKEY
-
ARQUIVO_CHAVE_PÚBLICA
-
BLOB_CHAVE_PÚBLICA
-
ARQUIVO_CHAVE_PÚBLICA_SSH
-
BLOB_CHAVE_PÚBLICA_SSH
-
ARQUIVO_P7B
-
ARQUIVO_PPK
-
ARQUIVO_XML
-
BLOB_XML
-
-
Senha do Certificado SSL do Cliente: Insira a senha do certificado SSL do cliente.
-
Sujeito do Certificado SSL do Cliente: Insira o sujeito do certificado SSL do cliente.
-
-
-
Serviço Couchbase: Selecione o serviço Couchbase, um dos seguintes:
-
N1QL
-
Análise
-
-
Modo de Conexão: Selecione o modo de conexão, um dos seguintes:
-
Direto
-
Nuvem
- Servidor DNS: Insira o servidor DNS.
-
-
Usar SSL: Quando selecionado, especifica o uso de SSL.
-
Usar Configurações de Proxy: Selecione para usar configurações de proxy de 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.
- 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\"};. -
Testar: 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 suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.
-
Salvar Alterações: Clique para salvar e fechar a configuração da conexão.
-
Descartar Alterações: Após fazer alterações em uma nova ou existente configuração, clique para fechar a configuração sem salvar. Uma mensagem pede para confirmar que você 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 solicita que você confirme que deseja excluir a conexão.
Próximos passos
Após a criação de uma conexão com o conector Couchbase, 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 Noções básicas sobre conectores.
Estes tipos de atividade estão disponíveis:
-
Consulta: Recupera registros de uma tabela no Couchbase e é destinado a ser usado como uma fonte em uma operação.
-
Criar: Insere um registro em uma tabela no Couchbase e é destinado a ser usado como um alvo em uma operação.
-
Atualizar: Atualiza um registro em uma tabela no Couchbase e é destinado a ser usado como um alvo em uma operação.
-
Excluir: Exclui um registro de uma tabela no Couchbase e é destinado a ser usado como um alvo em uma operação.
-
Executar: Executa um procedimento no Couchbase e é destinado a ser usado como um alvo em uma operação.