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 precisam ter acesso à conexão do DCM de destino utilizada — é necessário que eles sejam os proprietários da conexão ou que a tenham compartilhada para execução ou colaboraçã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.

  • Se a conexão de destino for compartilhada tanto para colaboração quanto para execução (compartilhamento simultâneo), será necessária a compartilhada para execução, já que foi projetada para o compartilhamento simultâneo. Isso significa que o usuário executor precisa ter a conexão compartilhada para execução para poder executar o fluxo de trabalho, independentemente do status de compartilhamento para colaboração.

    Por exemplo, se a conexão for compartilhada para colaboração e execução, mas você tiver apenas a conexão compartilhada para colaboração, não será possível executar o fluxo de trabalho.

  • 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 .