Gérer vos ressources AlloyDB à l'aide de Dataplex Universal Catalog

Vous pouvez rechercher et gérer vos ressources AlloyDB pour PostgreSQL à l'aide de Dataplex Universal Catalog, une plate-forme permettant de stocker, de gérer et d'accéder à vos métadonnées. Vous pouvez utiliser Dataplex Universal Catalog pour découvrir et comprendre vos métadonnées AlloyDB. Utilisez Dataplex Universal Catalog pour vous aider à effectuer les opérations suivantes :

  • Analyse, y compris les dépendances et l'adéquation à un cas d'utilisation
  • Gestion du changement
  • Évolution du schéma

Dataplex Universal Catalog récupère automatiquement les métadonnées suivantes à partir d'AlloyDB :

Type de ressource Métadonnées récupérées
Clusters, bases de données et instances
  • Nom
  • Emplacement (région)
Schéma, colonnes, tables, vues
  • Nom
  • Emplacement (région)
  • Description
  • Schéma

Types de découverte de métadonnées

La découverte des métadonnées, dans le contexte de Dataplex Universal Catalog, est le processus automatisé par lequel Dataplex Universal Catalog analyse les sources de données connectées (comme AlloyDB) pour identifier les éléments de données (comme les tables, les vues et les bases de données) et extraire leurs métadonnées techniques (comme les schémas, les descriptions et les emplacements) dans son catalogue.

Ce processus s'exécute périodiquement pour synchroniser le catalogue avec les systèmes sources. Pour AlloyDB, les métadonnées de cluster et d'instance sont détectées par défaut, tandis que les métadonnées de base de données, de schéma, de table et de vue ne sont détectées que lorsque vous activez l'intégration sur le cluster.

Dataplex Universal Catalog est compatible avec les recherches par mots clés et en langage naturel.

  • La recherche par mots clés vous permet de trouver des ressources à l'aide de mots clés et de filtres spécifiques, ainsi que d'une syntaxe définie. Par exemple, vous pouvez saisir system=AlloyDB AND type=Database pour afficher toutes les bases de données AlloyDB.
  • La recherche en langage naturel (version preview) utilise l'IA pour comprendre les requêtes sémantiques. Elle vous permet de trouver des ressources en utilisant un langage courant, sans avoir besoin d'une syntaxe complexe. Par exemple, vous pouvez saisir des requêtes telles que List all AlloyDB tables related to sales.

Pour en savoir plus, consultez Syntaxe de recherche pour Dataplex Universal Catalog.

Exemple : Découvrir un schéma de base de données AlloyDB

Pour comprendre le processus de découverte des métadonnées, prenons l'exemple d'un cluster AlloyDB nommé user-data-cluster avec l'intégration de Dataplex Universal Catalog activée. Dans l'instance principale de ce cluster, vous disposez d'une base de données nommée profiles qui contient une table customers (id, email, signup_date) et une vue active_users (id, email).

AlloyDB est synchronisé périodiquement avec Dataplex Universal Catalog. Les ressources suivantes sont disponibles :

  • Clusters
  • Colonnes
  • Bases de données
  • Instances
  • Tables
  • Vues

Une fois la découverte terminée, vous pouvez rechercher ces éléments (table customers et active_users) sur la page Dataplex Universal Catalog de la console Google Cloud ou à l'aide de l'API, afficher leurs schémas et les enrichir avec des métadonnées opérationnelles ou métier supplémentaires.

Enrichir les métadonnées à l'aide des aspects

Les types d'aspect sont des ressources réutilisables pouvant servir de modèles pour les aspects. Les types d'aspects vous aident à éviter la duplication de tâches et les aspects incomplets. Vous pouvez utiliser Dataplex Universal Catalog pour créer les types d'aspects dont vous avez besoin.

Une fois que vous avez créé des types d'aspect personnalisés, vous pouvez associer des aspects à vos composants AlloyDB. L'association de certains aspects aux éléments AlloyDB vous permet d'effectuer les opérations suivantes :

  • Ajouter des métadonnées métier aux éléments
  • Rechercher des éléments par métadonnées métier et autres métadonnées personnalisées

Pour savoir comment créer des types d'aspects et associer des aspects à AlloyDB, consultez Gérer les aspects et enrichir les métadonnées.

Workflow de découverte des métadonnées

Par défaut, les ressources de cluster et d'instance sont ingérées et détectables. Vous n'avez besoin d'activer l'intégration de Dataplex Universal Catalog pour votre cluster AlloyDB que si vous souhaitez ingérer et découvrir des ressources de base de données, de schéma, de table et de vue.

  1. Pour découvrir les ressources de base de données, de schéma, de table et de vue AlloyDB, vous devez activer l'intégration de Dataplex Universal Catalog pour votre cluster AlloyDB à l'aide de l'API AlloyDB lorsque vous créez un cluster ou lorsque vous mettez à jour un cluster existant. Pour en savoir plus, consultez Créer un cluster et son instance principale.

  2. Recherchez vos composants AlloyDB à l'aide de la page de recherche Dataplex Universal Catalog dans la console Google Cloud . Pour en savoir plus, consultez Rechercher des ressources dans Dataplex Universal Catalog.

  3. Pour ajouter du contexte à vos composants AlloyDB, vous pouvez leur associer des aspects. Les aspects sont des entrées de métadonnées personnalisées qui facilitent la gouvernance et l'analyse des données. Par exemple, vous pouvez utiliser un aspect pour libeller une colonne contenant des informations permettant d'identifier personnellement l'utilisateur. Pour en savoir plus, consultez Gérer les aspects et enrichir les métadonnées.

  4. Vous pouvez désormais parcourir vos ressources AlloyDB en suivant cette hiérarchie : Cluster > Base de données > Schéma > Table ou Vue > Colonne. Vous obtenez ainsi une vue détaillée de votre paysage de données. Pour en savoir plus, consultez Rechercher des ressources dans Dataplex Universal Catalog.

Avant de commencer

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  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. Verify that billing is enabled for your Google Cloud project.

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

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

  6. Activez l'API Dataplex pour le projet.

    Activer l'API Dataplex

  7. Vérifiez les autorisations.

    Vous devez disposer de certains rôles et autorisations IAM (Identity and Access Management) pour rechercher et associer des entrées aux assets AlloyDB. Pour en savoir plus, consultez Rôles et autorisations IAM requis pour Dataplex Universal Catalog.

    8. Rôles IAM requis

    Cette section décrit les rôles et les autorisations nécessaires pour rechercher des ressources et accéder aux résultats de recherche.

    Rôles requis pour accéder aux résultats de recherche

    Pour rechercher et afficher les métadonnées AlloyDB dans Dataplex Universal Catalog, les principaux doivent disposer des autorisations nécessaires pour afficher les ressources AlloyDB, y compris l'autorisation dataplex.projects.search.

    Pour accorder ces autorisations à des comptes principaux (utilisateurs, groupes ou comptes de service, par exemple), attribuez-leur le rôle IAM Lecteur AlloyDB (roles/alloydb.viewer) sur le projet contenant les ressources AlloyDB.

    Opération Dataplex Universal Catalog Ressource AlloyDB Rôles ou autorisations requis
    Rechercher des ressources AlloyDB Cluster alloydb.clusters.get
    Colonnes alloydb.databases.get
    Instance alloydb.instances.get
    Base de données alloydb.databases.get
    Tables alloydb.databases.get
    Vues alloydb.databases.get

    Si vous ne souhaitez pas utiliser le rôle prédéfini Lecteur AlloyDB, vous pouvez attribuer un rôle personnalisé qui inclut les autorisations alloydb.clusters.get, alloydb.instances.get et alloydb.databases.get.

    Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès. Pour en savoir plus sur les rôles IAM AlloyDB, consultez Rôles et autorisations IAM pour AlloyDB.

    Rôles requis pour rechercher des entrées

    Pour rechercher des entrées, vous devez disposer d'au moins l'un des rôles IAM suivants au niveau du projet utilisé pour la recherche :

    Les autorisations applicables aux résultats de recherche sont vérifiées indépendamment du projet sélectionné. Pour en savoir plus, consultez Rechercher des éléments de données avec Dataplex Universal Catalog.

    Activer l'intégration de Dataplex Universal Catalog sur votre cluster AlloyDB

    Par défaut, les ressources de cluster et d'instance sont ingérées et détectables. Vous n'avez besoin d'activer l'intégration de Dataplex Universal Catalog pour votre cluster AlloyDB que si vous souhaitez ingérer et découvrir des ressources de base de données, de schéma, de table et de vue.

    Pour ingérer et rendre vos ressources de base de données, de schéma, de table et de vue détectables, créez ou mettez à jour le cluster à l'aide de l'API AlloyDB. L'activation de cette intégration permet de synchroniser les ressources de base de données, de schéma, de table et de vue des métadonnées du plan de données.

    Pour l'intégration à Dataplex Universal Catalog, vous utilisez l'indicateur dataplexConfig au niveau du cluster. Pour afficher les données des clusters secondaires, vous devez activer cette option séparément. Pour activer l'exportation des métadonnées AlloyDB (comme les bases de données, les schémas et les tables) vers des buckets Cloud Storage, définissez enabled sur true. Ces données sont ensuite disponibles pour être utilisées par Dataplex Universal Catalog. Cette fonctionnalité ne s'applique qu'aux instances principales.

    Activer l'intégration de Dataplex Universal Catalog lorsque vous créez un cluster

    Pour créer un cluster AlloyDB avec l'intégration de Dataplex Universal Catalog activée, utilisez la méthode POST et l'URL suivante. Pour obtenir la liste complète des paramètres de cet appel, consultez Méthode : projects.locations.clusters.create. Pour en savoir plus sur les paramètres de cluster, consultez Afficher les paramètres des clusters et des instances.

    N'incluez pas d'informations sensibles ou permettant d'identifier personnellement l'utilisateur dans l'ID de cluster, car les utilisateurs externes peuvent le voir. Vous n'avez pas besoin d'indiquer l'ID du projet dans le nom du cluster. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

    Pour envoyer votre requête, enregistrez le corps de la requête dans un fichier nommé cluster_request.json :

    {
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : true
  }
}

    Effectuez les remplacements suivants :

    • DATABASE_VERSION : chaîne d'énumération de la version de base de données (par exemple, POSTGRES_16).
    • INITIAL_USERNAME : nom d'utilisateur que vous utilisez pour l'utilisateur postgres par défaut.
    • INITIAL_USER_PASSWORD : mot de passe que vous utilisez pour l'utilisateur postgres par défaut.

    Utilisez la méthode HTTP et l'URL suivantes :

    POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

    Effectuez les remplacements suivants :

    • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant le cluster.
    • LOCATION_ID : ID de la région du cluster.
    • CLUSTER_ID : ID du cluster que vous créez. L'ID du cluster doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.

    Pour envoyer votre demande, utilisez l'une des options suivantes :

    curl (Linux, macOS ou Cloud Shell)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

        curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"

    PowerShell (Windows)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    $cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

    Vous recevez une réponse JSON de ce type :

    Réponse

    {
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

    Activer l'intégration de Dataplex Universal Catalog pour votre cluster AlloyDB

    Pour mettre à jour des champs spécifiques d'un cluster existant, utilisez la méthode PATCH sur projects.locations.clusters resource.

    Utilisez la méthode HTTP et l'URL suivantes :

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

    Effectuez les remplacements suivants :

    • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant le cluster.
    • CLUSTER_ID : nom du cluster.

    Corps JSON de la requête :

    {
  "dataplexConfig": {
    "enabled": true
  }
}

    Pour envoyer votre demande, utilisez l'une des options suivantes :

    curl (Linux, macOS ou Cloud Shell)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

        curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

    PowerShell (Windows)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    $cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

    Vous recevez une réponse JSON de ce type :

    Réponse

    {
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

    Vérifier l'intégration de Dataplex Universal Catalog sur votre cluster AlloyDB

    Pour vérifier que l'intégration de Dataplex Universal Catalog est activée sur un cluster existant, utilisez la méthode GET.

    Utilisez la méthode HTTP et l'URL suivantes :

    GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

    Effectuez les remplacements suivants :

    • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant le cluster.
    • CLUSTER_ID : ID du cluster.

    Pour envoyer votre demande, utilisez l'une des options suivantes :

    curl (Linux, macOS ou Cloud Shell)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

    PowerShell (Windows)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    $cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

    Vous recevez une réponse JSON pour l'ensemble du proto Cluster. Recherchez le message dataplexConfig dans le proto :

    {
"dataplexConfig":
  {
  "enabled": true
  }
}

    Désactiver l'intégration de Dataplex Universal Catalog sur votre cluster AlloyDB

    Utilisez l'exemple suivant pour désactiver l'intégration. Lorsque vous désactivez cette fonctionnalité, seules les métadonnées du cluster et de l'instance sont disponibles.

    Utilisez la méthode HTTP et l'URL suivantes :

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

    Effectuez les remplacements suivants :

    • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant le cluster.
    • CLUSTER_ID : ID du cluster.

    Corps JSON de la requête :

    {
  "dataplexConfig": {
    "enabled": false
  }
}

    Pour envoyer votre requête, développez l'une des options suivantes :

    curl (Linux, macOS ou Cloud Shell)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

    PowerShell (Windows)

    Enregistrez le corps de la requête dans un fichier nommé request.json et exécutez la commande suivante :

    $cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

    Vous recevez une réponse JSON de ce type :

    Réponse

    {
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

    Enrichir les éléments AlloyDB avec des aspects

    Les types d'aspect sont des ressources réutilisables que vous pouvez utiliser comme modèles pour les aspects. Les types d'aspects vous aident à éviter la duplication de tâches et les aspects incomplets. Vous pouvez utiliser Dataplex Universal Catalog pour créer les types d'aspects dont vous avez besoin.

    Une fois que vous avez créé des types d'aspects personnalisés, vous pouvez associer des aspects à vos ressources AlloyDB. L'association de certains aspects aux éléments AlloyDB vous permet d'effectuer les opérations suivantes :

    • Ajouter des métadonnées métier aux éléments
    • Rechercher des éléments par métadonnées métier et autres métadonnées personnalisées

    Pour savoir comment créer des types d'aspects et associer des aspects à AlloyDB, consultez Gérer les aspects et enrichir les métadonnées.

    Rechercher des composants AlloyDB

    Utilisez la page de recherche Dataplex Universal Catalog dans la console Google Cloud pour rechercher des composants AlloyDB.

    1. Accédez à la page Rechercher de Dataplex Universal Catalog.

      Accéder à la recherche

    2. Dans Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog.

    3. Dans le panneau Filtres, cliquez sur Systèmes, puis sélectionnez AlloyDB.

    4. Facultatif. Dans Alias de type, vous pouvez filtrer les résultats de la recherche pour un type spécifique d'élément AlloyDB en sélectionnant un ou plusieurs des alias de type suivants :

      • Base de données
      • Schéma de base de données
      • Cluster
      • Instance
      • Service
      • Table
      • Afficher

    Vous pouvez utiliser le champ de recherche de Dataplex Universal Catalog pour effectuer des requêtes de recherche par mot clé. Par exemple, vous pouvez saisir system=AlloyDB AND type=Database pour afficher toutes les bases de données AlloyDB.

    Pour en savoir plus, consultez Syntaxe de recherche pour Dataplex Universal Catalog.

    Pour afficher tous les composants AlloyDB, saisissez system=AlloyDB.

    Vous pouvez ensuite saisir des mots clés spécifiques. Par exemple, pour afficher toutes les bases de données AlloyDB :

    system=AlloyDB AND type=Database

    Pour afficher toutes les tables AlloyDB, saisissez la requête suivante :

    system=AlloyDB AND type=Table

    Vous pouvez également utiliser des parenthèses et les opérateurs logiques AND et OR pour les expressions complexes. Pour en savoir plus sur les expressions que vous pouvez utiliser dans le champ de recherche, consultez la section Syntaxe de recherche pour Dataplex Universal Catalog.

    Vous pouvez saisir directement des requêtes de recherche pour des composants AlloyDB spécifiques dans le champ de recherche. Le format de la chaîne de requête est le suivant :

    type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

    Remplacez les éléments suivants :

    • QUERY_STRING : utilisez la liste suivante pour identifier une chaîne de requête en fonction du type d'élément AlloyDB que vous souhaitez interroger :

      • alloydb-database
      • alloydb-cluster
      • alloydb-instance
      • alloydb-table
      • alloydb-schema
      • alloydb-view

    Voici un exemple de requête :

    type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

    Rechercher par type d'aspect

    Dataplex Universal Catalog inclut quelques types d'aspects intégrés que vous pouvez utiliser pour effectuer des recherches.

    Pour effectuer une recherche par type d'aspect :

    1. Dans le panneau Aspects, cliquez sur le menu Ajouter d'autres types d'aspects.
    2. Facultatif. Sélectionnez AlloyDB Access pour filtrer les résultats par dialecte AlloyDB.
    3. Sélectionnez un ou plusieurs des types d'aspects suivants pour limiter les résultats de la recherche à ce type.
      • Base de données AlloyDB
      • Cluster AlloyDB
      • Instance AlloyDB
      • Vue AlloyDB
      • Schéma AlloyDB
      • Table AlloyDB
    4. Cliquez sur OK.
    5. Dans le tableau des résultats, cliquez sur le nom de l'asset pour en afficher les métadonnées.
    6. Facultatif : Améliorez ou affichez vos éléments. Vous pouvez effectuer l'une des actions suivantes :
      • Pour ajouter une description en texte enrichi de l'élément, dans Présentation, cliquez sur Ajouter .
      • Pour associer un aspect à l'élément, dans Aspects, cliquez sur Ajouter .
      • Pour afficher les bases de données des membres d'une instance, cliquez sur l'onglet Liste d'entrées, puis sur Afficher toutes les entrées enfants dans la recherche. Si l'onglet Liste des entrées n'apparaît pas, cela signifie que le cluster ne comporte aucune base de données.
      • Dans Détails de l'entrée, affichez tous les détails du composant. Cliquez sur le nom de l'entrée pour afficher d'autres entrées.

    Recherche en langage naturel dans AlloyDB

    La recherche en langage naturel (version preview) utilise l'IA pour comprendre les requêtes sémantiques. Elle vous permet de trouver des ressources en utilisant un langage courant, sans avoir besoin d'une syntaxe complexe. Par exemple, vous pouvez saisir des requêtes telles que List all AlloyDB tables related to sales.

    Pour en savoir plus, consultez Syntaxe de recherche pour Dataplex Universal Catalog.

    Recherche de syntaxe dans AlloyDB

    La recherche par mots clés vous permet de trouver des ressources à l'aide de mots clés et de filtres spécifiques, ainsi que d'une syntaxe définie. Par exemple, vous pouvez saisir system=AlloyDB AND type=Database pour afficher toutes les bases de données AlloyDB.

    Pour en savoir plus, consultez Syntaxe de recherche pour Dataplex Universal Catalog.

    Exemple de workflow : afficher le détail d'un cluster dans les colonnes

    Pour passer d'un cluster à des colonnes, procédez comme suit :

    1. Accédez à la page Rechercher de Dataplex Universal Catalog.

      Accéder à la recherche

    2. Pour l'option Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog.

    3. Dans le panneau Filtres, sélectionnez Systèmes, puis AlloyDB. Vous pouvez également saisir system=AlloyDB dans le champ de recherche.

    4. Sélectionnez un nom de cluster.

    5. Sur la page Informations sur AlloyDB, cliquez sur l'onglet Liste d'entrées, puis sur Afficher toutes les entrées enfants dans la recherche. Dataplex Universal Catalog affiche les bases de données du cluster.

    6. Sur la page Informations sur la base de données AlloyDB, cliquez sur l'onglet Liste d'entrées, puis sur Afficher les entrées enfants dans la recherche. Dataplex Universal Catalog affiche les tables du cluster.

    7. Sélectionnez un nom de table, puis cliquez sur Schéma sur la page Informations sur la table AlloyDB pour afficher les colonnes de la table.

    8. Facultatif : Pour ajouter un type d'aspect à une colonne, cliquez sur le bouton Ajouter un aspect.

    Tarifs

    Le stockage des métadonnées techniques AlloyDB dans Dataplex Universal Catalog est gratuit. La tarification standard de Dataplex Universal Catalog s'applique aux appels d'API et à l'enrichissement supplémentaire des métadonnées métier. Pour en savoir plus, consultez la page sur les tarifs de Dataplex Universal Catalog.

    Utilisation des ressources

    Dataplex Universal Catalog extrait régulièrement les données de vos clusters. Le processus d'extraction nécessite une certaine utilisation du processeur. Les clusters avec des types de machines plus petits, par exemple des machines qui partagent des schémas plus volumineux (10 000 tables ou plus), peuvent utiliser une petite partie de leur processeur pendant le processus d'extraction.

    Limites

    • Vous ne pouvez pas créer plus d'un million de tables par base de données.
    • La mise à jour de votre base de données dans Dataplex Universal Catalog peut prendre jusqu'à 48 heures.
    • Le processus d'extraction prend généralement quelques minutes, mais la durée d'exécution dépend de la taille du processeur et du nombre de tables.
    • Lorsqu'une instance n'existe pas ou n'est pas en cours d'exécution, la suppression des métadonnées peut prendre sept jours.

    Étapes suivantes