Hologres:Quick BI

Ajout d'une source de données

1. Connectez-vous à la console Quick BI.

2. Dans la barre de menu supérieure, cliquez sur Workspace.

3. Dans le volet de navigation de gauche, cliquez sur Data Source.

4. Dans le coin supérieur droit de la page Data Source, cliquez sur New Data Source.

5. Sélectionnez Alibaba Hologres comme type de source de données.

   

6. Configurez les paramètres de connexion en fonction de votre type de réseau.

   

   VPC network (recommandé) Utilisez cette option lorsque Quick BI et votre instance Hologres se trouvent dans le même VPC.

   Paramètre	Description
   Display Name	Nom permettant d'identifier cette source de données dans Quick BI.
   Database Address	Point de terminaison VPC de l'instance Hologres. Vous le trouverez dans la console Hologres sous Instance Details > Network Information > Domain Name. N'incluez pas le numéro de port. Exemple : hgpostcn-cn-nwy364b5v009-cn-shanghai-vpc-st.hologres.aliyuncs.com
   Port	Port VPC. Vous le trouverez dans la même colonne Domain Name.
   Database	Nom de la base de données. Vous le trouverez sur la page Database Management de la console Hologres.
   Schema	Schéma à exposer dans Quick BI. La valeur par défaut est public. Si vous spécifiez un schéma non par défaut, toutes les tables de ce schéma sont affichées. Lors de l'exécution de requêtes SQL ad hoc sur un schéma non par défaut, préfixez les noms de table avec le nom du schéma au format schema.table.
   Username	Votre ID AccessKey. Obtenez-le depuis la page AccessKey Management.
   Password	Votre secret AccessKey. Obtenez-le depuis la page AccessKey Management.
   VPC Data Source Switch	Activez l'option (on).
   Purchaser AccessKey ID	ID AccessKey du compte utilisé pour acheter l'instance Hologres.
   Buyer Access Key	Secret AccessKey du compte utilisé pour acheter l'instance Hologres.
   Instance ID	ID de l'instance Hologres.
   Region	Région où réside l'instance Hologres.
   SSL	(Facultatif) Activez cette option pour chiffrer la connexion avec SSL.
   Initialization SQL	(Facultatif) Instructions SQL à exécuter à chaque établissement de connexion. Seules les instructions SET sont prises en charge. Séparez plusieurs instructions par un point-virgule (;).
   Enable File Upload	(Facultatif) Activez cette option pour autoriser les téléchargements de fichiers.

   Public network Utilisez cette option lors d'une connexion via Internet. Les restrictions de liste d'autorisation de Quick BI s'appliquent.

   Paramètre	Description
   Display Name	Nom permettant d'identifier cette source de données dans Quick BI.
   Database Address	Point de terminaison public de l'instance Hologres. Vous le trouverez dans la console Hologres sous Instance Details > Network Information > Domain Name. N'incluez pas le numéro de port.
   Port	Port public. Vous le trouverez dans la même colonne Domain Name.
   Database	Nom de la base de données. Vous le trouverez sur la page Database Management.
   Schema	La valeur par défaut est public. Consultez le tableau du réseau VPC pour plus de détails sur le comportement du schéma.
   Username	Votre ID AccessKey.
   Password	Votre secret AccessKey.
   VPC Data Source Switch	Désactivez l'option (off).
   SSL	(Facultatif) Activez cette option pour chiffrer la connexion avec SSL.
   Initialization SQL	(Facultatif) Instructions SET uniquement ; séparées par des points-virgules.
   Enable File Upload	(Facultatif)

   Classic network Utilisez cette option pour les instances Hologres sur le réseau classique.

   Paramètre	Description
   Display Name	Nom permettant d'identifier cette source de données dans Quick BI.
   Database Address	Point de terminaison du réseau classique de l'instance Hologres. Vous le trouverez dans la console Hologres sous Instance Details > Network Information > Domain Name. N'incluez pas le numéro de port. Exemple : hgpostcn-cn-nwy364b5v009-cn-shanghai-vpc.hologres.aliyuncs.com
   Port	Port du réseau classique. Vous le trouverez dans la même colonne Domain Name.
   Database	Nom de la base de données. Vous le trouverez sur la page DB Management.
   Schema	La valeur par défaut est public. Consultez le tableau du réseau VPC pour plus de détails sur le comportement du schéma.
   Username	Votre ID AccessKey.
   Password	Votre secret AccessKey.
   VPC Data Source Switch	Désactivez l'option (off).
   SSL	(Facultatif) Activez cette option pour chiffrer la connexion avec SSL.
   Initialization SQL	(Facultatif) Instructions SET uniquement ; séparées par des points-virgules.
   Enable File Upload	(Facultatif)

7. Cliquez sur Test Connection pour vérifier la configuration.

   • Si le message The data source is connected. s'affiche, la connexion a réussi.

   • Si le message The data source connection failed. Check if the parameters are correct. s'affiche, vérifiez que le point de terminaison, le port, le nom de la base de données et les identifiants sont corrects. Pour les connexions VPC, vérifiez également que l'ID d'instance, la région et les valeurs AccessKey de l'acheteur sont exactes. Si le problème persiste, confirmez que l'instance Hologres est en cours d'exécution et accessible depuis le type de réseau que vous avez sélectionné.

8. Cliquez sur OK pour enregistrer la source de données.

Visualisation des données

Après avoir enregistré la source de données, accédez à Data Source > My Data Sources et cliquez sur la source de données que vous avez créée. Toutes les tables de la base de données et du schéma configurés sont répertoriées.

Choisissez l'une des méthodes suivantes pour visualiser les données.

Configuration d'un contrôle de filtre temporel

Les étapes suivantes nécessitent une table interne nommée LINEITEM dans votre instance Hologres, chargée avec les données de la table public.odps_lineitem_10g dans l'espace public MaxCompute MAXCOMPUTE_PUBLIC_DATA. Consultez la rubrique Prise en main des requêtes Hologres pour les instructions de configuration.

1. Sur la page Data Source de la console Quick BI, cliquez sur Create Dataset with SQL dans le coin supérieur droit. La boîte de dialogue New Snippet s'affiche.

2. Saisissez l'instruction SQL suivante pour interroger la table LINEITEM à l'aide d'espaces réservés de plage temporelle.

   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')

   Les espaces réservés ${report_date.get(0)} et ${report_date.get(1)} représentent le début et la fin de la plage de dates sélectionnée.

3. Cliquez sur Parameter Settings pour configurer l'espace réservé SQL.

4. Pour Variable Type, sélectionnez Date-YearMonthDayHourMinuteSecond > YYYY-MM-DD HH-MI-SS.

5. Cliquez sur OK, puis sur Confirm Edit.

6. Sur la page d'édition du Dashboard, cliquez sur New Filter. Dans la boîte de dialogue Query Condition Settings, sélectionnez l'espace réservé SQL que vous avez configuré.

7. Pour inspecter le SQL résolu, cliquez sur View SQL sur la page d'édition du Dashboard. La requête doit ressembler à ceci :

   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

Vérification de l'efficacité de Segment_key

Exécutez EXPLAIN sur la requête et vérifiez la présence du mot-clé Segment Filter dans le plan d'exécution. Sa présence confirme que l'index de segment est actif pour le filtre de plage temporelle.

1. Connectez-vous à la console Hologres et cliquez sur Instances dans le volet de navigation de gauche.

2. Sur la page Instance Details, cliquez sur Database Management dans le volet de navigation de gauche.

3. Sur la page DB Authorization, cliquez sur SQL Editor.

4. Cliquez sur New SQL Window dans le coin supérieur gauche.

5. Sur la page Ad-hoc Query, sélectionnez votre Instance Name et votre Database, puis exécutez l'instruction suivante.

   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. Dans l'onglet Result, examinez le plan d'exécution.

   ->  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)

   La ligne Segment Filter confirme que l'index Segment_key est actif. Le contrôle de filtre temporel fonctionne comme prévu.