Skip to main content

Guia versão por versão de atualização do Server: Versões compatíveis

Importante

Consulte a Lista de verificação para atualização do Server para ajudar a planejar e executar uma atualização bem-sucedida do Server, incluindo o fluxo de trabalho Verificações pré-atualização para identificar problemas que provocam falha nas atualizações.

Como este documento ajuda?

Este documento destaca as tarefas e alterações que você precisa conhecer ao atualizar versões do Alteryx Server. Os problemas são cumulativos, portanto, leia cada seção à medida que você atualiza as múltiplas versões. Este documento não substitui as Notas de versão (acesse os links em cada seção).

Agendamento de versões

  • As versões semestrais adicionam recursos, mas também podem alterar o gerenciamento do Server, exigindo que você ou seus usuários mudem de comportamento.

  • As versões/patches de manutenção trimestrais abordam problemas encontrados na versão inicial. Por exemplo, a primeira versão de manutenção para 2022.3 seria 2022.3.2.

Legenda

PONTO DE PARADA

Mudança significativa que requer atualização para esta versão antes de atualizar para uma versão posterior.

Upgrade do MongoDB

A versão do banco de dados do Mongo foi atualizada.

Uma atualização do Alteryx Server pode incluir apenas UMA atualização de versão do MongoDB entre a sua versão atual e a versão de atualização desejada.

CRÍTICO

Problema crítico: os administradores devem analisar ou estar cientes de quando mudam para esta versão ou passam por ela.

Critérios para entradas nesta lista

Esta lista resume as notas de cada versão para realçar quando:

  • os administradores ou usuários devem executar uma ação;

  • o item é importante na escolha de uma versão de atualização (ou seja, alteração de comportamento ou defeito);

  • uma mudança significativa foi feita na administração do Server.

Versão 2022.3 e anteriores

Para versões não compatíveis (2022.3 e anteriores), consulte o Guia versão por versão de atualização do Server: Versões não compatíveis.

2024.1

O que há de novo / Notas de versão

Versão

Ações necessárias ao atualizar para esta versão ou ao passar por ela.

2024.1

Recurso administrativo: capacidade de transferir a propriedade de ativos por meio da IU e da API

Os administradores podem transferir a propriedade de fluxos de trabalho e agendamentos entre usuários por meio da IU do Server ou usando os pontos de extremidade V3 da API do Server.

Impacto:

Nota

  • O histórico de trabalhos do fluxo de trabalho não fica visível para o novo proprietário.

  • O fluxo de trabalho será migrado para o estúdio do novo proprietário, o que afeta a visibilidade para outros usuários no estúdio de origem ou no de destino.

  • É necessário compartilhar outros elementos com o novo proprietário para executar o fluxo de trabalho com sucesso:

    • Conexão do DCM

    • Conexão compartilhada de banco de dados do Gallery

    • Credencial compartilhada do Gallery

2024.1

Novo recurso: nova opção de banco de dados adicionada (SQL DB)

É possível usar o banco de dados do SQL Server gerenciado pelo usuário em vez do MongoDB. No momento, as únicas versões com suporte oficial do SQL são MSSQL Server 2019 e 2022.

Impacto:

2024.1

CRÍTICO

Atualização do Python: atualizações do Python integrado da versão 3.8.16 para 3.10.13

Impacto:

A seguinte mensagem de erro aparece se uma versão incompatível de conector é usada no Designer: "A versão 3.8 não foi encontrada em nossa distribuição do Alteryx. Selecione outra versão. Erro interno – deadlock detectado."

Tarefa:

  • Todas as ferramentas da categoria Conectores devem ser substituídas por uma nova versão.

  • Os usuários devem testar o Python nos fluxos de trabalho novamente. O motor ainda usa o Python versão 3, portanto deve haver pouco impacto nos scripts.

2024.1

CRÍTICO

Alteração do campo de data/hora do MongoDB (carimbos de data/hora do serviço movidos para o formato UTC nos bancos de dados do Server)

Impacto: mudamos todos os campos de data/hora para a UTC para melhorar o processamento de alterações de fuso horário e horário de verão. Para obter mais informações, consulte as Notas de versão do Server 2024.1.

  • Todas as APIs do Server com um elemento de carimbo de data/hora são afetadas.

  • Se você atualizar de uma versão mais antiga para a 2024.1, os carimbos de data/hora dos ativos existentes serão convertidos no novo padrão UTC quando o AlteryxService for iniciado.

Tarefa: analise como os campos de data/hora são processados em aplicativos que acessam o MongoDB ou a API. Talvez seja preciso ajustá-los para esperar data/hora em UTC.

2024.1

Gerenciamento do Server de produção/DCM de desenvolvimento: o Server de produção pode redirecionar o DCM de desenvolvimento para conexões de produção

Impacto: "Conexões do DCM" e "Tratamento de conexões do DCM" adicionadas ao menu de administração. Para obter mais informações, visite as seguintes páginas de ajuda:

Tarefa: adiciona redirecionamentos do DCM ao Server de produção para permitir que fluxos de trabalho migrados do desenvolvimento acessem fontes de dados de produção sem alterações nos fluxos de trabalho.

2024.1

Administração do DCM: granularidade da permissão do usuário

Impacto: novas permissões do DCM adicionadas. Para obter mais informações, acesse a página de ajuda Funções e permissões de usuário.

2024.1

Administração do DCM: cofre externo genérico do DCM adicionado

Impacto: você pode configurar um cofre genérico capaz de recuperar segredos de qualquer cofre com uma interface programática usando autenticação básica.

2024.1

Alteração de administração: compartilhamento simultâneo no DCM

Impacto: você pode compartilhar a mesma conexão do DCM para colaboração e, separadamente, para execução. Antes era possível escolher apenas uma opção de compartilhamento. Para obter mais informações, acesse Gerenciador de Conexões de Dados: IU do Server.

2024.1

Fim de vida da ferramenta Insights

Impacto: os insights não estão mais disponíveis no Alteryx Server. Acesse nossa página de perguntas frequentes para obter mais informações.

2024.2

O que há de novo/Notas de versão

Versão

Ações necessárias ao atualizar para esta versão ou ao passar por ela.

2024.2

PONTO DE PARADA

CRÍTICO

Atualização do MongoDB integrado para a versão 7

Impacto: como parte da instalação do Server 2024.2, o MongoDB integrado é atualizado para a versão 7.0. A versão mínima do Server para atualização é 2023.2 (MongoDB versão 6.0).

Tarefa: certifique-se de que a versão do Server seja 2023.2 ou 2024.1 e siga os passos descritos nas Notas de versão do Server 2024.2.

2024.2

PONTO DE PARADA

CRÍTICO

A versão 2024.2 é a última versão a incluir o código do Crypto Migrator.

Este ponto de parada só é aplicável para atualização do MongoDB gerenciado pelo usuário da versão 2022.1 ou anteriores, o que exigirá que o banco de dados seja migrado por criptografia durante a atualização.

Tarefa: passe pelo processo de migração por criptografia explicado na seção "2022.3" do Guia versão por versão de atualização do Server: Versões não compatíveis e da ferramenta de preparo para migração.

2024.2

Migrar conexões de dados e fluxos de trabalho para o DCM

Agora você pode migrar conexões de dados do Server compartilhadas para conexões do DCM. Para fazer isso, consulte como migrar conexões de dados do Server para o DCM e Conexões de dados.

2024.2

Possibilidade de limitar usuários em um estúdio para um usuário

Os administradores podem desativar estúdios compartilhados limitando o número de usuários no estúdio a um usuário. Como administrador, agora você pode transferir facilmente a propriedade de ativos transferindo o fluxo de trabalho de um estúdio para outro.

Para limitar o número de membros em um estúdio a um usuário, vá para Administrador > Configurações > Configuração > Usuários. Em seguida, marque a caixa de seleção Limitar o estúdio a 1 usuário. Para obter mais informações, acesse Configurações do Alteryx Server.

2024.2

Restrição para tornar os fluxos de trabalho públicos: configuração global

Os administradores agora podem controlar como os fluxos de trabalho são publicados (de forma pública ou privada) marcando ou desmarcando a caixa de seleção Restringir fluxo de trabalho público (Global). Para fazer isso, acesse Administrador > Configurações > Segurança.

Para obter mais informações, acesse Configurações do Alteryx Server.

2024.2

Configurações de proxy do Designer expandidas

No Designer, Opções > Configurações de usuário > Editar configurações de usuário > Proxy > Habilitar novas configurações de proxy (prévia) foi adicionada para permitir um controle melhor das configurações de proxy e permitir scripts PAC.

Observação: nesta versão inicial, a configuração é aplicada a vários recursos (por exemplo, ferramenta Baixar), mas não a outros (por exemplo, conectores ou ODBC) no Designer. Consulte as Configurações de usuário para obter mais detalhes.

2024.2

Configuração do sistema "Cancelar trabalhos em execução por mais de (segundos)" agora se aplica a todos os trabalhos

Nas versões anteriores, essa configuração se aplicava apenas a trabalhos agendados. Para permitir que os trabalhos manuais sejam executados por mais tempo do que os trabalhos agendados, limpe essa configuração e utilize as duas novas opções da IU do Server explicadas abaixo.

Para obter mais informações, acesse Configurações do Alteryx Server.

Opção adicionada para cancelar execuções de trabalhos manuais de longa duração

Em IU do Server > Administrador > Configurações > Ativos, há uma nova opção para cancelar as execuções de trabalhos manuais (incluindo as execuções de trabalhos de API) que são executadas por mais tempo do que um tempo especificado. Esse recurso se aplica a todos os trabalhadores, a menos que o trabalhador tenha definido Configurações de sistema do Alteryx > Trabalhador > Geral > Cancelar trabalhos em execução por mais de (segundos). A configuração "Trabalhador" substitui a configuração "IU do Server".

Opção adicionada para cancelar execuções de trabalhos agendados de longa duração

Em IU do Server > Administrador > Configurações > Ativos, há uma nova opção para cancelar as execuções de trabalhos agendados que são executados por mais tempo do que um tempo especificado. Esse recurso se aplica a todos os trabalhadores, a menos que o trabalhador tenha definido Configurações de sistema do Alteryx > Trabalhador > Geral > Cancelar trabalhos em execução por mais de (segundos). A configuração "Trabalhador" substitui a configuração "IU do Server".

2024.2

Atualizações de API:

Filtragem de API adicionada a GET v3/workflows/{workflowID}/jobs

O ponto de extremidade GET v3/workflows/{workflowID}/jobs agora pode filtrar por status e resultCode, retornando uma lista de IDs de trabalho que correspondem a esses filtros. Para obter mais informações, consulte as Notas de versão do Server 2024.2 e os Pontos de extremidade de fluxos de trabalho.

  • Todas as APIs do Server com um elemento de carimbo de data/hora são afetadas.

  • Se você atualizar de uma versão mais antiga para a 2024.1, os carimbos de data/hora dos ativos existentes serão convertidos no novo padrão UTC quando o AlteryxService for iniciado.

Tarefa: analise como os campos de data/hora são processados em aplicativos que acessam o MongoDB ou a API. Talvez seja preciso ajustá-los para esperar data/hora em UTC.

Novos pontos de extremidade de API para assinaturas (estúdios)

Os administradores podem agora gerenciar assinaturas (estúdios) por meio dos pontos de extremidade V3 da API do Server. Esses pontos de extremidade ajudam a editar assinaturas em massa e permitem mover usuários individuais de volta para estúdios individuais.

Para obter mais informações sobre os pontos de extremidade, acesse Pontos de extremidade de assinatura.

Atualizações de API para pontos de extremidade de fluxos de trabalho

  • Agora o SourceAppId é retornado no corpo da resposta das seguintes chamadas de API:

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • Os criadores agora podem chamar o seguinte: GET v3/workflows/{workflowId}

  • Filtragem por status e resultCode adicionada aGET v3/workflows/{workflowID}/jobs:

Para obter mais informações, consulte as Notas de versão do Server 2024.2 e os Pontos de extremidade de fluxos de trabalho.

Novo ponto de extremidade de API para permitir a atualização de configurações de agendamentos individuais

Use o novo ponto de extremidade de API PATCH /v3/schedules/{scheduleId} para atualizar um agendamento sem precisar preencher vários campos obrigatórios para fazer uma única alteração. Para obter mais informações, acesse Pontos de extremidade de agendamentos.

Atualizações para pontos de extremidade de trabalhos

  • Novo ponto de extremidade de APIGET /v3/jobs/{jobId}/messages

    Esse ponto de extremidade é apenas para administradores. Use o jobId como um parâmetro de entrada para recuperar as mensagens correspondentes para esse trabalho.

  • Ponto de extremidade de API atualizado GET /v3/jobs/{jobId}

    O ponto de extremidade GET /v3/jobs/{jobId} foi atualizado para que os usuários possam ver os trabalhos que foram compartilhados com eles por meio de coleções.

Para obter mais informações, acesse Pontos de extremidade de trabalhos.

2025.1

O que há de novo/Notas de versão

Versão

Ações necessárias ao atualizar para esta versão ou ao passar por ela.

2025.1

Nova página de credenciais para usuários não administradores

Os usuários não administradores agora têm acesso a uma página "Credenciais" na IU do Server. Essa página permite visualizar, criar, editar e excluir credenciais personalizadas. Consulte Credenciais: interface de usuário do Server para obter mais detalhes.

2025.1

Adicionada a exibição de "Resultados dos fluxos de trabalho" para administradores

Agora os administradores têm a opção de visualizar os resultados dos fluxos de trabalhos e as mensagens de trabalho na exibição "Resultados dos fluxos de trabalho". Para obter mais detalhes, acesse Resultados dos fluxos de trabalho: interface de administrador.

2025.1

Adicionado o log de auditoria às "Configurações de sistema do Alteryx"

As atualizações para o RuntimeSettings.xml por meio do aplicativo "Configurações de sistema do Alteryx" agora estão registradas em C:/ProgramData/Alteryx.

2025.1

API do Server

Novo ponto de extremidade para cancelar um trabalho específico

Adicionado o ponto de extremidade DELETE /v3/jobs/{jobId} para cancelar qualquer trabalho em execução ou em fila (manual ou agendado).

Para obter mais detalhes, acesse Pontos de extremidade de trabalhos.

Novos pontos de extremidade para credenciais compartilhadas do Server

Adicionados os seguintes pontos de extremidade para credenciais do Server (que não são do DCM):

  • Criar credenciais do Server: POST /v3/credentials

  • Atualizar senha para credenciais existentes do Server: PUT /v3/credentials/{credentialId}

Esses pontos de extremidade estão disponíveis apenas para administradores e exigem que o TLS esteja habilitado. Para obter mais informações, consulte a página de ajuda Pontos de extremidade de credenciais.

Adicionada a expressão cron para pontos de extremidade de agendamento

Adicionada uma flexibilidade de agendamento dinâmica ao usar entradas cron. Agora você pode usar a expressão cron nestas APIs:

  • POST /v3/schedules

  • PUT /v3/schedules/{scheduleId}

  • PATCH /v3/schedules/{scheduleId}

  • GET /v3/schedules/{scheduleId}

Para obter mais detalhes, visite a página de ajuda Pontos de extremidade de agendamento.

2025.1

Os administradores podem convidar usuários para adicionar credenciais

Esse recurso permite que os administradores convidem um usuário para adicionar uma credencial compartilhada que o administrador pode então gerenciar e compartilhar. Consulte Convidar para criar ou editar uma credencial para obter mais detalhes.

2025.1

Adicionado o suporte para criptografia de asserção SAML

Agora oferecemos suporte à criptografia de asserção SAML, permitindo criptografar e assinar asserções. Esse recurso está disponível em ambientes FIPS e não FIPS.

Para obter detalhes sobre a configuração, consulte a página de ajuda Configurar autenticação do Alteryx Server.

2025.2

O que há de novo/Notas de versão

Versão

Ações necessárias ao atualizar para esta versão ou ao passar por ela.

2025.2

PONTO DE PARADA

CRÍTICO

Atualização do MongoDB integrado para a versão 8

Impacto: como parte da instalação do Server 2025.2, o MongoDB integrado será atualizado para a versão 8.0.

Tarefa: revise o Mapeamento da versão do esquema para garantir que o caminho de atualização seja movido para a mesma versão do MongoDB ou apenas uma versão superior. Não é possível atualizar o Server diretamente em mais de uma versão do MongoDB por vez. Para obter mais informações, consulte as Notas de versão do Server 2025.2.

2025.2

Server com o Alteryx One

O Alteryx Server agora inclui um novo recurso "Conexões – Alteryx One" na página "Controlador". Este recurso simplifica e protege o processo de vincular seu ambiente Alteryx Server à Plataforma Alteryx One. Ele habilita a transferência direta de metadados de linhagem do Server para catálogos de dados externos (como Atlan ou Collibra) por meio do Alteryx One.

Tarefas:

  • Configure a conexão na Plataforma Alteryx One. Para obter mais informações, consulte Conexão de linhagem de dados.

  • Configure a conexão nas Configurações de sistema do Alteryx. Para obter mais informações, consulte Controlador.

2025.2

Atualizações do Designer e do Server desvinculadas

Você pode atualizar o Designer independentemente do Server, para que os usuários possam acessar imediatamente os recursos mais recentes do Designer sem ter que esperar pela aprovação do Server ou por atualizações do ambiente. Os ativos criados em versões mais recentes do Designer agora podem ser publicados em ambientes mais antigos do Server.

Para obter detalhes importantes e atualizações contínuas, acesse Compatibilidade de versões do Server e do Designer.

Devido a essa alteração, um novo parâmetro foi adicionado aos pontos de extremidade de API de fluxos de trabalho. Para obter mais detalhes, consulte Novo parâmetro adicionado aos pontos de extremidade de fluxos de trabalho.

2025.2

Atualizado o processo de recuperação do host do Server

Escolha entre duas opções de recuperação:

  • Manual: conclua todas as etapas por conta própria.

  • Com script: use o novo script de recuperação para automatizar a preparação, a instalação e a restauração do RuntimeSettings e do MongoDB e, em seguida, conclua as etapas restantes manualmente.

Baixe o script no Portal de Licenças. Para obter mais informações sobre o novo processo de recuperação, acesse o Guia de recuperação do host do Server.

2025.2

Agendar aplicativos analíticos na IU do Server

Agora você pode agendar aplicativos analíticos diretamente da IU do Server. Para agendar um aplicativo analítico, basta selecioná-lo na IU do Server, clicar em Agendar, definir suas preferências, preencher todos os campos de entrada necessários e salvar o agendamento. Para obter mais informações, consulte Agendar um fluxo de trabalho.

2025.2

API do Server

Novo ponto de extremidade de API para monitoramento de trabalhos

Adicionado o ponto de extremidade GET /v3/jobs/ para monitorar todos os trabalhos no Server.

Para obter mais detalhes, acesse Pontos de extremidade de trabalhos.

Novo ponto de extremidade de API para compatibilidade com conectores de SDK

Adicionado o ponto de extremidade PUT /v3/dcm/connections/{id}/sharing/collaboration aos pontos de extremidade do DCM.

Este ponto de extremidade está disponível apenas para administradores. Para obter mais informações, consulte a página de ajuda Pontos de extremidade do DCM.

Novo parâmetro adicionado aos pontos de extremidade de fluxos de trabalho

Para oferecer suporte a atualizações desvinculadas do Designer e do Server, um novo parâmetro bypassWorkflowVersionCheck foi adicionado aos seguintes pontos de extremidade de fluxo de trabalho:

  • POST /v3/workflows

  • POST /v3/workflows/{workflowId}/versions

Isso permite ignorar a proteção que normalmente bloqueia uploads se a versão do Server for mais antiga que a versão do fluxo de trabalho. Para obter mais detalhes sobre o uso, acesse Pontos de extremidade de fluxos de trabalho.

2025.2

Recursos de compartilhamento de credenciais de usuário concluídos

Agora é possível usar credenciais duplicadas, mesmo que elas não sejam compartilhadas por meio da plataforma Alteryx Server. Essa atualização também resolve problemas visuais e de usabilidade para uma experiência de gerenciamento de credenciais mais suave.

Para obter mais informações sobre credenciais, acesse Credenciais: interface de usuário do Server e Credenciais: interface de administrador.