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.

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

2023.1

CRÍTICO

Versão mínima do Designer

Impacto: o Designer 2022.3 Patch 3 ou posterior é obrigatório para se conectar ao Server. Consulte as Notas de versão do Server 2023.1.

2023.1

Alteração administrativa: opção para permitir que os usuários executem fluxos de trabalho por meio de conexões de banco de dados compartilhadas do Server

Impacto: foi adicionada a opção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas para permitir que um fluxo de trabalho que usa uma conexão de banco de dados compartilhada do Server seja executado por qualquer pessoa com quem o fluxo de trabalho foi compartilhado por meio de uma coleção. Os outros usuários não requerem o compartilhamento explícito da conexão do Gallery.

Tarefa: IU do Server > Administrador > Configurações > Ativos > marque a caixa de seleção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas.

2023.1

Gerenciamento de senhas: foi adicionado suporte ao cofre de senhas AWS Secrets Manager

Impacto: AWS Secrets Manager

2023.1

Adições de API: para servidores de autenticação do Active Directory (AD), um grupo do AD pode ser adicionado a um grupo personalizado

Impacto: pontos de extremidade adicionados:

  • POST /v3/usergroups/{id}/activedirectorygroups

  • DELETE /v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}

2023.1

Alteração administrativa: suporte a grupos do Azure Active Directory com autenticação SAML

Impacto: agora os administradores podem sincronizar o acesso de usuários e grupos ao Server usando o Azure Active Directory (Azure AD) e o protocolo SCIM.

Tarefa: configurar o Azure Active Directory com SCIM no Alteryx Server

2023.1

Recurso de DCM: opção para desabilitar a sincronização do DCM entre o Designer e o Server

Impacto: esse recurso é útil em um Server de produção para garantir que os usuários não sincronizem nem usem inadvertidamente uma credencial de produção no Designer local.

Tarefa: Configurações de sistema do Alteryx > DCM > marque a caixa de seleção Bloquear a sincronização de conexões do DCM entre o Server e o Designer. Para obter mais informações, acesse DCM - Server.

2023.1

Alteração administrativa: os trabalhadores podem se conectar ao MongoDB gerenciado pelo usuário com credenciais exclusivas.

Impacto: permite a auditoria por trabalhador.

2023.1

Conexões de banco de dados: fim da vida útil para conexões de banco de dados de 32 bits

Impacto: perguntas frequentes sobre fim do suporte para conexões de banco de dados de 32 bits. As conexões de 32 bits deixarão de funcionar.

2023.1

Instalador do R

CRÍTICO

Atualização do R: atualizações da versão iintegrada do R de 4.1.3 para 4.2.3 no RInstaller_2023.1.1.200.exe ou posterior

Impacto: a versão do R será 4.1.3 ou 4.2.3 conforme mostrado abaixo:

  • R versão 4.1.3: instalação do Server 23.1, todas as versões

  • R versão 4.1.3: RInstaller_2023.1.1.123

  • R versão 4.2.3: RInstaller_2023.1.1.200 ou posterior

  • Os patches não afetam a versão do R.

Tarefa:

  • Use um RInstaller_2023 específico para forçar uma determinada versão do R.

  • Reinstale as bibliotecas R externas e direcione os usuários a retestarem o R nos fluxos de trabalho ao atualizar para a versão 4.2.3.

  • A versão do R do Designer deve ser a mesma usada no Server

Como usar a ferramenta R com pacotes compatíveis com o R versão 4.2.3

2023.1

Defeitos de aplicativo analítico (corrigido no 2023.1_Patch_2)

Impacto:

  • TPRI-2043: as ferramentas Menu Suspenso e Caixa de Listagem retornam NAME do par NAME:VALUE em vez de VALUE

  • TGAL-8126: a ferramenta Data retorna a data anterior à data selecionada

2023.1

CRÍTICO

Produto Connect: o Connect não é compatível com a versão inicial 2023.1

Impacto: as Notas de versão indicam o patch que é compatível com a versão 2022.3.

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

2023.2

MongoDB 6.0.5

Atualização do MongoDB: atualizações do MongoDB integrado da versão 4.2.15 para 6.0.5

Impacto: atualizações do MongoDB integrado para 6.0.5

Tarefa: se você usa o MongoDB integrado, a atualização para essa versão ou posterior atualizará o MongoDB para a versão 6.0.5. Observe os requisitos de espaço livre em disco de 1-2 vezes o tamanho atual do MongoDB.

2023.2

CRÍTICO

Caixa de diálogo de atualização do MongoDB: a caixa de diálogo para iniciar a atualização do MongoDB integrado é minimizada

Impacto: ao atualizar para 2023.2, depois de selecionar "Finalizar" na atualização, a caixa de diálogo de migração do MongoDB integrado é aberta, mas logo depois é minimizada, o que parece que a atualização foi concluída [TGAL-9041]. Para obter mais informações, consulte Error in Service logs when upgrading to Server version 23.2: Invalid feature compatibility version value, expected '5.0' or '5.3' or '6.0' (Erro nos logs do serviço ao atualizar para o Server versão 23.2: valor de versão de compatibilidade com recurso inválido, esperado "5.0", "5.3" ou "6.0").

Tarefa: torne essa caixa de diálogo visível e clique para iniciar a atualização do MongoDB. O serviço não será iniciado até que o MongoDB seja atualizado.

2023.2

Alteração do MongoDB: campo __ServiceDataBlob removido das coleções do AlteryxGallery

Impacto: o campo __ServiceDataBlob foi removido das coleções do AlteryxGallery. Agora eles aparecem como campos padrão do MongoDB.

Tarefa: se você tiver fluxos de trabalho administrativos que usavam a macro ServiceDataParser para desempacotar dados deste blob, eles precisarão ser refatorados.

2023.2

Alteração de administração do DCM: as conexões do DCM agora podem ser compartilhadas para colaboração

Impacto: ao compartilhar uma conexão do DCM na IU do Server, a opção "Compartilhar para colaboração" permite que a conexão do DCM seja utilizada por outros utilizadores no Designer. Para obter mais informações, acesse Gerenciador de Conexões de Dados: IU do Server > Compartilhar no Designer.

Tarefa: esta alteração facilita a colaboração de fluxos de trabalho compartilhados e a criação de novos fluxos de trabalho usando a conexão do DCM de um colega.

2023.2

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

Impacto: 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.

Tarefa: para obter mais informações, consulte Python integrado ao Alteryx.

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.