Créer et utiliser un glossaire d'entreprise

Créer et utiliser un glossaire d'entreprise

Ce document explique comment utiliser Knowledge Catalog pour établir un vocabulaire standardisé pour vos composants de données. En créant un glossaire d'entreprise, vous réduisez l'ambiguïté et améliorez la découverte des données dans votre organisation.

Ce guide de démarrage rapide utilise un scénario du secteur de la vente au détail avec des exemples de données dans BigQuery pour vous montrer comment atteindre les objectifs suivants :

1. Créer un glossaire d'entreprise pour les opérations de vente au détail.
2. Créer une hiérarchie de catégories pour la gestion de l'inventaire.
3. Définir des termes commerciaux tels que Niveau de stock de sécurité.
4. Associer des termes commerciaux à des colonnes BigQuery.
5. Rechercher des données à l'aide du contexte commercial.

Avant de commencer

Configurez votre projet :

Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Dataplex and BigQuery APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Dataplex and BigQuery APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et gérer des glossaires d'entreprise, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Administrateur de catalogue Dataplex (roles/dataplex.catalogAdmin) sur le projet de ressources Knowledge Catalog (anciennement Dataplex Universal Catalog)
• Éditeur de données BigQuery (roles/bigquery.dataEditor) sur le projet dans lequel vous utilisez BigQuery

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer le glossaire des opérations de vente au détail

1. Dans la Google Cloud console, accédez à Knowledge Catalog > Glossaires.

   Accéder aux glossaires

2. Cliquez sur Créer un glossaire d'entreprise.

3. Dans le champ Nom à afficher, saisissez Global Retail Operations Glossary.

4. Dans la liste Emplacement, sélectionnez us (plusieurs régions aux États-Unis).

   Les emplacements multirégionaux offrent une disponibilité et une résilience plus élevées, tandis que les régions uniques permettent de répondre à des exigences strictes en matière de résidence des données. Pour en savoir plus, consultez la section Emplacements de Knowledge Catalog.

5. Cliquez sur Créer.

Créer la hiérarchie de catégories

Organisez vos termes dans une hiérarchie pour aider les utilisateurs à naviguer dans vos domaines d'activité. Vous pouvez imbriquer des catégories sur trois niveaux maximum. Pour ce guide de démarrage rapide, tenez compte des catégories suivantes :

• Approvisionnement et logistique : catégorie parente représentant l'ensemble des opérations de la chaîne d'approvisionnement.

• Niveaux de stock : sous-catégorie utilisée pour regrouper des métriques et des paramètres spécifiques liés à la gestion des stocks.

Créer une catégorie parente

Dans cette section, créez la catégorie Supply Chain & Logistics.

1. Sur la page Détails du glossaire de Global Retail Operations Glossary, cliquez sur Créer une catégorie.
2. Dans le champ Nom à afficher, saisissez Supply Chain & Logistics.
3. Cliquez sur Créer.

Créer une sous-catégorie

Dans cette section, créez la catégorie Inventory Levels en tant que sous-ensemble de Supply Chain & Logistics.

1. Dans le volet de gauche, sous Global Retail Operations Glossary, sélectionnez la catégorie Supply Chain &Logistics.

2. Dans le volet principal, cliquez sur Créer une catégorie.

3. Dans le champ Nom à afficher, saisissez Inventory Levels.

4. Cliquez sur Créer.

Définir des termes commerciaux

Dans le secteur de la vente au détail, une terminologie cohérente est essentielle pour gérer les stocks, les ventes et la logistique. Définissez des termes pour capturer la logique métier et les associer à l'aide de synonymes ou de termes associés. Pour ce guide de démarrage rapide, tenez compte des termes suivants :

• Niveau de stock de sécurité : niveau de stock minimal conservé pour se prémunir contre les ruptures de stock causées par une demande imprévisible ou des perturbations de la chaîne d'approvisionnement. Dans ce guide de démarrage rapide, ce terme est également appelé Buffer Stock.

• Délai de livraison : délai entre la commande auprès d'un fournisseur et la réception du stock.

Définir "Niveau de stock de sécurité" comme terme commercial

1. Sélectionnez la catégorie Inventory Levels dans le volet de gauche, puis cliquez sur Ajouter un terme.
2. Dans le champ Nom à afficher , saisissez Safety Stock Level, puis cliquez sur Créer.
3. Sur la page Détails des termes, cliquez sur Ajouter pour Description et saisissez Minimum inventory maintained to mitigate risk of stockouts during supply chain volatility.
4. Cliquez sur Enregistrer.

Ajouter "Stock tampon" comme synonyme

1. Sélectionnez la catégorie Inventory Levels dans le volet de gauche, puis cliquez sur Ajouter un terme.
2. Dans le champ Nom à afficher , saisissez Buffer Stock, puis cliquez sur Créer.
3. Dans la section Termes synonymes, cliquez sur Modifier les synonymes.
4. Recherchez Safety Stock Level, sélectionnez-le, puis cliquez sur Fermer.

Définir "Délai de livraison" et l'associer à "Stock tampon"

1. Sélectionnez la catégorie Inventory Levels dans le volet de gauche, puis cliquez sur Ajouter un terme.
2. Dans le champ Nom à afficher , saisissez Lead Time, puis cliquez sur Créer.
3. Cliquez sur Ajouter pour Description et saisissez The time it takes from placing an order with a supplier to receiving the inventory.
4. Cliquez sur Enregistrer.
5. Dans la section Termes associés, cliquez sur Modifier les termes associés.
6. Recherchez Buffer Stock, sélectionnez-le, puis cliquez sur Fermer.

Créer un exemple de table dans BigQuery

Pour associer les termes commerciaux que vous avez créés à des composants de données réels, créez d'abord un composant avec des colonnes pertinentes.

1. Dans la Google Cloud console, accédez à la page BigQuery.

   Accéder à BigQuery

2. Si vous utilisez BigQuery pour la première fois, cliquez sur OK pour fermer la fenêtre de bienvenue.

3. Dans l'éditeur de requêtes, collez la requête suivante pour créer un exemple d'ensemble de données et de table :

   CREATE SCHEMA omnichannel_prod OPTIONS(location="us");
   CREATE TABLE omnichannel_prod.daily_stock_summary (
     sku STRING,
     buffer_qty INT64,
     order_lead_time INT64
   );
   INSERT INTO omnichannel_prod.daily_stock_summary (sku, buffer_qty, order_lead_time)
   VALUES
     ('SH001', 50, 7),
     ('BT002', 20, 14),
     ('SH003', 60, 5),
     ('BT004', 30, 10),
     ('SH005', 70, 7),
     ('BT006', 40, 12),
     ('SH007', 80, 6);
   

4. Cliquez sur Exécuter. Une fois la requête exécutée, vous disposez d'une nouvelle table nommée daily_stock_summary dans un ensemble de données nommé omnichannel_prod.

Associer des termes à des colonnes de table

1. Dans la Google Cloud console, revenez à la page Knowledge Catalog > Search.

   Accéder à la recherche

2. Actualisez la page si nécessaire.

3. Dans la barre Rechercher , saisissez omnichannel_prod.daily_stock_summary, puis appuyez sur Essayer la recherche en langage naturel.

4. Cliquez sur la table daily_stock_summary dans les résultats de recherche pour afficher ses détails.

5. Cliquez sur l'onglet Schéma.

6. Dans la ligne de buffer_qty, cochez la case, puis cliquez sur Ajouter un terme commercial.

7. Dans le volet Ajouter des termes commerciaux, recherchez et sélectionnez Safety Stock Level.

8. Sélectionnez la ligne de order_lead_time, puis cliquez sur Ajouter un terme commercial.

9. Dans le volet Ajouter des termes commerciaux, recherchez et sélectionnez Lead Time.

Rechercher des données à l'aide du contexte commercial

Les utilisateurs peuvent désormais trouver des composants techniques en utilisant un langage commercial.

1. Dans la Google Cloud console, accédez à Knowledge Catalog > Rechercher.

   Accéder à la recherche

2. Essayez les recherches suivantes pour renvoyer la table daily_stock_summary :

3. Dans la barre de recherche, saisissez term: "Safety Stock Level".

4. Cliquez sur Essayer la recherche en langage naturel.

   La table daily_stock_summary s'affiche.

5. Dans la barre de recherche, saisissez term: "Lead Time", puis appuyez sur Entrée.

   La table daily_stock_summary s'affiche.

6. Pour trouver des composants associés à l'aide de relations de synonymes, accédez à la page Glossaire.

   Accéder aux glossaires

7. Cliquez sur Global Retail Operations Glossary.

8. Dans le volet de navigation de gauche, cliquez sur Supply Chain & Logistics > Inventory Levels > Safety Stock Level.

   Entrées associées liste tous les composants de données associés.

Pour les glossaires à grande échelle, utilisez la fonctionnalité d'importation groupée de Knowledge Catalog afin de gérer les termes de manière programmatique à l'aide de fichiers JSON ou CSV.

Libérer de l'espace

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, procédez comme suit :

Supprimer les ressources du projet

Pour éviter que les ressources utilisées dans ce guide de démarrage rapide soient facturées sur votre Google Cloud compte, supprimez le glossaire et l'ensemble de données que vous avez créés.

Supprimer le glossaire

1. Dans la Google Cloud console, accédez à Knowledge Catalog > Glossaires.

2. Cliquez sur Global Retail Operations Glossary.

3. Supprimez d'abord la catégorie Supply Chain &Logistics.

4. Supprimez la catégorie Inventory Levels.

5. Supprimez tous les termes commerciaux.

6. Cliquez sur Supprimer pour le glossaire lui-même.

7. Confirmez la suppression.

Supprimer l'ensemble de données BigQuery

1. Dans la Google Cloud console, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le panneau Explorateur, développez votre projet et recherchez l'ensemble de données omnichannel_prod.

3. Cliquez sur Afficher les actions à côté de l'ensemble de données omnichannel_prod , puis sélectionnez Supprimer.

4. Dans la boîte de dialogue, saisissez delete pour confirmer la suppression, puis cliquez sur Supprimer.

Étape suivante

• Découvrez comment rechercher des ressources dans Knowledge Catalog.
• Découvrez comment gérer les glossaires d'entreprise.
• Découvrez comment enrichir les entrées avec des aspects.
• Découvrez les cas d'utilisation de Knowledge Catalog.