Hologres:Connect and query with HoloWeb

Prérequis

Une instance Hologres doit être activée. Acheter une instance Hologres.

Procédure

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

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

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 puis cliquez sur OK.

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

   Chaque instance Hologres comprend 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 directement une requête SQL.

   1. Cliquez sur Metadata Management > Database.

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

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

      Parameter	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	Oui : Vous êtes automatiquement connecté à la base de données et pouvez l'utiliser immédiatement. Non : 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 rédiger et exécuter des instructions PostgreSQL standard.

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

      Vous pouvez aussi cliquer avec le bouton droit sur My SQL query dans le volet de navigation de gauche, puis 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, puis 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 noms de table et de champ ne sont pas sensibles à la casse dans les requêtes SQL. Pour effectuer une recherche sensible à la casse sur une table, placez son nom entre guillemets doubles (").

   3. La section Result [1] située 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, incluant 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 ainsi d'accélérer les requêtes via des tables externes. Suivez les étapes ci-dessous 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 insérez-y 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 les schémas sont activés dans votre projet MaxCompute, spécifiez n'importe quel 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 public par défaut 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 les schémas sont activés dans votre projet MaxCompute, spécifiez n'importe quel 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 public par défaut 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 les schémas sont activés dans votre projet MaxCompute, spécifiez n'importe quel 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 public par défaut 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. Localisez 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éation d'une table interne dans la console