Hologres:Quick BI

Adicionar uma fonte de dados

1. acesse o 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 o tipo de fonte de dados.

   

6. configure os parâmetros de conexão com base no seu tipo de rede.

   

   VPC network (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	Um nome para identificar esta fonte de dados no Quick BI.
   Database Address	O endpoint de 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	A porta da VPC. Encontre-a na mesma coluna Domain Name.
   Database	O nome do banco de dados. Encontre-o na página Database Management no console do Hologres.
   Schema	O schema a ser exposto no Quick BI. O padrão é public. Especifique um schema diferente do padrão para que todas as tabelas nesse schema sejam exibidas. Ao executar consultas SQL ad hoc em um schema diferente do padrão, prefixe os nomes das tabelas com o nome do schema no formato schema.table.
   Username	Seu AccessKey ID (accesskey). Obtenha-o em AccessKey.
   Password	Seu AccessKey secret. Obtenha-o em AccessKey.
   VPC Data Source Switch	ative.
   Purchaser AccessKey ID	O AccessKey ID da conta usada para comprar a instância do Hologres.
   Buyer Access Key	O AccessKey secret da conta usada para comprar a instância do Hologres.
   Instance ID	O ID da instância do Hologres.
   Region	A 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 a serem 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 o upload de arquivos.

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

   Parâmetro	Descrição
   Display Name	Um nome para identificar esta fonte de dados no Quick BI.
   Database Address	O 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	A porta pública. Encontre-a na mesma coluna Domain Name.
   Database	O nome do banco de dados. Encontre-o na página Database Management.
   Schema	O padrão é public. Consulte a tabela de rede VPC para obter detalhes sobre o comportamento do schema.
   Username	Seu AccessKey ID. Obtenha-o em AccessKey.
   Password	Seu AccessKey secret. Obtenha-o em AccessKey.
   VPC Data Source Switch	Desative.
   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	Um nome para identificar esta fonte de dados no Quick BI.
   Database Address	O endpoint de 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	A porta da rede clássica. Encontre-a na mesma coluna Domain Name.
   Database	O nome do banco de dados. Encontre-o na página DB Management.
   Schema	O padrão é public. Consulte a tabela de rede VPC para obter detalhes sobre o comportamento do schema.
   Username	Seu AccessKey ID. Obtenha-o em AccessKey.
   Password	Seu AccessKey secret. Obtenha-o em AccessKey.
   VPC Data Source Switch	Desative.
   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 verificar a configuração.

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

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

8. Clique em OK e salve a fonte de dados.

Visualizar dados

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

Escolha um dos seguintes métodos para visualizar os dados.

Configurar um controle de filtro de tempo

As etapas a seguir requerem uma tabela interna chamada LINEITEM na sua instância do Hologres, carregada com dados da tabela public.odps_lineitem_10g no espaço público do MaxCompute (maxcompute) MAXCOMPUTE_PUBLIC_DATA. Consulte Getting started with Hologres queries para obter 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 configurar 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 o Segment_key está efetivo

Execute EXPLAIN na consulta e verifique o plano de execução para a palavra-chave Segment Filter. Sua presença confirma que o índice de segmento está ativo para o filtro de intervalo de tempo.

1. acesse o 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 o Instance Name e o 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 confirma que o índice Segment_key está ativo. O controle de filtro de tempo funciona conforme o esperado.