Conexões parametrizadas
Use conexões parametrizadas para gerenciar a mesma conexão em vários ambientes (desenvolvimento, teste, produção) e para evitar a codificação direta de credenciais.
Utilização de conexões parametrizadas
Para gerenciar os valores das conexões em diferentes ambientes com conexões parametrizadas, marque a caixa de seleção “Ativar parâmetros” na guia “Visão geral da conexão”. Depois de ativar a conexão parametrizada, você pode importar o conjunto de parâmetros existente ou criar um novo conjunto de parâmetros. Quando essa opção está desativada, os valores são armazenados diretamente na configuração da conexão.
Comportamento do Tempo de Execução
A ativação de conexões parametrizadas não altera a forma como você executa tarefas. Não são necessárias etapas adicionais durante a execução, pois a plataforma resolve todos os valores dos parâmetros antes de invocar o conector. Como resultado, os serviços a jusante (por exemplo, watsonx.ai ) recebem valores de conexão totalmente resolvidos e não têm conhecimento dos conjuntos de parâmetros.
Importando propriedades de conexão
- Na guia " Visão geral da conexão", marque a caixa de seleção "Ativar parâmetros".
- Clique na guia “Selecionar conjunto de parâmetros ”.
- Na janela " Propriedades da conexão de importação ", selecione o conjunto de parâmetros na lista suspensa.
- Na guia " Parâmetros do candidato", selecione os parâmetros a serem importados e clique em "Adicionar".
Criando um novo conjunto de parâmetros
Se você não tiver conjuntos de parâmetros existentes para usar na sua conexão, crie um novo conjunto de parâmetros e importe as propriedades de conexão que deseja incluir nesse conjunto.
- Na guia " Visão geral da conexão", marque a caixa de seleção "Ativar parâmetros".
- Clique na guia “Selecionar conjunto de parâmetros ”.
- Na janela " Propriedades da conexão de importação ", clique no botão "Adicionar conjunto de parâmetros".
- Na janela “Definir conjuntos de parâmetros reutilizáveis”, insira o nome do conjunto de parâmetros e (opcionalmente) forneça uma descrição. Em seguida, clique em Criar.
- Na janela de configuração de parâmetros, selecione a guia “Importar propriedades de conexão ”.
- Selecione um tipo de conexão na lista suspensa.
- Selecione os parâmetros que deseja importar para o seu conjunto de parâmetros e verifique as seguintes colunas na tabela de importação:
- Nome - O nome do parâmetro.
- Tipo - O tipo do parâmetro, como string (uma linha, várias linhas, criptografada), inteiro ou booleano.
- Prompt - Um título descritivo para o parâmetro.
- Valor padrão - Um valor opcional que você pode fornecer durante a importação. Ele serve como alternativa caso nenhum valor específico do ambiente seja definido em tempo de execução. Se você deixar este campo em branco, o parâmetro não terá um valor padrão e deverá ser definido em um conjunto de valores.
- Texto de ajuda - Uma breve descrição do parâmetro.
- Clique em Importar.
- (Opcional) Clique no ícone Editar para alterar o tipo do parâmetro, adicionar uma descrição ou atribuir um valor padrão. Você também pode excluir um parâmetro do conjunto de parâmetros.
Ao criar um conjunto de parâmetros, você pode adicionar variáveis de ambiente que deseja usar como parâmetros no seu fluxo ou criar novos parâmetros.
Conjuntos de valor agregado
É possível definir um conjunto de valores, que é uma coleção nomeada de valores para os parâmetros de um conjunto de parâmetros. Cada conjunto de valores corresponde a um ambiente específico, como desenvolvimento, teste ou produção, e contém os valores adequados para esse ambiente. Durante a execução, a plataforma aplica o conjunto de valores que corresponde ao ambiente em que o pipeline de dados está sendo executado.
Por exemplo, um conjunto de parâmetros para uma conexão pode incluir propriedades como nome de usuário, senha e host. Você pode definir um conjunto de valores específico para cada ambiente (por exemplo, um com credenciais de desenvolvimento e outro com credenciais de produção) para que os valores corretos sejam aplicados automaticamente, dependendo de onde o pipeline for executado.
Para criar um conjunto de valores:
- Na janela de configuração de parâmetros, abra a guia “Conjuntos de valores ”.
- Clique em “Criar conjunto de valores ”.
- Na janela “Criar conjunto de valores ”, insira um nome para o seu conjunto de valores.
- Para cada parâmetro do conjunto de parâmetros, especifique o valor a ser usado neste ambiente.
- Clique em Salvar.
Gerenciamento e edição de conjuntos de parâmetros para conexões
Você pode visualizar e editar seus conjuntos de parâmetros na tabela “Ativos” do seu projeto, onde é possível importar propriedades de conexão adicionais (as propriedades que já estiverem parametrizadas não serão duplicadas), adicionar variáveis de ambiente e criar novos parâmetros para seus conjuntos.
Diretrizes
Quando um conjunto de parâmetros contém propriedades de vários tipos de conexão, a plataforma exibe um aviso que não bloqueia o sistema. Este aviso tem caráter meramente informativo, serve como orientação e não afeta a execução nem a configuração. Isso não impede que você continue, e não é necessário tomar nenhuma medida imediata. Isso indica que seu conjunto de parâmetros está alinhado com a prática de “ DataStage-style ”, em que um único conjunto de parâmetros suporta várias conexões. Você ainda pode usar conjuntos de parâmetros que combinam vários tipos de conexão.
Opcionalmente, se você planeja usar um conjunto de parâmetros para a vinculação de conexão 1:1, crie um conjunto de parâmetros que contenha propriedades apenas para um único tipo de conexão.