Skip to main content

Tratamento de conexões do DCM

Empresas grandes geralmente executam várias instâncias do Alteryx Server (desenvolvimento, teste, produção) e precisam gerenciar o acesso a cada ambiente, controlar quais fluxos de trabalho podem ser executados e, o mais importante, quais conexões são usadas. Isso é especialmente importante para ambientes de produção onde se espera o acesso limitado de usuários e o processamento de dados de produção acontece.

As regras de tratamento de conexão do ambiente do DCM permitem definir quais conexões presentes no Server devem ser usadas em vez de conexões de fluxo de trabalho ao executar fluxos de trabalho no Server.

Para cada ambiente, você pode definir uma lista de IDs de conexões que devem ser substituídas por uma conexão diferente quando encontradas no fluxo de trabalho durante a execução. Isso significa que para este ambiente, cada um dos IDs de conexão de origem (presente no fluxo de trabalho) será resolvido como a conexão de destino (definida pelo ID da conexão) no tempo de execução do motor.

O DCM lida com a substituição de conexões dinamicamente na execução, sem atualizar o fluxo de trabalho YXMD.

Permissões para acessar as regras de tratamento de conexão do ambiente do DCM

  • Todos os administradores do Server podem acessar e gerenciar as regras de tratamento de conexão do ambiente do DCM na interface de administrador do Alteryx Server.

  • Para obter mais informações sobre permissões, acesse Funções e permissões de usuário.

Execução de fluxos de trabalho

  • Todos os usuários que executam o fluxo de trabalho no Server devem ter acesso à conexão do DCM de destino — seja como proprietários da conexão ou por meio de permissões de compartilhamento apropriadas para execução ou colaboração. A conexão do DCM deve, pelo menos, ser compartilhada para execução.

    Isso se aplica tanto à execução manual quanto à execução agendada do fluxo de trabalho.

  • Se a conexão de destino for compartilhada para colaboração, a versão da conexão disponível para o usuário será usada ao executar o fluxo de trabalho. Ou seja, as credenciais do usuário são usadas.

  • Quando ambas as opções de compartilhamento — colaboração e execução — estão habilitadas, a conexão compartilhada para execução é usada para executar fluxos de trabalho no Server, enquanto a conexão compartilhada para colaboração é usada para criar ou para executar fluxos de trabalho no Designer.

  • Se a conexão for compartilhada para colaboração e para execução, mas você só tiver acesso à conexão compartilhada para colaboração, o fluxo de trabalho será executado com a conexão compartilhada para colaboração.

  • Se a conexão de destino usar um cofre externo, os cofres externos estarão disponíveis para todos quando uma conexão baseada em cofre for compartilhada para execução.

Criar uma regra de tratamento de conexão do ambiente do DCM

Para criar uma regra de tratamento de conexão do ambiente do DCM:

  1. Vá para Administrador > Tratamento de conexão do DCM.

  2. Clique em + Novo no canto superior direito ao lado do campo "Pesquisar".

  3. Na janela Criar regra:

    • Insira o ID da conexão de origem — ID da conexão presente no fluxo de trabalho. Não precisa estar presente no ambiente atual. Ele não pode ser usado em nenhuma outra regra como conexão de origem ou de destino.

    • Especifique o Nome da conexão de origem — um nome personalizado usado apenas para uma melhor navegação.

    • Selecione a Conexão de destino — uma conexão existente no ambiente atual que será usada durante a execução. A conexão de destino não pode ser usada como uma conexão de origem em qualquer outra regra no mesmo ambiente. No entanto, várias regras podem fazer referência à mesma conexão de destino (várias referências seriam, assim, executadas usando a mesma conexão).

  4. Selecione Criar.

Importar as regras de tratamento de conexão do ambiente do DCM

Para importar regras de tratamento de conexão do ambiente do DCM, você precisa de um arquivo JSON com conexões do DCM exportadas. Para obter mais informações sobre como exportar conexões do DCM, acesse Exportar conexões do DCM.

  1. Vá para Administrador > Tratamento de conexão do DCM.

  2. Clique em Importar no canto superior direito ao lado do campo "Pesquisar".

  3. Na janela Importar regras, selecione Carregar arquivo. Selecione o arquivo JSON a ser carregado. As mesmas validações para conexões de origem e de destino são aplicadas como se uma nova regra estivesse sendo criada.

  4. Clique em Importar.

Por padrão, o arquivo exportado contém apenas as conexões de origem, sem conexões de destino definidas. Essas podem ser especificadas editando a regra na IU após a importação. Regras sem conexão de destino definida são ignoradas na execução, e a referência do fluxo de trabalho original é, portanto, usada.

Opcionalmente, você pode editar o arquivo de origem manualmente. Isso pode ser feito personalizando a lista de conexões a serem importadas ou preenchendo as conexões de destino para o arquivo JSON antes da importação. As conexões de destino podem ser definidas adicionando um objeto targetConnection contendo apenas uma referência connectionId ao ID de uma conexão existente no ambiente, como visto no exemplo abaixo.

Exemplo

Arquivo exportado: consulte a página Conexões do DCM para ver um exemplo de um arquivo JSON exportado.

Arquivo importado: exemplo de um arquivo de importação com conexões de destino definidas:

{
  "apiVersion": 5,
  "connections": [
    {
      "sourceConnection": {
        "connectionId": "c.cid.123b5925-e1e5-4568-a2cc-83c74eee8a6e",
        "connectionTitle": "Snowflake TEST - read_access (john.doe@alteryx.com)"
      },
      "targetConnection": {
        "connectionId": "c.cid.b36bd9b6-23a1-43ba-a4a4-c68c488d7f8c"
      }
    },
    {
      "sourceConnection": {
        "connectionId": "c.cid.456936dd-d0fd-4498-bc74-e550ea6a22c6",
        "connectionTitle": "SQL Server DEV - mssql read (john.doe@alteryx.com)"
      },
      "targetConnection": {
        "connectionId": "c.cid.9893e798-1324-489a-a036-83ed4fc1ec55",
      }
    }
  ]
}

Editar uma regra de tratamento de conexão do ambiente do DCM

Para editar uma regra de tratamento de conexão do ambiente do DCM existente:

  1. Vá para Administrador > Tratamento de conexão do DCM.

  2. Selecione o menu de 3 pontos para a regra de conexão do DCM existente que você deseja editar.

  3. Clique em Editar. A janela Editar regra é aberta.

  4. Na janela Editar regra, atualize a regra de tratamento de conexão do DCM selecionada. As mesmas validações para conexões de origem e de destino são aplicadas como se uma nova regra estivesse sendo criada.

  5. Clique em Editar.

Excluir uma regra de tratamento de conexão do ambiente do DCM

Para excluir uma regra de tratamento de conexão do ambiente do DCM existente:

  1. Vá para Administrador > Tratamento de conexão do DCM.

  2. Selecione o menu de 3 pontos para uma regra de tratamento de conexão do ambiente do DCM existente que você deseja excluir.

  3. Clique em Excluir.