Atualizando e desinstalando o Qlik Data Gateway - Acesso direto

Recursos novos e aprimorados

Esta versão introduz funcionalidades novas e aprimoradas, bem como várias correções de bugs.

• Solução de problemas aprimorada por meio da propagação da configuração do gateway

  As configurações do gateway agora são propagadas para o Qlik Cloud para facilitar a solução de problemas pelo Suporte Qlik.

• Afinidade de sessão Gloo para reconexões de recarga

  As reconexões de recarga agora usam a afinidade de sessão Gloo, o que reduz a carga nos serviços e melhora as taxas de sucesso da recarga.

Problemas resolvidos

• Mapeamento de tipos de dados com conexões baseadas em DSN

  O mapeamento de tipos de dados agora funciona corretamente com conexões baseadas em DSN.

• Conector de arquivos com máscara de lista de arquivos

  Corrigido um problema em que o conector de arquivos retornava um erro ao usar uma máscara de lista de arquivos para arquivos que não existem.

• Problema de instalação e atualização do redistribuível C++

  Problemas de instalação e atualização relacionados ao pacote do redistribuível C++ foram resolvidos.

• Atraso na inicialização do conector de arquivos

  Erros intermitentes DirectAccess-5000 e DirectAccess-1510 atenuados, causados por atrasos na inicialização do conector de arquivos quando o isolamento de processo está ativado.

• Atualizações de segurança

  libcurl.dll atualizado para a versão 8.19.0 nos drivers ODBC (Apache Hive, Cloudera Impala, Apache Phoenix e Snowflake). OpenSSL atualizado para a versão 3.0.20 em todos os drivers ODBC, exceto Presto, Spark, Microsoft SQL Server, MySQL e Google BigQuery para resolver vulnerabilidades conhecidas.

• Suporte a arquivos RTF do conector de arquivos

  Corrigido um erro de digitação em FileExtensionValidator que impedia listar e carregar arquivos RTF.

Recursos novos e aprimorados

Esta versão introduz funcionalidades novas e aprimoradas, bem como várias correções de bugs.

• Suporte de autenticação estendido

  Os seguintes conectores agora suportam autenticação Single Sign-On (Kerberos):

  • Apache Hive
  • Cloudera Impala
  • Teradata

  • Microsoft SQL Server

  Além disso, o conector Teradata agora suporta autenticação LDAP.

• Manuseio aprimorado de recarregamentos do conector de Arquivo

  Às vezes, o mecanismo do Analytics armazenava em cache conexões de sessões anteriores e enviava uma solicitação a um pod cujo desligamento havia sido solicitado. Isso faria com que os recarregamentos falhassem com o seguinte erro:

  Connector error: data loading error (DirectAccess-4008)

  A partir desta versão, as solicitações de recarga para um pod que não está mais ativo serão rejeitadas e roteadas para um pod disponível.

• Registro de medição de recarga aprimorado

  O registro de medições de recarga foi aprimorado. Isso permitirá que clientes e Suporte Qlik obtenham mais informações sobre o desempenho da recarga. Como parte das melhorias, o nível de registro foi alterado para INFO e a mensagem de log foi adaptada para uso com a ferramenta de monitoramento do Direct Access gateway. Além disso, as seguintes informações serão agora mostradas no log:

  • Porcentagem do tempo de recarga gasto na transferência de soquete da Web.
  • Uma estimativa aproximada da taxa de transferência entre a fonte de dados e o Direct Access gateway.
  • Uma estimativa aproximada da taxa de transferência entre o Direct Access gateway e o Qlik Cloud.

• Capacidade de definir quantas linhas buscar por lote ao usar o conector ODBC (via Direct Access gateway)

  Uma nova opção Número de linhas a buscar por lote foi adicionada ao conector ODBC (via Direct Access gateway). Embora o valor padrão seja ideal para a maioria dos cenários, se você encontrar problemas significativos de desempenho, ajustar esse valor pode ajudar.

• Validação da contagem de linhas durante recarregamentos

  A contagem de linhas de todos os conectores do Direct Access gateway que não são de arquivo (o número de linhas que ele lê) será agora validada para garantir que corresponda ao número de linhas enviadas ao mecanismo. Se uma inconsistência for detectada, o recarregamento falhará com um erro apropriado, evitando assim o carregamento inconsistente de dados.

• Tratamento de erros aprimorado de comandos assíncronos

  A identificação e o tratamento de erros de resposta resultantes de comandos assíncronos com falha foram aprimorados. Esse aprimoramento facilitará uma melhor solução de problemas de falha de comando assíncrono.

Problemas resolvidos

• Pacote redistribuível C++ atualizado

  O pacote redistribuível C++ foi atualizado para a versão mais recente.

• Conector SAP BW

  O seguinte erro de análise às vezes ocorria:

  Invalid character: ':' for the timestamp data type.

• Segurança

  Para resolver vulnerabilidades conhecidas, os seguintes componentes do Direct Access gateway foram atualizados ou removidos:

  • O arquivo e_sqlite3.dll foi atualizado para a versão 3.50.4.

  • O package-lock.json foi removido do diretório dcaas_gs porque não é necessário.

• Conector ODBC (via Direct Access gateway) - problema de pré-visualização de dados

  Ao usar o conector ODBC (via Direct Access gateway), não seria possível visualizar dados com colunas que incluíam aspas duplas.

Recursos novos e aprimorados

Esta versão introduz funcionalidade a vários conectores Direct Access gateway que anteriormente estava disponível apenas com os conectores não-Direct Access gateway correspondentes.

• Novas listas suspensas no diálogo "Selecionar dados para carregar"

  A capacidade de selecionar um banco de dados, proprietário, função, catálogo e esquema foi adicionada ao diálogo Editor da carga de dados > Selecionar dados para carregar (<nome de exibição do conector>). Os seguintes conectores são afetados:

  • Athena Drill (via Direct Access gateway)

    • Foram adicionadas as listas suspensasBanco de Dados e Proprietário.

  • Databricks (via Direct Access gateway)

    • As listas suspensas Catálogo e Esquemaforam adicionadas.

  • Presto (via Direct Access gateway)

    • Foram adicionadas as listas suspensasBanco de Dados e Proprietário.

  • Snowflake (via Direct Access gateway)

    • As listas suspensas Função, Banco de dados e Esquema foram adicionadas.

• Remoção da opção Habilitar Leitor em Massa

  A opção Habilitar Leitor em Massa está habilitada por padrão e não aparece mais na interface do usuário. Só pode ser desativada usando uma propriedade interna.

• Versão mínima do TLS

  A versão 1.3 foi adicionada à lista suspensa TLS Mínimo nos seguintes conectores:

  • Apache Drill (via Direct Access gateway)

  • Google Big Query (via Direct Access gateway)

  • Microsoft SQL Server (via Direct Access gateway)

Problemas resolvidos

• Mensagem de erro pouco clara

  Em versões anteriores, ao tentar registrar o gateway em uma região Qlik Cloud sem suporte, ocorria o seguinte erro pouco claro: "SYS-E-ERRMSG, INVALID QCS HOST". A mensagem de erro agora declara explicitamente que o erro pode ser devido a uma região Qlik Cloud sem suporte.

• Segurança

  O Qlik Data Gateway - Acesso direto é fornecido com um componente SQLite vulnerável. Para resolver isso, System.Data.SQLite foi atualizado para a versão 2.0.2.

• Conector do ODBC (via Direct Access gateway)

  Adicionar um novo mapeamento de tipo de dados através da interface do usuário de configuração do Direct Access gateway resultaria na definição de um driver/identificador incorreto.

• Falhas de conexão do Oracle Wallet

  Durante recarregamentos simultâneos, a conexão do Oracle Wallet com o banco de dados Oracle Cloud às vezes falhava.

Recursos novos e aprimorados

Aprimoramentos do conector ODBC (via Direct Access gateway)

Definições de configuração recém-expostas

As seguintes configurações, que anteriormente só podiam ser definidas editando manualmente um arquivo de configuração, agora foram expostas no diálogo Configurações do gateway para <gateway-name>:

• Permitindo apenas DSNs específicos

• Permitindo apenas drivers específicos

• Mapeamento de tipo de dados personalizado

Suporte para delimitar nomes de tabela

Algumas fontes de dados exigem que os nomes de tabela com letras maiúsculas ou caracteres especiais sejam delimitados no script de carregamento. Caso contrário, ocorrerá um erro. A nova opção Delimitar nomes de tabela elimina a necessidade de adicionar manualmente delimitadores ao script de carregamento ao carregar ou pré-visualizar dados.

Para obter detalhes, consulte Criar uma conexão ODBC (via Direct Access gateway) (somente em inglês).

Expondo o parâmetro para obter mensagens de erro detalhadas ao usar fontes ODBC

Devido a questões de segurança, a mensagem de erro padrão retornada pelo driver ODBC contém informações mínimas. No entanto, em determinados cenários, você pode precisar de mais informações para solucionar um problema específico. Anteriormente, isso exigia adicionar a propriedade ShowErrorDetailMessage à seção Avançado no diálogo do conector e defini-la como True. Agora, você pode marcar a caixa de seleção Mostrar mensagem de erro detalhada no diálogo Configurações do gateway.

Para obter detalhes, consulte Mostrar mensagem de erro detalhada.

Suporte para alterar as configurações de isolamento de processo sem reiniciar o serviço de gateway

Em versões anteriores, quaisquer alterações nas configurações de isolamento de processo, como o aumento do número de processos durante um recarregamento, exigiam a reinicialização do serviço de gateway. Agora, as alterações nessas configurações serão aplicadas sem a necessidade de reiniciar o serviço de gateway.

Melhorias no registro

• Excesso de registro reduzido quando AGENT_LOG_LEVEL=DEBUG e AGENT_LOG_OPTIONS não estão definidos.

• Os logs do agente do conector para recarregamentos do conector de arquivo agora mostram o AppId real em vez de AppId=dummyDocId.

Suporte aprimorado para comandos assíncronos

O suporte a comandos assíncronos aumenta a eficiência, permitindo que o Direct Access gateway processe vários comandos (solicitações) simultaneamente, em vez de um de cada vez. No passado, quando o pod de comando de destino no Qlik Cloud não estava disponível para lidar com uma solicitação, o Direct Access gateway continuava enviando a solicitação para o mesmo pod em vez de falhar. Isso fazia com que o comando falhasse após 10 tentativas, com um erro genérico em vez de apontar para a causa real da falha.

Telemetria Qlik

Um cabeçalho UserAgent foi adicionado a todas as respostas de comando do agente do conector (via HTTP POST). Isso melhorará a marcação do uso do Direct access gateway na telemetria Qlik.

Formato do cabeçalho:

qlik-direct-access-gateway/version

Exemplo:

qlik-direct-access-gateway/1.7.10

Problemas resolvidos

Segurança

• Possível execução de código arbitrário em instaladores WIX devido ao sequestro da porta COM com HKCU\Software\Classes\WOW6432Node. A correção valida as chaves de registro antes de executar o instalador.

• A versão do zlib instalada com o Qlik Data Gateway possui vulnerabilidades conhecidas. O problema foi resolvido ao atualizar para uma versão sem vulnerabilidades conhecidas.

Falha no conector SAP BW

O conector SAP BW falharia se o parâmetro de entrada Infoprovider fosse comentado no script de seleção e usado como filtro de condição.

Recursos novos e aprimorados

Nova opção "Delimitar nomes de coluna" para o conector ODBC (via Direct Access gateway)

Algumas fontes de dados exigem que os nomes de coluna com letras maiúsculas ou caracteres especiais sejam delimitados no script de carregamento. Caso contrário, ocorrerá um erro. A nova opção Delimitar nomes de coluna elimina a necessidade de adicionar manualmente delimitadores ao script de carregamento ao carregar ou pré-visualizar dados.

Para obter detalhes, consulte Criar uma conexão ODBC (via Direct Access gateway) (somente em inglês).

Suporte para definir uma cota para os dados de métricas armazenados na máquina do Direct Access gateway

Uma nova propriedade localDataRetentionDatabaseSizeInMb foi adicionada ao coletor de métricas, que permite definir uma cota para o tamanho total dos dados de métricas armazenados na máquina de gateway (em MB). Dados antigos serão excluídos para garantir que a cota não seja excedida.

O coletor de métricas pode ser configurado localmente em um arquivo JSON ou por meio da API pública.

Para obter mais informações, consulte Coletor de métricas.

Problemas de segurança resolvidos

• O tempo de execução Node.js foi atualizado para a versão 22.x devido a uma vulnerabilidade conhecida na versão 20.19.5.

• libcurl.dll foi atualizado para a versão 8.16.0 devido a vulnerabilidades conhecidas na versão 8.7.0.

Recursos novos e aprimorados

Suporte para o mecanismo OAuth de Credenciais padrão do aplicativo com o Google BigQuery

Esta versão introduz suporte para o mecanismo OAuth de Credenciais padrão do aplicativo ao usar o conector do Google BigQuery (via Direct Access gateway).

Para obter detalhes, consulte Criar uma conexão do Google BigQuery (somente em inglês).

Suporte para comandos de metadados com isolamento de processos

Duas novas opções foram adicionadas à propriedade de configuração Isolamento de processos: Tudo e Metadados. A opção Tudo permite habilitar o isolamento de processos para comandos de recarga e metadados, enquanto a opção Metadados permite habilitar o isolamento de processos apenas para comandos de metadados. Isso pode ser útil, por exemplo, para clientes com drivers ODBC que não suportam multi-threading, mas que desejam executar comandos de metadados simultaneamente (principalmente para fins de visualização).

As novas opções são suportadas através da interface do usuário de configuração ou através da API pública.

Veja também: Isolamento de processos

Suporte para as regiões do Brasil (br) e França (fr)

Agora você pode usar o Direct Access gateway nas regiões de locatário do Qlik Cloud do Brasil (br) e da França (fr).

Coletor de métricas

Em um ambiente típico de cliente, inúmeras recargas de dados passam pelo Direct Access gateway para o Qlik Cloud Analytics diariamente. A capacidade de registrar e monitorar o consumo e a utilização de recursos impactados por essas recargas ajudará os clientes a planejar suas recargas de acordo.

O novo coletor de métricas (que é executado em segundo plano na máquina do Direct Access gateway) oferece registro e monitoramento básicos da utilização de recursos pelo Direct Access gateway, conectores e o sistema operacional. O coletor de métricas pode ser configurado localmente em um arquivo JSON ou por meio da API pública.

Para obter mais informações, consulte Coletor de métricas.

Problemas resolvidos

Após uma desconexão do gateway, as recarregações falhavam intermitentemente com o seguinte erro:

Requested endpoint could not be provisioned due to failure to acquire a load slot: The load slot request could not be decrypted. The load slot request could not be decrypted (DirectAccess-1707)

Recursos novos e aprimorados

Suporte para as opções atualizadas de autenticação OAuth do Databricks

O conector do Databricks foi recentemente aprimorado com dois mecanismos de autenticação adicionais, que agora são compatíveis com o Direct Access gateway:

• Diretor de Serviço OAuth do Databricks

• Conta de Usuário OAuth do Databricks

Ambos utilizam o fluxo geral do OAuth 2.0, que é compatível com contas gerenciadas pelo Databricks ou pelo Microsoft Entra ID.

Para saber mais, consulte Criar uma conexão do Databricks (somente em inglês).

Substituindo a porta inicial padrão definida pelo isolamento de processo

Quando o isolamento de processo está ativado, agora você pode substituir a porta inicial padrão (49152) que o Direct Access gateway usa para comunicação entre processos com todos os processos de conector isolados. Isso pode ser útil quando a porta padrão está em uso por outro processo. Para substituir a porta, defina a propriedade DATA_PORT_RANGE_START para a porta desejada, seja editando o arquivo configuration.properties ou por meio da API Pública.

Problemas resolvidos

O Direct Access gateway 1.7.8 resolve os seguintes problemas:

• Conector SAP SQL: erro ao carregar uma tabela contendo um elemento de dados UTCL

  O seguinte erro ocorreria durante o carregamento quando uma tabela contivesse um elemento de dados UTCL:

  Status (StatusCode="InvalidArgument", Detail="Input string was not in a correct format.

• Falhas intermitentes de recarregamento ao usar a recuperação de blocos

  As recargas falhavam intermitentemente com o seguinte erro:

  Object reference not set to an instance of an object. (DirectAccess-1513))

• Conector SAP BW: problema de extração de dados

  A extração de dados do SAP BW InfoProvider/ADSO usando dois valores em uma cláusula WHERE retornaria zero linhas.

• Falhas de conexão gRPC resultando em erros Direct Access-1510

  Em casos raros, podem ocorrer falhas na conexão gRPC, resultando em erros Direct Access-1510. Para atenuar este problema, as seguintes melhorias foram implementadas:

  • Uma chamada gRPC foi adicionada para garantir que a porta esteja disponível para a conexão gRPC

  • O canal gRPC será recriado quando uma conexão for recusada por um conector

Recursos novos e aprimorados

Suporte para o conector SAP Report

A partir desta versão, os clientes agora podem acessar seu conector SAP Report por meio do Qlik Data Gateway - Acesso direto.

Usando o SAP Report Connector (somente em inglês)

Suporte para o Direct Access gateway com o Qlik Cloud Government - DoD

Esta versão adiciona suporte para o uso do Direct Access gateway com o Qlik Cloud Government - DoD.

Aliviando a latência causada pela resolução de DNS

A partir desta versão, a comunicação entre serviços será realizada usando o endereço de loopback IPv4 (127.0.0.1) em vez de localhost. Isso deve eliminar efetivamente qualquer latência resultante da resolução de DNS.

Configurando os parâmetros de inicialização do conector

Agora você pode aumentar o valor do tempo limite e o número de tentativas de inicialização do conector. Isso pode ser útil ao realizar um número considerável de recargas simultâneas. O aumento desses parâmetros dará ao Direct Access gateway mais tempo e tentativas adicionais de executar um conector antes de sair com falha e exigir uma reinicialização.

Configurando a inicialização do conector

Solicitando slots de carga de forma assíncrona

Esta versão apresenta a opção de solicitar slots de carga de forma assíncrona. A solicitação de slots de carga de forma assíncrona alivia o congestionamento temporário do canal de comando para o Direct Access gateway durante a criação do WebSocket de dados de recarga para o Qlik Cloud. Isso pode ser útil ao realizar um número considerável de recargas simultâneas.

Solicitando slots de carga de forma assíncrona

Nova localização para os logs de instalação

Os arquivos de log de instalação agora estarão localizados em <pasta de instalação do Direct Access gateway>\data\logs, que é consistente com a localização de outros arquivos de log do Direct Access gateway.

Nas versões anteriores, os arquivos de log de instalação estavam localizados em C:\Users\<user>\AppData\Local\Temp. Todos os logs que ainda estiverem nessa pasta serão copiados para a nova localização durante a atualização.

Problemas resolvidos

O Direct Access gateway 1.7.7 resolve os seguintes problemas:

• Suporte para diminuir o tamanho da coluna ao definir mapeamentos de tipos personalizados para o conector ODBC (via Direct Access gateway)

  Adicionado suporte para redução do tamanho da coluna reportado pelo driver ao definir mapeamentos de tipo personalizados para o conector ODBC (via Direct Access gateway). Nas versões anteriores, o tamanho da coluna só podia ser aumentado.

• Tempo limite do comando

  Comandos de longa duração que excediam o tempo limite padrão do pong de 45 segundos faziam com que o canal de comando fosse desconectado. Esse problema foi resolvido impedindo que o tempo limite seja acionado enquanto o Qlik Cloud Service Connection Broker estiver retransmitindo um comando para o Direct Access gateway Connector Agent.

• UI de configuração – botão Salvar desativado

  O botão Salvar seria desativado devido a um valor MAX_PROCESSES_COUNT inválido. O problema foi resolvido com o preenchimento automático do campo com um valor válido.

• UI de configuração – Inconsistência entre os valores padrão e os valores iniciais

  • O valor inicial do campo Número de processos de recarga simultâneos era diferente do valor padrão exibido na interface do usuário para os seguintes conectores: ODBC, SAP BW, SAP SQL, SAP ODP e REST.

  • O valor inicial do campo de modo Isolamento do processo para o conector de arquivo era diferente do valor padrão exibido na interface do usuário.

• O modo de autenticação NTLM do Microsoft SQL Server não está funcionando

  O modo de autenticação NTLM do Microsoft SQL Server parou de funcionar ao usar o Direct Access gateway 1.7.6.

• Falhas de recarga sob carga pesada

  Ao executar cargas pesadas, as recargas às vezes falhavam com o seguinte erro:

  Connector error: The gRPC connection to the connector failed. ... (DirectAccess-1510)

  Esse problema foi resolvido com a inclusão de um mecanismo de nova tentativa.

• Falhas intermitentes de recarga em determinados cenários

  Às vezes, as recargas falhavam com os seguintes erros:

  • DirectAccess-4002: esse problema foi resolvido com a redução do valor padrão da propriedade AGENT_DATA_PING_SKIP_THRESHOLD_SECONDS de 60 para 15 segundos.

  • DirectAccess-2208: este problema foi resolvido com a adição de um mecanismo de repetição.

Conector File (via Direct Access gateway): restringindo o acesso ao sistema de arquivos a espaços específicos

Ao usar o conector File (via Direct Access gateway), agora você pode restringir o acesso ao sistema de arquivos ou à unidade de rede a espaços específicos. O emparelhamento de cada caminho com espaços dentro do seu locatário do Qlik Cloud significa que somente membros do espaço com a função Pode consumir dados ou superior poderão acessar o caminho especificado. Quando nenhum espaço estiver configurado, os caminhos especificados serão acessíveis a todos os espaços.

A nova configuração pode ser feita por meio da API pública ou diretamente no arquivo de configuração no servidor do gateway.

API pública

Conector de arquivo (via Direct Access gateway) (somente em inglês)

Suporte para aplicação de alterações sem a necessidade de reiniciar o gateway

A partir desta versão, ao atualizar os caminhos/URLs permitidos para os conectores File (via Direct Access gateway) e REST (via Direct Access gateway), você não precisa mais reiniciar o serviço Direct Access gateway para aplicar as alterações. Isso também se aplica ao fazer alterações nas propriedades ODBC (via Direct Access gateway) a seguir:

• Drivers permitidos

• DSNs permitidos

• Mapeamentos de tipos personalizados

Conector Oracle (via Direct Access gateway): suporte ao método de conexão do Oracle TNS Names

Esta versão adiciona suporte para acessar o Oracle usando o TNS Names.

Criar uma conexão Oracle (somente em inglês)

Conector File (via Direct Access gateway): isolamento de processos ativado por padrão

Ao executar uma instalação limpa do Direct Access gateway, o isolamento de processos agora será ativado por padrão com o Número de processos de recarga simultâneos definido como 10.

Isolamento do processo

Permitindo conexões com o host local usando o conector REST (via Direct Access gateway)

Agora, você pode permitir que o conector REST (via Direct Access gateway) se conecte ao localhost. Isso facilita o uso de pontos de extremidade REST locais (para o servidor de gateway), como o uso do ponto de extremidade connector-agent/ status para determinar o número ativo de cargas em um agente.

Isso também pode ser configurado usando a API pública, ao adicionar URLs locais (http://localhost:5050/status, por exemplo) ao arquivo restconnector_allowed_urls.txt.

Permitindo conexões com o host local usando o conector REST (via Direct Access gateway)

API pública

Suporte ao uso da API pública para realizar solicitações de "carregamento de dados" de forma assíncrona

A execução da solicitação de carga de dados de forma assíncrona no agente reduz significativamente o tempo que o serviço em nuvem precisa esperar pelas respostas do agente.

Esse recurso, que foi introduzido no Direct Access gateway 1.7.5, agora está disponível por meio da API pública usando o parâmetro OPTIONAL_CAPABILITIES.

API pública

Aprimoramentos de isolamento de processos em cenários de carga pesada

Quando um gateway está sob carga pesada com recursos limitados, são feitos aprimoramentos para evitar os seguintes problemas:

• Conflitos na porta do conector quando o isolamento do processo está ativado

• Tentativas excessivamente frequentes de iniciar o processo do conector

Problemas resolvidos

O Direct Access gateway 1.7.6 resolve os seguintes problemas:

• Conectores Oracle (via Direct Access gateway) ou ODBC (via Direct Access gateway): chamadas de metadados redundantes

  Ao usar os conectores Oracle (via Direct Access gateway) ou ODBC (via Direct Access gateway), algumas das propriedades do conector faziam chamadas de metadados redundantes quando nenhum gateway era selecionado.

• Degradação do desempenho devido ao tempo excessivo de recuperação de métricas de gateway

  Para cada solicitação de recarga, as métricas do gateway são recuperadas. O tempo necessário para recuperar as métricas (~200 ms) afetaria a duração do recarregamento. O problema foi resolvido com a recuperação das métricas a cada 15 segundos, em vez de cada solicitação de carga.

• Conector do AWS Athena (via Direct Access gateway): falha de recarga ao tentar recarregar nomes de tabelas ou colunas com caracteres japoneses

  Ao usar o conector AWS Athena (via Direct Access gateway), tentar recarregar nomes de tabelas ou colunas com caracteres japoneses causaria o seguinte erro:

  Unable to show the preview column data. User does not have permission to access data, or column data type is not supported.

• Conector do Google BigQuery (via Direct Access gateway): falha ao adicionar dados usando o gerenciador de dados

  Ao usar o conector do Google BigQuery (via Direct Access gateway), ocorria um erro "Falha ao adicionar dados" ao tentar adicionar dados usando o Gerenciador de dados.

• Esclarecimento da senha ao instalar o Direct Access gateway em uma conta LocalSystem

  O campo Senha no instalador do Direct Access gateway levou alguns clientes a acreditar que sempre era necessária senha ao instalar o Direct Access gateway em uma conta de usuário LocalSystem. Para resolver esse problema, o texto de esclarecimento a seguir foi adicionado ao instalador:

  A password is only required if you are not using the default local system account.

Adição do contexto de registro às chamadas de visualização de metadados

Para ajudar na solução de problemas de falhas de recarga, os campos a seguir foram adicionados aos registros das chamadas de visualização de metadados: requestguid, sessionid e datasourceid.

Foi adicionado suporte para "Credenciais definidas pelo usuário" aos conectores MongoDB (via Direct Access gateway) e Google BigQuery (via Direct Access gateway).

Um campo de credenciais definidas pelo usuário foi adicionado aos conectores MongoDB (via Direct Access gateway) e Google BigQuery (via Direct Access gateway), alinhando-os com os conectores correspondentes que não são Direct Access gateway.

Quando a opção Credenciais definidas pelo usuário estiver selecionada, qualquer usuário que quiser acessar a conexão precisará inserir suas próprias credenciais antes de selecionar tabelas ou carregar dados. Essas credenciais pertencem a um usuário, e não a uma conexão. Credenciais definidas pelo usuário podem ser salvas e usadas em várias conexões do mesmo tipo de conector.

Suporte para AsyncCommand com solicitações de carga de dados

A execução da solicitação de carga de dados de forma assíncrona no agente reduz significativamente o tempo que o serviço em nuvem espera pelas respostas do agente.

Executando solicitações de carga de dados de forma assíncrona

Suporte para alterar a propriedade AGENT_LOG_OPTIONS sem a necessidade de reiniciar o serviço do Direct Access gateway

Também é possível modificar a propriedade AGENT_LOG_OPTIONS sem a necessidade de reiniciar o serviço Direct Access gateway. Essa propriedade só deve ser modificada se for solicitada pelo suporte Qlik.

Problemas resolvidos

O Direct Access gateway 1.7.5 resolve os seguintes problemas:

• Erros retornados para operações válidas

  O agente do conector às vezes retornava um erro "500" para chamadas válidas de carga e evento.

• API de configuração:

  • A propriedade "Contagem máx. de processos" para os conectores REST e FILE foi atualizada para abranger valores entre 2-100

  • Um valor padrão foi adicionado à propriedade AGENT_LOG_OPTIONS

  • Os valores de nível de registro do DCaaS foram atualizados

• Eventos de manutenção de atividade:

  • Os eventos de manutenção de atividade às vezes não eram criptografados

  • Uma resposta incorreta para liberar recursos da nuvem era enviada quando a sessão no agente não estava mais ativa

Suporte para substituir a conta de serviço padrão do Windows durante a configuração

Nas versões anteriores do Direct Access gateway, era possível alterar a conta de serviço do Windows somente após a instalação e apenas de forma interativa (em cada máquina do Direct Access gateway). O Direct Access gateway 1.7.4 introduz a capacidade de instalar o Direct Access gateway em uma conta de serviço não padrão do Windows. Essa opção está disponível ao usar o assistente de configuração e ao realizar uma instalação silenciosa.

Para obter mais informações, consulte: Estágio dois: Instalar o Direct Access gateway em um servidor atrás do firewall, protegendo suas fontes de dados

Suporte para o Windows Server 2025

As versões 1.7.0 e posteriores do Direct Access gateway foram certificadas para instalação no Windows Server 2025.

Problemas resolvidos

O Direct Access gateway 1.7.4 resolve os seguintes problemas:

• Fortalecimento da segurança

  Ao usar o conector de Arquivo (via Direct Access gateway), todas as operações de arquivo seriam realizadas na conta de serviço do Windows "NT AUTHORITY\SYSTEM". O problema foi resolvido com a inclusão da capacidade de substituir a conta de serviço padrão do Windows durante a configuração.

• Conector do Google BigQuery (via Direct Access gateway): erro ao processar dados de TIMESTAMP fora de um intervalo específico

  Ao processar os dados de TIMESTAMP fora do intervalo de 1400-9999 (anos), ocorreria o seguinte erro:

  The data contains unsupported data type or row content. Invalid row status.

• A conta de serviço personalizada do Windows não é mantida após o upgrade

  Após o upgrade, a conta de serviço do Direct Access gateway designada seria alterada de volta para a conta local padrão (LocalSystem).

• Erro ao recarregar

  Durante a recarga, devido a um problema relacionado à criptografia de eventos keepAlive (enviados do Qlik Cloud para o gateway), às vezes ocorria o seguinte erro:

  Internal error. (Connector error: Reload web socket was aborted due to a failure (DirectAccess-1103))

Melhorias na solução de problemas

• As métricas de máquina do Direct Access gateway (núcleos, espaço em disco, memória, CPU e assim por diante) agora serão propagadas para o registro remoto para ajudar na solução de problemas.
• O carimbo de data/hora da mensagem de log agora estará no formato UTC para todos os logs, exceto os logs para os conectores SAP.
• O nome do log do conector File (via Direct Access gateway) agora inclui o número da porta (em vez do ID do processo).
• As mensagens de registro do conector File (via Direct Access gateway) agora incluem uma coluna ID do Processo.

Aprimoramento do conector ODBC (via Direct Access gateway)

Ao usar o conector ODBC (via Direct Access gateway), os drivers ANSI ODBC (que não são compatíveis) agora serão excluídos da lista de drivers ODBC mostrados no conector.

Problemas resolvidos

O Direct Access gateway 1.7.3 resolve os seguintes problemas:

• Conector REST (via Direct Access gateway): falha de recarga

  O recarregamento de grandes estruturas de dados às vezes falhava com o seguinte erro:

  Received message exceeds the maximum configured message size.

• Conector REST (via Direct Access gateway): lista de permissão de URLs excessivamente restritivas

  As URLs sem uma barra final seriam bloqueadas incorretamente, enquanto as mesmas URLs com uma barra final seriam permitidas.

• Conector ODBC (via Direct Access gateway): consumo excessivo de memória

  Ao usar Multiple SELECT no script de carregamento, a memória VRAM no sistema de origem não seria liberada e continuaria crescendo a cada recarga.

• Conector MySQL (via Direct Access gateway): problema de tipo de dados

  Ao usar o conector MySQL (via Direct Access gateway) para carregar uma tabela com um tipo de dados "int(9) unsigned", os dados dessa coluna seriam retornados como -1.

• Conector SQL SAP (via Direct Access gateway): o MixedMode não está funcionando

  A propriedade de string de conexão MixedMode não funcionava como esperado.

• Fonte de dados do tipo SQL: problema com o script de carregamento

  Ao se conectar a uma fonte de dados do tipo SQL, o "TableName" no script de carregamento de dados seria colocado incorretamente no meio da definição da tabela, em vez de no início do script de carregamento.

• Conector Databricks (via Direct Access gateway): fortalecimento da segurança

  Os dados carregados pelo conector Databricks (via Direct Access gateway) agora sempre usarão SSL para a comunicação e os dados em trânsito. A opção anterior de ativar ou desativar o SSL foi removida.

• Fortalecimento da segurança

  A criptografia de ponta a ponta não seria mutuamente aplicada para cargas úteis de comando de registro que retornassem registros hospedados pelo cliente do centro de atividades de Administração do Qlik Cloud.

Definindo um threshold de retomada de recuperação de bloco

Agora você pode definir um threshold (em minutos) para a duração da recuperação dos blocos. Se o recarregamento não tiver sido retomado até o momento em que o threshold de duração da recuperação for atingido, ele falhará com uma mensagem apropriada.

Essa opção é útil para recargas que, de outra forma, poderiam exceder o limite de três horas, após uma longa recuperação. Por exemplo, digamos que você leve 90 minutos para recuperar os dados do banco de dados, mas, assim que a recarga começa, um dos blocos é corrompido. Nesse caso, todos os blocos serão armazenados no cache e enviados do cache. Nesse cenário, todo o processo de recarga (armazenamento no cache + recarga real) pode levar três horas para ser concluído.

Consulte também Definindo um limite de duração de recuperação de bloco.

Problemas resolvidos

O Direct Access gateway 1.7.2 resolve os seguintes problemas:

• Configuração ausente para o conector REST (via Direct Access gateway)

  O parâmetro REST_MAX_PROCESS_COUNT não estava no arquivo configuration.properties no Direct Access gateway 1.7.1.

• O reinício automático dos processos do Direct Access gateway não está funcionando como esperado

  Os processos do Direct Access gateway às vezes não eram reiniciados automaticamente quando travavam ou eram encerrados de outra forma.

• Pastas de cache de recuperação de blocos criadas na localização errada

  Quando a configuração OVERRIDE_CHUNKS_CACHE_DIR no arquivo configuration.properties estava vazia, as pastas de cache de recuperação de blocos eram criadas na pasta [pasta de instalação]\ConnectorAgent em vez de C:\ProgramData\Qlik\Gateway\tmp (a pasta padrão).

• Falha de recarga no modo Recuperação de bloco

  Ao trabalhar no modo Recuperação de bloco, as recargas ocasionalmente falhavam com um erro DirectAccess-4021. O problema era causado pelo fato de o EODAck chegar ao agente um pouco depois do tempo limite do EODAck. O problema foi resolvido com o aumento marginal do tempo limite do EODAck.

• Problema de nível de registro do conector de arquivo (via Direct Access gateway)

  O nível de registro DEBUG para o conector de arquivo (via Direct Access gateway) era ignorado.

• O conteúdo da pasta [pasta de instalação do Direct Access gateway]\data\logs\reloads nunca foi eliminado

  Arquivos JSON antigos nunca foram removidos da pasta [pasta de instalação do Direct Access gateway]\data\logs\reloads. O acúmulo de vários logs pode consumir uma quantidade significativa de espaço em disco ao longo do tempo. Além disso, fazer o backup dessa pasta (que pode conter milhares de arquivos de registro) também seria um desafio.

• Fortalecimento da segurança

  Essa melhoria acrescenta uma camada adicional de criptografia a eventos e mensagens enviadas entre o Qlik Cloud e o Direct Access gateway, que contêm dados confidenciais, como o IP do pod e o ID do gateway.

Novos recursos e aprimoramentos

• Conector REST

  O novo conector REST (via Direct Access gateway) fornece acesso seguro a endpoints privados da API REST por meio do Direct Access gateway, permitindo que você transmita dados diretamente para seu aplicativo Qlik Sense.

  Para obter mais informações, consulte Fontes de dados REST (somente em inglês).

  Nota informativa

  O conector REST (via Direct Access gateway) será implementado nas regiões do Qlik Cloud em quatro fases, com a fase 4 programada para ser concluída em 17 de fevereiro.

  • Fase 1: JP (Japão) e UK (Reino Unido)
  • Fase 2: DE (Alemanha), SG (Singapura), AP (Ásia-Pacífico) e IN (Índia)

  • Fase 3: US (Estados Unidos) e Qlik Cloud Government

  • Fase 4: EU (União Europeia)
    

• Substituindo o diretório de cache de blocos padrão

  Para cada operação de recarga, o Direct Access gateway pode armazenar em cache dados na memória e descarregá-los no disco (quando o tamanho alocado para o armazenamento em cache for excedido). Você pode substituir o diretório padrão do cache de blocos (C:\ProgramData\Qlik\Gateway\tmp) se não tiver espaço suficiente em disco na unidade do sistema.

  Para obter mais informações, consulte Substituindo o diretório de cache de blocos padrão.

• Substituindo o número padrão de tabelas recuperadas ao trabalhar com o conector ODBC (via Direct Access gateway)

  Por padrão, 10.000 tabelas são recuperadas para seleção, o que pode não ser suficiente ao trabalhar com bancos de dados muito grandes. Esta versão introduz a capacidade de substituir o padrão aumentando a propriedade ODBC_TABLES_LIMIT_FOR_GENERICODBC no arquivo configuration.properties do Direct Access gateway.

  Para obter mais informações, consulte Número máximo de tabelas a serem descarregadas.

• Suporte a vários catálogos com o Google BigQuery (via Direct Access gateway) Connector

  O Google BigQuery (via Direct Access gateway) Connector agora suporta o acesso a vários catálogos (o equivalente a projetos do Google BigQuery) em uma única conexão.

  Para obter mais informações, consulte Criar uma conexão Google BigQuery (somente em inglês).

• Suporte para o Unity Catalog com o Databricks (via Direct Access gateway) Connector

  O Databricks (via Direct Access gateway) Connector agora suporta o acesso a dados no Unity Catalog no Databricks.

  Para obter mais informações, consulte Criar uma conexão Databricks (somente em inglês).

• Reduzindo os erros de dados causados pelo driver ODBC ao usar o conector ODBC (via Direct Access gateway)

  Às vezes, devido a um problema com o tratamento dos tipos de dados da fonte pelo driver ODBC do fornecedor, ocorrerá um erro durante o recarregamento ou serão carregados dados incorretos em Qlik Cloud. Nesses casos, você pode substituir o tipo de dados Qlik Cloud ou sua especificação (escala ou precisão, por exemplo).

  Para obter mais informações, consulte Substituição o tipo de dados padrão do Qlik Cloud ao trabalhar com o conector ODBC (via Direct Access gateway).

• Realocação de eventos de log de eventos de início, saída e reinicialização do conector

  A partir do Direct Access gateway 1.7.1, os eventos de início, saída e reinício do conector serão gravados no arquivo de log do Direct Access gateway(DirectAccessAgent). Nas versões anteriores, eles eram gravados no arquivo de log Logs do agente do conector (connector-agent_logs_<date>).

Problemas resolvidos

O Direct Access gateway 1.7.1 resolve os seguintes problemas:

• Em certos cenários, o desempenho de recarga seria afetado ao habilitar a opção RELOAD_CACHE_MEMORY_MB (que armazena dados em cache para recarga em caso de problema).

• Ao habilitar a opção RELOAD_CACHE_MEMORY_MB, as recargas às vezes falhavam com o seguinte erro, indicando que o acesso foi negado ou que o arquivo não pôde ser encontrado:

  (Connector error: data loading error (DirectAccess-4008) (DirectAccess-4001))

• Em certos cenários, principalmente se a porta necessária para o conector não estivesse disponível, o conector continuaria travando, mesmo quando o isolamento do processo estivesse habilitado.

• Às vezes, o Direct Access gateway tentava se reconectar à fonte de dados, mesmo após a recarga ter sido concluída com sucesso.

• Às vezes, era encontrado um erro "Could not find file" quando o agente do conector tentava ler um bloco do disco depois que ele tinha sido carregado na memória.

• Ao trabalhar com o conector SAP BW, ocorre o seguinte erro:

  Error when parsing '0TCT_C03': The given key 'CHABASNM' was not present in the dictionary.

  O problema foi corrigido adicionando suporte para transportes mais antigos sem o campo de metadados CHABASNM.

• Quando o arquivo configuration.properties continha entradas duplicadas, não era possível iniciar o serviço Direct Access gateway.

• Ao tentar se conectar à fonte de dados do Azure SQL Database (via Direct_Access gateway) usando o método de autenticação Azure Active Directory, a operação Testar Conexão falharia com o seguinte erro:

  Communication link failure - ERROR [08S01] [Qlik][SqlServer] Connection broken unexpectedly

• Em alguns casos, quando o Direct Access gateway se desconectava do Qlik Cloud, poderia levar até 10 minutos para reconectar. Durante esse tempo, nenhuma recarga seria iniciada. Esse tempo foi reduzido para 45 segundos.

  Se você notar que o Direct Access gateway está demorando muito mais do que 45 segundos para reconectar, você pode forçá-lo a se reconectar, conforme descrito em Forçando o Direct Access gateway a se reconectar ao Qlik Cloud.

Novos recursos e aprimoramentos

• Conector de arquivo

  O novo conector Arquivo (via Direct Access gateway) fornece acesso seguro ao sistema de arquivos por meio do Direct Access gateway, permitindo que você faça o fluxo de dados diretamente para o seu aplicativo Qlik Sense.

  Para obter mais informações, consulte Arquivo (via Direct Access gateway) (somente em inglês).

• Desempenho aprimorado com suporte a comando assíncrono

  O suporte a comando assíncrono aumenta a eficiência ao permitir que o Direct Access gateway manipule vários comandos simultaneamente, em vez de um de cada vez.

   

Problemas resolvidos

O Direct Access gateway 1.7.0 resolve os seguintes problemas:

• Conector do Snowflake

  O carregamento de dados com caracteres especiais falharia com um "erro de compilação SQL".

• Instalação silenciosa

  A instalação silenciosa do Direct Access gateway abriria um prompt interativo para reparar o software de pré-requisito.

• Desempenho do conector Oracle (via Direct Access gateway)

  Carregar dados com o conector Oracle (via Direct Access gateway) seria significativamente mais lento do que usar o driver ODBC diretamente.

• Travamentos do conector ODBC (via Direct Access gateway)

  O conector ODBC (via Direct Access gateway) às vezes falhava devido a um bug no driver Simba do SQL Server.

• Falhas intermitentes de recarga

  As recargas de vários aplicativos falhavam intermitentemente com o seguinte erro (trecho):

  Connector Datagateway Space:SQLCLUSTER01 not found (Requested endpoint could not be provisioned due to failure to acquire a load slot: The response body of the connector load info request was empty.

Novos recursos e aprimoramentos

• O isolamento de processos agora está ativado por padrão

  Nas versões anteriores, o modo de isolamento do processo estava desativado por padrão. A partir do Direct Access gateway 1.6.9, ele será ativado por padrão, mas apenas com uma instalação limpa. Se você estiver atualizando, sua configuração de isolamento de processo existente será preservada (ativada ou desativada, dependendo do que era antes da atualização).

  Para saber mais sobre o isolamento de processos, consulte Isolamento de processos

• Arquivo configuration.properties removido

  Para evitar que os clientes modifiquem por engano o arquivo configuration.properties errado, o arquivo de modelo configuration.properties foi removido da pasta de instalação do Direct Access gateway. Agora, haverá apenas um arquivo configuration.properties, localizado em C:\ProgramData\Qlik\Gateway.

Problemas resolvidos

O Direct Access Gateway 1.6.9 resolve os seguintes problemas com o recurso de recuperação de blocos:

• Os blocos não são excluídos após o recarregamento

  Às vezes, os blocos processados não eram excluídos do disco após uma recarga.

• Os blocos não excluídos após uma falha

  Às vezes, os blocos processados não eram excluídos do disco após uma falha do Direct Access gateway.

• Alto consumo de memória

  Às vezes, ocorria um alto consumo de memória durante o recarregamento de blocos armazenados.

Para obter mais informações sobre o recurso de recuperação de blocos, consulte Memória para blocos de dados em cache

Novos recursos e aprimoramentos

• Mecanismo de recuperação de blocos de dados

  Esta versão introduz suporte para o envio de blocos de dados ausentes ou corrompidos. Para controlar o tamanho na memória dos blocos de dados recarregados, uma nova propriedade foi adicionada ao arquivo configuration.properties: RELOAD_CACHE_MEMORY_MB

  Para obter mais informações sobre o recurso de recuperação de blocos, consulte Memória para blocos de dados em cache

• O .NET 6.0.x não é mais necessário

  A partir dessa versão, a execução do Direct Access gateway não requer mais o .NET 6.0.x. Antes de instalar o Direct Access gateway, os novos clientes devem instalar o .NET 4.8 (necessário para a instalação), bem como o .NET 8.0 e o ASP.NET Core Tempo de execução (para trabalhar apenas com o Direct Access gateway).

  Para obter mais informações sobre os pré-requisitos do Direct Access gateway, consulte Pré-requisitos do sistema

• Operações em lote aprimoradas para processos dependentes

  A partir desta versão, os processos dependentes serão verificados em paralelo em vez de sequencialmente, evitando assim exceções devido à modificação da lista de processos durante o tempo de execução.

  Para saber mais sobre o isolamento de processos, consulte Isolamento de processos

• Solução de problemas aprimorada

  Mais contexto (por exemplo, como “ID do processo” e “tamanho do commit”) foi adicionado aos avisos de uso de recursos nos logs.

Problemas resolvidos

O Direct Access gateway 1.6.8 resolve os seguintes problemas:

• Mensagem de erro enganosa

  Seguindo uma reinicialização do gateway (manualmente ou devido a uma falha), as solicitações podem ser enviadas ao agente do conector (ConnectorAgent.exe) antes que ele tenha sido inicializado. Nesse caso, a Mensagem de erro seria enganosa. Agora, a mensagem de erro indicará que o gateway está Desconectado.

• Falhas de recarga devido à desconexão

  Direct Access gateway desconexões após o carregamento inicial às vezes causavam falha no recarregamento subsequente, com o seguinte erro:

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload

  Falhas ao recarregar devido ao desligamento do pod

  Às vezes, o mecanismo do Analytics armazenava em cache conexões de sessões anteriores e enviava uma solicitação a um pod cujo desligamento havia sido solicitado. Isso faria com que os recarregamentos falhassem com o seguinte erro:

  Connector error: data loading error (DirectAccess-4008)

• Recarregamento travado após reiniciar o serviço do Direct Access gateway

  Em determinados cenários, o agente conector não tentaria se reconectar após uma desconexão durante o recarregamento, resultando no seguinte erro:

  Reload web socket was aborted due to a failure (DirectAccess-1103)

• Conector do Amazon Redshift: A tabela SELECT preencheria colunas duplicadas

  Quando existiam tabelas em um esquema externo referenciado a partir do banco de dados criado no Datashare, as colunas duplicadas eram exibidas na visualização do DLE/Gerenciador de dados.

Novos recursos e aprimoramentos

• Suporte para alocação automática de portas ao trabalhar com isolamento de processos

  Antes, não era possível definir o Número máximo de processos de recarga simultâneos maior que 10 ao usar o número de porta padrão e as configurações de intervalo. A partir desta versão, as portas serão alocadas automaticamente, permitindo que o número de processos de recarga simultâneos seja maior que 10.

• Paginação de metadados aprimorada ao trabalhar com o conector SAP SQL (via Direct Access gateway)

  Com esse aprimoramento, quando 10.000 tabelas ou mais forem recuperadas, as tabelas serão recuperadas em lotes de 10.000 para evitar tempos limite.

Problemas resolvidos

O Direct Access gateway 1.6.7 resolve os seguintes problemas:

• Recarregamentos expirados não são liberados ao usar o isolamento de processos

  Ao usar o isolamento de processos, os processos do conector não eram liberados para recarregamentos expirados.

• As sessões do Amazon Redshift continuam em execução apesar do cancelamento do aplicativo

  As sessões do Amazon Redshift continuavam em execução até que a consulta fosse concluída, mesmo que o aplicativo QCS em execução fosse cancelado.

• Vulnerabilidades de segurança resolvidas

  • Conectores do Direct Access gateway vinculavam todos os serviços a 0.0.0.0, permitindo conexões de todos os endereços IP da máquina local, expondo potencialmente o servidor a todas as redes possíveis.
  • O Direct Access gateway tentava carregar MPR.dll a partir de um diretório inexistente, gerado dinamicamente no caminho dos arquivos temporários do usuário. Devido à ausência de MPR.dll na localização esperada, um invasor poderia colocar uma DLL mal-intencionada nesse caminho, que o instalador podia carregar e executar posteriormente.

• Recarregamento travado após reiniciar o serviço do Direct Access gateway

  Ao usar consultas sem seleção e um procedimento armazenado, o recarregamento ficava suspenso por várias horas após a reinicialização do serviço do Direct Access gateway.

• Problemas de visualização e recarregamento de dados

  Às vezes, eram encontrados problemas de visualização e recarregamento de dados ao usar o conector ODBC (via Direct Access gateway) para acessar o Microsoft Fabric.

• Erro ao adicionar uma cláusula ORDER BY

  A adição de uma cláusula ORDER BY causava um erro ao usar o conector ODBC (via Direct Access gateway) e o SQL Anywhere 17.

Novos recursos e aprimoramentos

O Direct Access gateway 1.6.6 apresenta os seguintes recursos e aprimoramentos:

• Suporte para acessar o ServiceNow por meio do Direct Access gateway

  Esta versão introduz suporte para o conector ServiceNow (por medio do Direct Access gateway), permitindo que os clientes acessem com segurança fontes de dados do ServiceNow protegidas por firewall por meio de uma conexão estritamente de saída, criptografada e mutuamente autenticada.

• Suporte para novos métodos de autenticação ao usar os seguintes conectores do Direct Access gateway:

  • Azure Synapse Analytics: Azure OAuth e Azure Active Directory
  • Banco de dados Azure SQL: Azure OAuth e Azure Active Directory
  • Snowflake: OAuth
  • Databricks: Azure OAuth
  • MongoDB: SCRAM-SHA-256 e LDAP

• Paginação de metadados aprimorada ao trabalhar com conectores ODBC

  Com esse aprimoramento, quando 10.000 tabelas ou mais forem recuperadas, as tabelas serão recuperadas em lotes de 10.000 para evitar tempos limite.

• Requisito do .NET 8.x

  A partir dessa versão, os clientes precisarão instalar o .NET 6 e o .NET 8.x para trabalhar com o Direct Access gateway. Durante a instalação ou o upgrade, o assistente de instalação os instalará automaticamente se ainda não estiverem instalados.

• Melhor capacidade de suporte

  Para ajudar na solução de problemas, foi adicionado um registro adicional que mede a duração das solicitações do Direct Access gateway.

Problemas resolvidos

O Direct Access gateway 1.6.6 resolve os seguintes problemas:

• Se a conexão entre o Direct Access gateway e o Qlik Cloud ficasse inativa por 30 segundos ou mais, a operação de recarregamento às vezes falharia com o seguinte erro: Nome de objeto inválido '#<TempTableName>' (indicando que as tabelas temporárias do Direct Access gateway não estão disponíveis).

  Para remediar isso, foi adicionada uma nova configuração de Tempo limite da solicitação de carga. O novo parâmetro configura a duração da sessão de recarga para conectores ODBC e tem um valor padrão de 20 segundos.

• O cancelamento de uma recarga às vezes causava um loop de criação e encerramento do processo ODBC.
• A conexão entre o Direct Access gateway e o Qlik Cloud Services às vezes terminava abruptamente, sem causa aparente.

• O intervalo de novas tentativas de conexão do Direct Access gateway aumentaria continuamente, mas nunca seria redefinido. Reiniciar o serviço do Direct Access gateway seria a única maneira de redefinir o intervalo de novas tentativas.

• Ao usar sintaxe incorreta para chamar um procedimento armazenado do Oracle, a operação de recarga seria interrompida por várias horas em vez de terminar imediatamente com um erro informativo.

Novos recursos e aprimoramentos:

O Direct Access gateway 1.6.5 apresenta os seguintes recursos e aprimoramentos:

• Suporte para o conector SAP ODP

  Esta versão introduz a capacidade de acessar uma origem SAP ODP por meio do Direct Access gateway. Para facilitar isso, um novo campo Gateway de dados foi adicionado ao conector SAP ODP. O novo campo permite que os clientes escolham qual gateway usar para acessar sua origem SAP ODP.

  Veja também: Conector SAP ODP (somente em inglês)

• Recursos estendidos de login

  Esta versão apresenta um novo registrador que o Suporte Qlik pode usar para solucionar problemas com componentes específicos do gateway.

• Região recentemente compatível

  O Japão agora é compatível como região de locatário do Qlik Cloud.

• Melhoria de desempenho

  Alocações de memória aprimoradas para sessões criptografadas.

Problemas resolvidos

O Direct Access gateway 1.6.5 resolve os seguintes problemas:

• Vulnerabilidade de segurança

  Os segredos seriam gravados no log DCAAS ao trabalhar com o conector ODBC.

• Desempenho de isolamento de processos

  Os processos levariam muito tempo para iniciar sob carga pesada.

• Caminho de instalação incorreto

  A instalação do Direct Access gateway sempre definiria o Qlik como pasta raiz, mesmo se o usuário escolhesse uma pasta diferente no assistente de configuração.

Novos recursos e aprimoramentos

• Suporte para visualização e download de arquivos de log do centro de atividades de Administração

  Esta versão introduz a capacidade de visualizar arquivos de log do Direct Access gateway no centro de atividades de Administração e compartilhá-los com o Suporte da Qlik, se necessário. Em circunstâncias normais, não há motivo para visualizar os arquivos de log, mas se ocorrerem falhas repetidas ou outros problemas, os arquivos de log geralmente ajudarão a identificar a causa.

  Consulte também: Visualizando e fazendo download de arquivos de log

• Suporte para instalação silenciosa do Direct Access gateway

  Os clientes agora podem instalar silenciosamente o Direct Access gateway, o que é útil se você precisar instalar o Direct Access gateway em diversas máquinas em toda a organização.

  Consulte também: Instalando silenciosamente o Direct Access gateway

• Continuidade de sessão aprimorada

  Quando uma sessão de recarga expirava, às vezes ocorria um erro DirectAccess-1012. Agora, o Direct Access gateway tentará manter a sessão de recarga ativa executando ping do Qlik Cloud com mais frequência.

Problemas resolvidos

O Direct Access gateway 1.6.4 resolve os seguintes problemas:

• Nome de parâmetro incorreto no arquivo configuration.properties

  Ao executar uma nova instalação do Direct Access gateway, o nome do parâmetro EXTEND_FIRST_REQUEST_TIMEOUT no arquivo C:\ProgramData\Qlik\Gateway\configuration.properties era seria chamado incorretamente de FIRST_REQUEST_TIME_EXTENSION.

• Recarregar disponibilidade do pod

  Quando várias recargas compartilhavam o mesmo ID de recarga, o número de pods de recarga no QCS atingiria o máximo.

O Direct Access gateway 1.6.3 inclui as seguintes melhorias e correções de bugs:

• Prevenção contra perda de dados

  Nas versões anteriores, para evitar possível perda de dados, o Direct Access gateway não se reconectava automaticamente à fonte de dados durante uma recarga. A partir desta versão, o Direct Access gateway agora se reconectará automaticamente à fonte de dados conforme necessário. Para evitar perda de dados, o resumo de recarga concluído será verificado antes da reconexão. Se for detectada perda de dados, a recarga falhará.

• Tempo limite para sessões de recarga

  Em cenários raros, a sessão de recarga permaneceria ativa indefinidamente. Para evitar tais ocorrências, esta versão introduz um tempo limite de três horas para sessões de recarga.

• Extensão do tempo limite para solicitações de carregamento

  Às vezes, as recargas falhavam com os seguintes erros:

  Connector error: The session does not exist (DirectAccess-1509)

  Connector error: The stream session expired for the load data request (DirectAccess-1012)

  Para atenuar esse problema, um parâmetro Load request timeout (para estender o tempo limite da solicitação de carga) foi adicionado às configurações do Direct Access gateway.

  Os clientes que encontram esses erros com frequência devem tentar definir o valor como 5 a 10 minutos.

  Para obter instruções detalhadas, consulte Tempo limite da solicitação de carga.

• Suporte para mensagens de erro de conexão detalhadas

  Adicionado suporte para visualização de mensagens de erro de conexão detalhadas ao usar conectores de gateway de acesso direto baseados em ODBC. Os clientes agora podem definir o parâmetro ShowErrorDetailMessage nas configurações Avançadas do conector como "true" para ver o erro completo retornado pelo driver ODBC. A mensagem de erro detalhada será mostrada no editor de carregamento de dados.

  Nota informativaA mensagem de erro é fornecida integralmente pela fonte de dados que você está usando. A Qlik não anexa nenhuma informação adicional à mensagem de erro nem a edita de forma alguma.

• Tratando várias recargas com o mesmo ID de recarga

  A partir desta versão, o ID de sessão do mecanismo será usado para distinguir entre múltiplas recargas com o mesmo ID de recarga. Isso evitará possíveis conflitos, resultando em falhas nas recargas com o seguinte erro:

  Connector error: data loading error (DirectAccess-4008

O Direct Access gateway 1.6.2 resolve um problema que às vezes fazia com que o Connector Agent travasse ao trabalhar no modo de isolamento de processos.

Novos recursos e melhorias

O Direct Access gateway 1.6.1 apresenta vários recursos e aprimoramentos importantes, melhorando a estabilidade e o desempenho gerais.

• Suporte para distribuir recarregamentos em vários processos de conectores

  O isolamento de processos de conector foi adicionado ao Direct Access gateway. Esse é um recurso opcional, o que significa que ele está desabilitado por padrão. O isolamento do processo permite que os administradores com acesso direto ao sistema operacional do servidor de gateway controlem quantos processos estão disponíveis para recarregamentos por tipo de conector. A distribuição de recarregamentos por vários processos de conector aumenta o nível de isolamento, reduzindo o número de recarregamentos executados simultaneamente em cada processo de conector. Isso, por sua vez, pode melhorar a estabilidade geral do Direct Access gateway nos casos em que ocorreram falhas no conector.

  Para saber mais sobre o isolamento de processos, consulte Isolamento de processos

• Foi adicionada a capacidade de desabilitar a fragmentação ao trabalhar com o conector SAP BW (via Direct Access gateway)

  Esta versão apresenta o parâmetro de aplicativo BEX_ONE_CHUNK para o conector SAP BW (via Direct Access gateway). Ao acessar o SAP BW diretamente do Qlik Cloud (ou seja, não por meio do Direct Access gateway), para otimizar o desempenho, o conjunto de resultados é dividido em partes no back-end do SAP e lido como threads separados. No entanto, ao acessar o SAP BW por meio do Direct Access gateway, dividir o conjunto de resultados em partes não traz nenhuma vantagem real. Pelo contrário, isso consome mais memória compartilhada no SAP, pois requer a criação de uma tabela temporária adicional durante a transferência de dados. É possível (embora geralmente não seja obrigatório) iniciar a fragmentação definindo BEX_ONE_CHUNK:false no arquivo appsettings.json, que está localizado na pasta de binários do conector SAP.

• Melhorias de diagnóstico para conectores SAP BW (via Direct Access gateway) e SAP SQL (via Direct Access gateway)

  Para logs do conector SAP BW (via Direct Access gateway) e SAP SQL (via Direct Access gateway), um sufixo _port foi adicionado antes da extensão de nome do arquivo de log, e uma mensagem ProcessID=### foi adicionada aos arquivos de log do conector para distinguir entre eventos de novas instâncias do conector que atendem na mesma porta.

• Melhorias de reconexão

  O mecanismo de reconexão durante o recarregamento foi aprimorado para que o Direct Access gateway não precise mais se conectar ao pod que iniciou o recarregamento (como acontecia anteriormente). Agora, em vez de tentar se conectar repetidamente ao pod que iniciou o recarregamento (o que geralmente resultava em falhas de recarregamento), ele se conectará ao primeiro pod disponível.

Problemas resolvidos

O Direct Access gateway 1.6.0 resolve os seguintes problemas:

• Log do conector ODBC via Direct Access gateway

  Quando recarregamentos eram realizados de fontes de dados diferentes, os processos de uma apareciam erroneamente no log da outra.

• Arquivo ausente na configuração

  O arquivo configuration.properties não era copiado durante a instalação do Direct Access gateway.

• Erro de recarregamento durante o escalonamento de recursos do Qlik Cloud

  O escalonamento de recursos do Qlik Cloud às vezes resultava em um erro do DirectAccess-1006. Um aprimoramento foi feito para melhorar o tratamento de determinados cenários de escalonamento de recursos do Qlik Cloud que ocorrem durante recarregamentos de aplicativos executados por meio do Direct Access gateway.

• Falha na conexão com o Snowflake

  A conexão com o Snowflake por meio do conector ODBC (via Direct Access gateway) costumava falhar.

• Falha de depuração de scripts de aplicativos no DLE

  A depuração de scripts de aplicativos no Editor de carregamento de dados (DLE) com a opção Limitar resultadas habilitada às vezes falhava com o seguinte erro:

  Connector error: Invalid load request (DirectAccess-1006).