Hologres:Quick BI

Adicionar uma source de dados

1. Faça login no console do Quick BI.

2. Na barra de menu superior, clique em Workspace.

3. No painel de navegação à esquerda, clique em Data Source.

4. No canto superior direito da página Data Source, clique em New Data Source.

5. Selecione Alibaba Hologres como tipo de source de dados.

   

6. Configure os parâmetros de conexão conforme seu tipo de rede.

   

   Rede VPC (recomendado) Use esta opção quando o Quick BI e sua instância do Hologres estiverem na mesma VPC.

   Parâmetro	Descrição
   Display Name	Nome para identificar esta source de dados no Quick BI.
   Database Address	Endpoint da VPC da instância do Hologres. Encontre-o no console do Hologres em Instance Details > Network Information > Domain Name. Não inclua o número da porta. Exemplo: hgpostcn-cn-nwy364b5v009-cn-shanghai-vpc-st.hologres.aliyuncs.com
   Port	Porta da VPC. Localize-a na mesma coluna Domain Name.
   Database	Nome do banco de dados. Disponível na página Database Management no console do Hologres.
   Schema	Schema a ser exposto no Quick BI. O padrão é public. Se você especificar um schema diferente do padrão, todas as tabelas desse schema serão exibidas. Ao execute consultas SQL ad hoc em um schema não padrão, prefixe os nomes das tabelas com o nome do schema no formato schema.table.
   Username	Seu AccessKey ID. Obtenha-o em Gerenciamento de AccessKey.
   Password	Seu AccessKey secret. Obtenha-o em Gerenciamento de AccessKey.
   VPC Data Source Switch	Ative (on).
   Purchaser AccessKey ID	AccessKey ID da conta usada para comprar a instância do Hologres.
   Buyer Access Key	AccessKey secret da conta usada para comprar a instância do Hologres.
   Instance ID	ID da instância do Hologres.
   Region	Região onde a instância do Hologres está localizada.
   SSL	(Opcional) Ative para criptografar a conexão com ssl.
   Initialization SQL	(Opcional) Instruções SQL executadas sempre que uma conexão for estabelecida. Apenas instruções SET são suportadas. Separe várias instruções com ponto e vírgula (;).
   Enable File Upload	(Opcional) Ative para permitir uploads de arquivos.

   Rede pública Use esta opção ao conectar-se pela internet. Restrições de lista de permissões do Quick BI se aplicam.

   Parâmetro	Descrição
   Display Name	Nome para identificar esta source de dados no Quick BI.
   Database Address	Endpoint público da instância do Hologres. Encontre-o no console do Hologres em Instance Details > Network Information > Domain Name. Não inclua o número da porta.
   Port	Porta pública. Localize-a na mesma coluna Domain Name.
   Database	Nome do banco de dados. Disponível na página Database Management.
   Schema	O padrão é public. Consulte a tabela de rede VPC para detalhes sobre o comportamento do schema.
   Username	Seu AccessKey ID.
   Password	Seu AccessKey secret.
   VPC Data Source Switch	Desative (off).
   SSL	(Opcional) Ative para criptografar a conexão com ssl.
   Initialization SQL	(Opcional) Apenas instruções SET; separadas por ponto e vírgula.
   Enable File Upload	(Opcional)

   Rede clássica Use esta opção para instâncias do Hologres na rede clássica.

   Parâmetro	Descrição
   Display Name	Nome para identificar esta source de dados no Quick BI.
   Database Address	Endpoint da rede clássica da instância do Hologres. Encontre-o no console do Hologres em Instance Details > Network Information > Domain Name. Não inclua o número da porta. Exemplo: hgpostcn-cn-nwy364b5v009-cn-shanghai-vpc.hologres.aliyuncs.com
   Port	Porta da rede clássica. Localize-a na mesma coluna Domain Name.
   Database	Nome do banco de dados. Disponível na página DB Management.
   Schema	O padrão é public. Consulte a tabela de rede VPC para detalhes sobre o comportamento do schema.
   Username	Seu AccessKey ID.
   Password	Seu AccessKey secret.
   VPC Data Source Switch	Desative (off).
   SSL	(Opcional) Ative para criptografar a conexão com ssl.
   Initialization SQL	(Opcional) Apenas instruções SET; separadas por ponto e vírgula.
   Enable File Upload	(Opcional)

7. Clique em Test Connection para verifique a configuração.

   • Se The data source is connected. aparecer, a conexão foi bem-sucedida.

   • Caso apareça The data source connection failed. Check if the parameters are correct., verifique se o endpoint, porta, nome do banco de dados e credenciais estão corretos. Para conexões VPC, confirme também se o ID da instância, região e valores de AccessKey do comprador estão precisos. Se o problema persistir, certifique-se de que a instância do Hologres está em execução e acessível pelo tipo de rede selecionado.

8. Clique em OK para salve a source de dados.

Visualize dados

Após salve a source de dados, acesse Data Source > My Data Sources e clique na source de dados criada. Todas as tabelas no banco de dados e schema configurados serão listadas.

Escolha um dos métodos abaixo para visualize os dados.

Configure um controle de filtro de tempo

Os passos a seguir exigem uma tabela interna chamada LINEITEM em sua instância do Hologres, carregada com dados da tabela public.odps_lineitem_10g no espaço público do MaxCompute MAXCOMPUTE_PUBLIC_DATA. Consulte Introdução às consultas do Hologres para instruções de configuração.

1. Na página Data Source do console do Quick BI, clique em Create Dataset with SQL no canto superior direito. A caixa de diálogo New Snippet será exibida.

2. Insira a seguinte instrução SQL para consultar a tabela LINEITEM usando placeholders de intervalo de tempo.

   SELECT
       *
   FROM
     "public"."lineitem" AS AME_T_1_
   WHERE
     AME_T_1_."l_shipdate" >= TO_TIMESTAMP('${report_date.get(0)}', 'yyyy-MM-dd hh24:mi:ss')
     AND AME_T_1_."l_shipdate" <= TO_TIMESTAMP('${report_date.get(1)}', 'yyyy-MM-dd hh24:mi:ss')

   Os placeholders ${report_date.get(0)} e ${report_date.get(1)} representam o início e o fim do intervalo de datas selecionado.

3. Clique em Parameter Settings para configure o placeholder SQL.

4. Para Variable Type, selecione Date-YearMonthDayHourMinuteSecond > YYYY-MM-DD HH-MI-SS.

5. Clique em OK e, em seguida, clique em Confirm Edit.

6. Na página de edição do Dashboard, clique em New Filter. Na caixa de diálogo Query Condition Settings, selecione o placeholder SQL configurado.

7. Para inspecionar o SQL resolvido, clique em View SQL na página de edição do Dashboard. A consulta deve ser semelhante a:

   SELECT
     AME_T_1_."l_shipmode" AS T_A0_2_,
     AME_T_1_."l_shipinstruct" AS T_A1_3_,
     SUM(AME_T_1_."l_extendedprice") AS T_A2_4_
   FROM
     "public"."lineitem" AS AME_T_1_
   WHERE
     AME_T_1_."l_shipdate" >= TO_TIMESTAMP('1993-01-01 00:00:00', 'yyyy-MM-dd hh24:mi:ss')
     AND AME_T_1_."l_shipdate" <= TO_TIMESTAMP('1998-12-31 23:59:59', 'yyyy-MM-dd hh24:mi:ss')
   GROUP BY
     AME_T_1_."l_shipmode",
     AME_T_1_."l_shipinstruct"
   LIMIT
     1000 OFFSET 0

Verificar se a Segment_key está ativa

Execute EXPLAIN na consulta e verifique no plano de execução a presença da palavra-chave Segment Filter. Sua presença confirme que o Hologres usa o índice de segmento para o filtro de intervalo de tempo.

1. Faça login no console do Hologres e clique em Instances no painel de navegação à esquerda.

2. Na página Instance Details, clique em Database Management no painel de navegação à esquerda.

3. Na página DB Authorization, clique em SQL Editor.

4. Clique em New SQL Window no canto superior esquerdo.

5. Na página Ad-hoc Query, selecione seu Instance Name e Database e execute a seguinte instrução.

   EXPLAIN SELECT
     AME_T_1_."l_shipmode" AS T_A0_2_,
     AME_T_1_."l_shipinstruct" AS T_A1_3_,
     SUM(AME_T_1_."l_extendedprice") AS T_A2_4_
   FROM
     "public"."lineitem" AS AME_T_1_
   WHERE
     AME_T_1_."l_shipdate" >= TO_TIMESTAMP('1993-01-01 00:00:00', 'yyyy-MM-dd hh24:mi:ss')
     AND AME_T_1_."l_shipdate" <= TO_TIMESTAMP('1998-12-31 23:59:59', 'yyyy-MM-dd hh24:mi:ss')
   GROUP BY
     AME_T_1_."l_shipmode",
     AME_T_1_."l_shipinstruct"
   LIMIT
     1000 OFFSET 0

   

6. Na aba Result, revise o plano de execução.

   ->  Limit  (cost=0.00..1.01 rows=1 width=24)
         ->  Partial HashAggregate  (cost=0.00..1.01 rows=1 width=24)
               Group Key: l_shipmode, l_shipinstruct
               ->  Redistribute Motion  (cost=0.00..1.01 rows=10 width=24)
                     ->  Result  (cost=0.00..1.01 rows=10 width=24)
                           ->  Partial HashAggregate  (cost=0.00..1.01 rows=10 width=24)
                                 Group Key: l_shipmode, l_shipinstruct
                                 ->  Parallelism (Gather Exchange)  (cost=0.00..1.01 rows=32 width=24)
                                       ->  Result  (cost=0.00..1.01 rows=32 width=24)
                                             ->  DecodeNode  (cost=0.00..1.01 rows=32 width=24)
                                                   ->  Partial HashAggregate  (cost=0.00..1.01 rows=32 width=24)
                                                         Group Key: l_shipmode, l_shipinstruct
                                                         ->  Index Scan using holo_index:[1] on lineitem  (cost=0.00..1.00 rows=1000 width=24)
                                                               Segment Filter: ((l_shipdate >= '1993-01-01 00:00:00+08'::timestamp with time zone)

   A linha Segment Filter confirme que o índice Segment_key está ativo. O controle de filtro de tempo funciona conforme o esperado.