Hologres:Se connecter et interroger avec HoloWeb

Prérequis

Une instance Hologres est activée. Acheter une instance Hologres.

Procédure

1. Connectez-vous à la console de gestion Hologres.

2. Dans le volet de navigation de gauche de la barre de menu supérieure, sélectionnez la région souhaitée.

3. Cliquez sur Go to HoloWeb pour ouvrir la page de développement HoloWeb.

4. Connectez-vous à une instance Hologres.

   1. Sous l'onglet Metadata Management, cliquez sur Instances.

   2. Dans la boîte de dialogue Instances, configurez les paramètres et cliquez sur OK.

      Paramètre	Description	Obligatoire
      Type de réseau	Sélectionnez Public Network ou VPC. L'option Public Network est disponible dans les régions suivantes : Chine (Shanghai), Chine (Shenzhen), Chine (Pékin), Chine (Hangzhou), Chine (Zhangjiakou), Singapour, Chine (Hong Kong), Malaisie (Kuala Lumpur), Indonésie (Jakarta) et États-Unis (Silicon Valley). L'option VPC n'est disponible que dans la région où vous êtes connecté à HoloWeb ; les connexions aux instances VPC ne peuvent pas être modifiées ni supprimées.	Non
      Nom de l'instance	Sélectionnez une instance créée sous votre compte actuel. Si l'instance n'apparaît pas, il se peut que HoloWeb soit encore en cours de chargement ; saisissez manuellement le Domain Name et le Port pour continuer.	Non
      Nom	Nom d'affichage de cette connexion. Par défaut, il correspond au nom de l'instance sélectionnée, mais vous pouvez le personnaliser.	Oui
      Description	Description facultative de cette connexion.	Non
      Nom de domaine	Point de terminaison réseau de votre instance Hologres. La sélection d'un Instance name remplit automatiquement ce champ. Vous pouvez également le saisir manuellement à partir de la section Network Information de la page des détails de l'instance.	Oui
      Port	Port réseau de votre instance Hologres. La sélection d'un Instance name remplit automatiquement ce champ. Vous pouvez également le saisir manuellement à partir de Network Information.	Oui
      Méthode de connexion	L'option Password-free Logon authentifie l'utilisateur à l'aide de votre compte Alibaba Cloud actuel, sans nécessiter d'identifiants. Choisissez cette option si vous vous connectez avec le même compte que celui utilisé pour accéder à la console de gestion. L'option Password Logon vous permet de vous connecter avec l'ID AccessKey et le secret AccessKey de votre compte actuel ou d'un autre compte. Choisissez cette option si vous devez vous connecter en tant qu'autre compte.	Oui
      Nom d'utilisateur	ID AccessKey du compte. Requis uniquement pour l'option Password Logon.	Non
      Mot de passe	Secret AccessKey du compte. Requis uniquement pour l'option Password Logon.	Non
      Tester la connectivité	Cliquez pour vérifier la connexion avant de l'enregistrer. Le message The test is successful. confirme que la connexion est valide. Si le message The test failed. s'affiche, vérifiez votre nom de domaine, votre port et vos identifiants.	Non
      Se connecter après la configuration	Yes : l'instance apparaît dans la liste des instances connectées sur la gauche. No : l'instance est enregistrée mais non connectée, et apparaît dans la liste des instances non connectées.	Oui

5. (Facultatif) Créez une base de données.

   Chaque instance Hologres inclut une base de données par défaut postgres dotée de ressources limitées, destinée uniquement à la gestion.

   Remarque

   Si vous avez déjà créé une base de données, ignorez cette étape et créez une requête SQL.

   1. Cliquez sur Metadata Management > Database.

      Vous pouvez également, sur la page Metadata Management, cliquer avec le bouton droit sur votre instance dans la liste Instances Connected et sélectionner Create Database.

   2. Dans la boîte de dialogue Create Database, configurez les paramètres et cliquez sur OK.

      Paramètre	Description
      Nom de l'instance	Affiche par défaut le nom de l'instance connectée.
      Nom de la base de données	Saisissez un nom pour la base de données. Remarque Le nom de la base de données doit être unique au sein de l'instance.
      Politique d'autorisation	Sélectionnez une politique d'autorisation pour la base de données en fonction de vos besoins métier. Pour plus d'informations sur les politiques d'autorisation, consultez les rubriques suivantes : SPM SLPM Modèle d'autorisation PostgreSQL standard
      Connexion	Yes : Vous êtes automatiquement connecté à la base de données et pouvez l'utiliser immédiatement. No : Vous devez vous connecter manuellement à la base de données avant de pouvoir l'utiliser.

6. Créez une requête SQL

   Utilisez l'SQL Editor pour écrire et exécuter des instructions PostgreSQL standard.

   1. Sur la page SQL Editor, cliquez sur l'icône .

      Vous pouvez également, dans le volet de navigation de gauche, cliquer avec le bouton droit sur My SQL query et sélectionner Create SQL Query. Fenêtre SQL.

   2. Sous le nouvel onglet Ad-hoc Query, sélectionnez une instance dans la liste déroulante Instance Name et une base de données dans la liste déroulante Database. Saisissez les instructions suivantes dans l'éditeur SQL et cliquez sur Run.

      BEGIN;
      CREATE TABLE nation (
       n_nationkey bigint NOT NULL,
       n_name text NOT NULL,
       n_regionkey bigint NOT NULL,
       n_comment text NOT NULL,
      PRIMARY KEY (n_nationkey)
      );
      CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey');
      CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment');
      CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000');
      COMMIT;
      
      INSERT INTO nation VALUES
      (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'),
      (22,'RUSSIA', 3  ,'requests against the platelets use never according to the quickly regular pint'),
      (2,'BRAZIL',  1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '),
      (5,'ETHIOPIA',  0 ,'ven packages wake quickly. regu'),
      (9,'INDONESIA', 2  ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'),
      (14,'KENYA',  0  ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'),
      (3,'CANADA',  1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'),
      (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'),
      (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'),
      (20 ,'SAUDI ARABIA',  4 ,'ts. silent requests haggle. closely express packages sleep across the blithely');
      
      SELECT * FROM nation;

      Remarque

      Les requêtes SQL ne sont pas sensibles à la casse pour les noms de tables et de champs. Pour effectuer une recherche sensible à la casse sur une table, placez le nom de la table entre guillemets doubles (").

   3. La section Result [1] en bas de la page SQL Editor affiche le résultat de l'exécution.

      La requête renvoie 10 enregistrements de la table nation, y compris les colonnes n_nationkey, n_name, n_regionkey et n_comment, ce qui confirme que la création de la table et l'insertion des données ont réussi.

7. Créez une table externe pour accélérer les requêtes sur les données MaxCompute.

   Hologres s'intègre à MaxCompute au niveau de la couche de ressources, permettant d'accélérer les requêtes via des tables externes. Suivez ces étapes pour créer une table externe dans HoloWeb.

   Remarque

   • Assurez-vous d'avoir créé un projet MaxCompute, créé la table source et renseigné celle-ci avec des données. Vous pouvez procéder de l'une des manières suivantes :

     1. Dans DataWorks, liez une source de données MaxCompute, puis créez une table et renseignez-la avec des données.

     2. Utilisez le client MaxCompute pour créer une table et y écrire des données. Utiliser le client MaxCompute.

   • Vous devez vous connecter à une base de données dans HoloWeb avant de pouvoir utiliser les fonctionnalités d'accélération pour les lacs de données MaxCompute et OSS.

   1. Cliquez sur Metadata Management > Import from MaxCompute > Create Foreign Table.

   2. Configurez les paramètres dans la boîte de dialogue Create Foreign Table, sélectionnez une méthode d'accélération, puis cliquez sur Submit.

      Projet entier

      Catégorie	Paramètre	Description
      Acceleration Method	Select an acceleration method.	Hologres prend en charge trois méthodes d'accélération : Entire Project Selected Tables Single Table Sélectionnez Entire Project.
      MaxCompute Data Source	Project Name	Nom du projet MaxCompute.
      	Schema Name	Nom du schéma MaxCompute. Si votre projet MaxCompute utilise des schémas, spécifiez un schéma pour lequel vous disposez d'autorisations. Ce paramètre n'est pas requis pour les projets sans schémas. Opérations sur les schémas.
      Destination Table Position	Schéma Holo	Nom du schéma. Vous pouvez sélectionner le schéma par défaut public ou un schéma personnalisé que vous avez créé.
      Advanced Settings	Processing Rule for Table Name Conflicts	Spécifie comment gérer un conflit de nom de table. Valeurs valides : Ignore, and continue creating other tables Update, and modify the existing table Report an error, and do not create the table
      	Processing Rule for Unsupported Data Types	Spécifie comment gérer un type de données non pris en charge. Valeurs valides : Report an error and fail the import Ignore and Skip Table of Unsupported Fields

      Tables sélectionnées

      Catégorie	Paramètre	Description
      Acceleration Method	Select an acceleration method.	Hologres prend en charge trois méthodes d'accélération : Entire Project Selected Tables Single Table Sélectionnez Selected Tables.
      MaxCompute Data Source	Project Name	Nom du projet MaxCompute.
      	Schema Name	Nom du schéma MaxCompute. Si votre projet MaxCompute utilise des schémas, spécifiez un schéma pour lequel vous disposez d'autorisations. Ce paramètre n'est pas requis pour les projets sans schémas. Opérations sur les schémas.
      Destination Table Position	Schéma Holo	Nom du schéma. Vous pouvez sélectionner le schéma par défaut public ou un schéma personnalisé que vous avez créé.
      Advanced Settings	Processing Rule for Table Name Conflicts	Spécifie comment gérer un conflit de nom de table. Valeurs valides : Ignore, and continue creating other tables Update, and modify the existing table Report an error, and do not create the table
      	Processing Rule for Unsupported Data Types	Spécifie comment gérer un type de données non pris en charge. Valeurs valides : Report an error and fail the import Ignore and Skip Table of Unsupported Fields
      	Search	Vous pouvez effectuer une recherche approximative par nom de table. La recherche renvoie un maximum de 200 tables.

      Table unique

      Catégorie	Paramètre	Description
      Acceleration Method	Select an acceleration method.	Hologres prend en charge trois méthodes d'accélération : Entire Project Selected Tables Single Table Sélectionnez Single Table.
      MaxCompute Data Source	Project Name	Nom du projet MaxCompute.
      	Schema Name	Nom du schéma MaxCompute. Si votre projet MaxCompute utilise des schémas, spécifiez un schéma pour lequel vous disposez d'autorisations. Ce paramètre n'est pas requis pour les projets sans schémas. Opérations sur les schémas.
      	Table Name	Spécifie la table source dans le schéma MaxCompute indiqué. Vous pouvez utiliser un préfixe de nom de table pour effectuer une recherche approximative.
      Destination Hologres Table	Schema	Nom du schéma. Vous pouvez sélectionner le schéma par défaut public ou un schéma personnalisé que vous avez créé.
      	Table Name	Spécifie le nom de la table Hologres utilisée pour l'accélération des requêtes.
      	Destination Table Description	Spécifie la description de la table Hologres utilisée pour l'accélération des requêtes.

   3. Après avoir créé la table externe, accédez à Metadata Management > Instances Connected dans le volet de navigation de gauche. Recherchez la table externe et double-cliquez dessus. Dans l'onglet d'édition qui s'ouvre, cliquez sur Data Preview pour vérifier que vous pouvez interroger les données MaxCompute.

Créer une table interne dans la console