Créer et utiliser un glossaire d'entreprise

Créer et utiliser un glossaire d'entreprise

Knowledge Catalog vous permet de créer un glossaire d'entreprise pour établir un vocabulaire standardisé pour vos composants de données, réduire l'ambiguïté et améliorer la découverte des données dans votre organisation. Dans ce guide de démarrage rapide, vous allez utiliser un scénario du secteur de la vente au détail avec des exemples de données dans BigQuery pour créer une hiérarchie de catégories pour la gestion de l'inventaire. Vous définissez ensuite des termes commerciaux tels que Niveau de stock de sécurité, les associez à des colonnes BigQuery et recherchez des données en utilisant le contexte métier.

Avant de commencer

Configurez votre projet :

Connectez-vous à votre compte Google Cloud . 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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 commerciales

1. Dans la console Google Cloud , accédez à la page 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 régions multiples offrent une disponibilité et une résilience plus élevées, tandis que les régions uniques permettent de répondre aux exigences strictes de résidence des données. Pour en savoir plus, consultez Emplacements Knowledge Catalog.

5. Cliquez sur Créer.

Créer la hiérarchie des 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 démarrage rapide, tenez compte des catégories suivantes :

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

• Niveaux d'inventaire : 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 pour 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 Chaîne logistique.

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 les termes commerciaux

Dans le secteur du commerce, il est essentiel d'utiliser une terminologie cohérente 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 d'inventaire 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, il est également appelé Buffer Stock.

• Délai de livraison : délai entre la passation d'une commande auprès d'un fournisseur et la réception de l'inventaire.

Définir le terme "Niveau de stock de sécurité" en tant que terme commercial

1. Sélectionnez la catégorie Niveaux d'inventaire 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 conditions, 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 Niveaux d'inventaire 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 le "délai de livraison" et le relier au "stock tampon"

1. Sélectionnez la catégorie Niveaux d'inventaire 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, puis 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, commencez par créer un composant avec les colonnes appropriées.

1. Dans la console Google Cloud , 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ête, 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 tableau

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

   Accéder à la recherche

2. Actualisez la page si nécessaire.

3. Dans la barre Rechercher, saisissez omnichannel_prod.daily_stock_summary, puis cliquez 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 buffer_qty, cochez la case, puis cliquez sur Ajouter un terme métier.

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

8. Sélectionnez la ligne pour order_lead_time, puis cliquez sur Ajouter un terme métier.

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

Rechercher des données à l'aide du contexte métier

Les utilisateurs peuvent désormais trouver des ressources techniques en utilisant un langage métier.

1. Dans la console Google Cloud , accédez à la page 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.

   Le tableau daily_stock_summary s'affiche.

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

   Le tableau daily_stock_summary s'affiche.

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

   Accéder aux glossaires

7. Cliquez sur Glossaire des opérations mondiales pour le secteur du commerce.

8. Dans le volet de navigation de gauche, cliquez sur Chaîne logistique et logistique > Niveaux d'inventaire > Niveau de stock de sécurité.

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

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

Effectuer un nettoyage

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

Supprimer des ressources de projet

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

Supprimer le glossaire

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

2. Cliquez sur Glossaire des opérations mondiales pour le secteur du commerce.

3. Supprimez d'abord la catégorie Approvisionnement et logistique.

4. Supprimez la catégorie Niveaux d'inventaire.

5. Supprimez tous les termes métier.

6. Cliquez sur Supprimer pour supprimer le glossaire.

7. Confirmez la suppression.

Supprimer l'ensemble de données BigQuery

1. Dans la console Google Cloud , 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.

Étapes suivantes

• Découvrez comment rechercher des ressources dans Knowledge Catalog.
• En savoir plus sur la gestion des glossaires d'entreprise
• Découvrez comment enrichir les entrées avec des aspects.
• Découvrez les cas d'utilisation de Knowledge Catalog.