Hologres:Qlik

Limitações

O Qlik não oferece suporte à visualização de tabelas externas do Hologres. No entanto, você pode usar o Data load editor para consultar tabelas externas com instruções SQL e realizar análises visuais.

Conecte o Qlik Sense Desktop ao Hologres

1. Instale o Qlik Sense Desktop

   Instale o Qlik Sense Desktop. Para mais informações, consulte a documentação oficial do Qlik.

2. Conecte-se ao Hologres

   1. Abra o Qlik Sense Desktop e clique em Create new app no canto superior direito.

   2. Na caixa de diálogo Create new app, insira um nome para o aplicativo e clique em Create.

   3. Na caixa de diálogo exibida, clique em Open app. Na página do aplicativo, clique em Add data from files and other sources.

   4. Na caixa de diálogo exibida, selecione PostgreSQL, crie uma nova conexão e configure os parâmetros.

      Parâmetro	Descrição
      Host name	O endpoint público da instância do Hologres. Para obter o endpoint, acesse a página de detalhes da instância no console do Hologres e encontre o endpoint na seção Network Information.
      Port	A porta da instância do Hologres. Para obter a porta, acesse a página de detalhes da instância no console do Hologres e encontre a porta na seção Network Information.
      Database	O nome do banco de dados no Hologres.
      User name	O seu AccessKey ID do Alibaba Cloud. Para mais informações, consulte Create an AccessKey pair.
      Password	O seu AccessKey Secret do Alibaba Cloud. Para mais informações, consulte Create an AccessKey pair.

   5. Clique em Test Connection. Se a mensagem Connection succeeded for exibida, clique em Create no canto inferior direito e salve a nova conexão.

   6. Configure a conexão de dados do PostgreSQL.

      • Selecione um Owner de destino (que corresponde a um schema no Hologres). Por exemplo, selecione public.

      • Na área Tables, selecione a tabela a ser analisada.

   7. Clique em Add data. O Qlik Sense importa os dados do Hologres. Em seguida, visualize os dados no Qlik Sense.

      Nota

      Nesse modo, o Qlik Sense carrega todos os dados em seu mecanismo na memória em vez de enviar consultas em tempo real ao banco de dados com base nas ações da página.

3. Configure o modo Direct Query

   Em ambientes de produção onde os bancos de dados podem conter petabytes de dados, recomendamos o uso do modo Direct Query no Qlik Sense em vez de importar os dados. Para mais informações sobre o modo Direct Query, consulte a documentação oficial do Qlik.

   1. Abra o seu aplicativo. Na barra de navegação superior, escolha Data manager > Data load editor.

   2. As informações de conexão do source de dados aparecem no lado direito da página. Clique no ícone no canto inferior direito para inserir a string de conexão no editor. A dica de ferramenta desse ícone é Insert connection string.

   3. No editor de scripts, insira Direct Query no início do script de consulta e ative o modo Direct Query. O script a seguir é um exemplo:

      SET ThousandSep=',';
      SET DecimalSep='.';
      SET MoneyThousandSep=',';
      SET MoneyDecimalSep='.';
      SET MoneyFormat='$#,##0.00;-$#,##0.00';
      SET TimeFormat='h:mm:ss TT';
      SET DateFormat='M/D/YYYY';
      SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
      SET FirstWeekDay=6;
      SET BrokenWeeks=1;
      SET ReferenceDay=0;
      SET FirstMonthOfYear=1;
      SET CollationLocale='en-US';
      SET CreateSearchIndexOnReload=1;
      SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
      SET LongMonthNames='January;February;March;April;May;June;July;August;September;October;November;December';
      SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
      SET LongDayNames='Monday;Tuesday;Wednesday;Thursday;Friday;Saturday;Sunday';
      SET NumericalAbbreviation='3:k;6:M;9:G;12:T;15:P;18:E;21:Z;24:Y;-3:m;-6:μ;-9:n;-12:p;-15:f;-18:a;-21:z;-24:y';
      LIB CONNECT TO 'PostgreSQL_hgpcxxx-xxxxxxxxxxxxx-xx-xxxxxxhou.hologres.aliyuncs.com';
      DIRECT QUERY
      dimension
      l_shipmode,
      l_shipdate,
      o_orderstatus
      measure
      l_tax,
      l_quantity
      FROM public.lineitem INNER JOIN public.orders
      ON public.lineitem.l_orderkey = public.orders.o_orderkey;

      SET ThousandSep=',';
      SET DecimalSep='.';
      SET MoneyThousandSep=',';
      SET MoneyDecimalSep='.';
      SET MoneyFormat='$#,##0.00;-$#,##0.00';
      SET TimeFormat='TTh:mm:ss';
      SET DateFormat='YYYY/M/D';
      SET TimestampFormat='YYYY/M/D TTh:mm:ss[.fff]';
      SET FirstWeekDay=6;
      SET BrokenWeeks=1;
      SET ReferenceDay=0;
      SET FirstMonthOfYear=1;
      SET CollationLocale='en-US';
      SET CreateSearchIndexOnReload=1;
      SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
      SET LongMonthNames='January;February;March;April;May;June;July;August;September;October;November;December';
      SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
      SET LongDayNames='Monday;Tuesday;Wednesday;Thursday;Friday;Saturday;Sunday';
      SET NumericalAbbreviation='3:k;6:M;9:G;12:T;15:P;18:E;21:Z;24:Y;-3:m;-6:μ;-9:n;-12:p;-15:f;-18:a;-21:z;-24:y';
      
      LIB CONNECT TO 'PostgreSQL_hgpostcn-cn-st21y8nlm007-cn-hangzhou.hologres.aliyuncs.com';
      
      -- Enter Direct Query to enable Direct Query mode
      DIRECT QUERY
      
      dimension
      l_shipmode,
      l_shipdate,
      o_orderstatus
      
      measure
      l_tax,
      l_quantity
      
      FROM public.lineitem INNER JOIN public.orders
      ON public.lineitem.l_orderkey = public.orders.o_orderkey;

   4. Clique em Load data no canto superior direito. O Qlik Sense então envia uma consulta em tempo real.

   5. Na barra de navegação superior, escolha Sheet > Edit sheet para começar a criar visualizações.

   6. Na página de edição da planilha, clique em Charts à esquerda e selecione um tipo de gráfico para criar uma visualização.

      Nota

      • Se você arrastar campos diretamente para a tela, o Qlik Sense não poderá gerar uma consulta no modo Direct Query. Recomendamos clicar em Charts para criar visualizações.

      • Para melhorar o tempo de resposta, adicione medidas antes das dimensões.

   Para mais informações sobre operações e análise de dados no Qlik Sense, consulte a documentação oficial do Qlik.

Conecte-se ao Hologres usando uma conexão ODBC personalizada

Para consultar tabelas externas no assistente de tabelas do Qlik Sense, conecte-se ao Hologres usando uma conexão ODBC personalizada.

1. Pré-requisitos

   • Instale o driver ODBC do PostgreSQL no servidor e no cliente do Qlik Sense. Baixe o driver ODBC no site oficial do PostgreSQL.

   • Como o Hologres é compatível com o ecossistema do PostgreSQL 11, instale a versão Vpsqlodbc_11_01_0000 ou superior.

2. Configure um DSN

   • Acesse Control Panel > Tools e abra a ferramenta ODBC Data Sources (64-bit).

   • Mude para a aba System DSN e clique em Add.

   • Na lista de drivers, selecione PostgreSQL Unicode(x64) e clique em Complete.

     Nota

     Um User DSN é específico do usuário, enquanto um System DSN está disponível para todos os usuários no sistema. Se você precisar acessar o Hologres por meio de ODBC em um servidor de BI web, será necessário usar um System DSN.

   • Na caixa de diálogo, insira as informações do servidor Hologres conforme descrito na tabela a seguir. Na caixa de diálogo de configuração do psqlODBC, defina Data Source como Hologres e defina SSL Mode como disable.

     Parâmetro	Descrição
     User name	O seu AccessKey ID do Alibaba Cloud. Acesse a página AccessKey Management para obter o seu AccessKey ID.
     Password	O seu AccessKey Secret do Alibaba Cloud. Acesse a página AccessKey Management para obter o seu AccessKey Secret.
     Server	Você pode encontrar o endpoint público da instância do Hologres na página de detalhes da instância no console do Hologres, na seção Network information.
     Port	Você pode encontrar a porta da instância do Hologres na página de detalhes da instância no console do Hologres, na seção Network Information.
     Database	O nome do banco de dados no Hologres.

   • Após inserir as informações, clique no botão Test. Se a mensagem Connection successful for exibida, a configuração estará correta.

   • Clique em Save e salve o DSN. Defina Data Source como Hologres e SSL Mode como disable.

3. Conecte-se ao Hologres

   Após configurar o DSN local e instalar o Qlik Sense, conecte o Qlik Sense ao Hologres.

   • Abra o aplicativo Qlik Sense Desktop. Clique em Add data from files and other sources.

   • Na janela exibida, clique em ODBC e crie uma nova conexão. Na página Connect to a new data source, selecione o conector ODBC e clique em Next.

   • Na lista, selecione o DSN que você criou e insira um nome para a conexão.

   • Clique em Create e salve a conexão. Agora você pode selecionar um Owner (um schema no Hologres), como public. Esse método de conexão permite que o Qlik Sense leia o schema das tabelas externas. Após uma conexão bem-sucedida, selecione o banco de dados de destino, como tpch_100, na lista suspensa Database. Em seguida, selecione o schema correspondente, como public, na lista suspensa Owner. As tabelas disponíveis estão listadas na área Tables.

   • Na lista Tables, selecione as tabelas a serem analisadas, como orders, e visualize uma prévia de seus campos e dados no painel à direita. Confirme as informações, clique em Next e depois em Add data. O Qlik Sense importa os dados do Hologres para análise.

   Nota

   Nesse modo, o Qlik Sense carrega todos os dados em seu mecanismo em vez de enviar consultas em tempo real ao banco de dados com base nas ações da página.