Créer et utiliser un glossaire d'entreprise

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

Avant de commencer

Configurez votre projet :

  1. 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.

  2. 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.

    Go to project selector

  3. 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.

  4. Verify that billing is enabled for your Google Cloud project.

  5. 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

  6. 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.

    Go to project selector

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

  8. Verify that billing is enabled for your Google Cloud project.

  9. 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

    10.

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 :

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 à 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 accrues, tandis que les emplacements régionaux permettent de répondre à des exigences strictes en matière de résidence des données. Pour en savoir plus, consultez Emplacements de Knowledge Catalog.

  5. Cliquez sur Créer.

Créer la hiérarchie des catégories

Organisez vos termes selon 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 :

  • 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 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 (Chaîne d'approvisionnement et 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 des termes économiques

Dans le secteur du commerce, 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 associez-les à 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 protéger 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 le moment où une commande est passée auprès d'un fournisseur et celui où l'inventaire est reçu.

Définir "Niveau de stock de sécurité" en tant que terme métier

  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 termes, cliquez sur Ajouter pour Description, puis 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 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 table

  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 de recherche, 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. Sur la ligne de buffer_qty, cochez la case, puis cliquez sur Ajouter un terme métier.

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

  8. Sélectionnez la ligne correspondant à 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 éléments 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.

    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 les éléments associés à l'aide de relations de synonymes, accédez à la page Glossaire.

    Accéder à Glossaires

  7. Cliquez sur Glossaire des opérations de vente au détail mondiales.

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

    Entrées associées liste tous les éléments de données associés.

Pour les glossaires à grande échelle, utilisez la fonctionnalité d'importation groupée de 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 les ressources du 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 de vente au détail mondiales.

  3. Supprimez d'abord la catégorie Chaîne d'approvisionnement et logistique.

  4. Supprimez la catégorie Inventory Levels (Niveaux d'inventaire).

  5. Supprimez tous les termes métier.

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

  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