Gérer vos ressources Cloud SQL à l'aide de Knowledge Catalog

Cette page explique comment rechercher et gérer vos ressources Cloud SQL à l'aide de Knowledge Catalog.

Knowledge Catalog est une plate-forme permettant d'accéder à vos métadonnées, de les stocker et de les gérer. Knowledge Catalog récupère automatiquement les métadonnées suivantes à partir des instances, bases de données, tables, colonnes et vues Cloud SQL :

• Nom
• Emplacement (région)
• Dates de création et de dernière modification
• Schéma (pour les tables et les vues)
• Description
• Contraintes de clé primaire et de clé étrangère

Knowledge Catalog ne récupère les métadonnées qu'à partir des instances Cloud SQL principales, et non des instances répliquées avec accès en lecture ni des instances répliquées de serveur externe.

Vous pouvez utiliser Knowledge Catalog pour découvrir et comprendre vos métadonnées Cloud SQL. Utilisez Knowledge Catalog pour faciliter les activités suivantes :

• Découverte de données
• Classification
• Analyse, y compris les dépendances et l'adéquation à un cas d'utilisation
• Gestion du changement
• Transfert de données (pipelines)
• Évolution du schéma

Avec Knowledge Catalog, vous organisez les métadonnées en associant des aspects aux entrées de métadonnées Cloud SQL. Chaque aspect peut avoir plusieurs champs de métadonnées et être basé sur un type d'aspect prédéfini ou personnalisé.

Par exemple, vous pouvez associer l'aspect suivant à une colonne contenant un numéro de sécurité sociale, qui est une information permettant d'identifier personnellement l'utilisateur :

  pii:true
  pii_type:SSN

Pour en savoir plus sur Knowledge Catalog, consultez À propos de la gestion des métadonnées dans Knowledge Catalog.

Fraîcheur des données d'intégration Knowledge Catalog

La fraîcheur attendue des métadonnées de votre instance dans Knowledge Catalog dépend de la date de création de l'instance et de la version de sa base de données.

Quasiment en temps réel

L'intégration à Knowledge Catalog est activée par défaut lors de la création de l'instance si celle-ci répond à tous les critères suivants :

1. Date de création : à partir du 18 avril 2026

2. Version : Cloud SQL pour MySQL version 8.0 ou ultérieure
3. Architecture réseau : nouvelle architecture réseau

Si votre instance ne répond pas à tous ces critères, consultez Une fois par jour.

Les instances qui répondent à tous ces critères sont créées et contiennent un tableau d'horodatage pour suivre les heures de création et de mise à jour de vos composants. La table d'horodatage est la table resource_timestamps dans la base de données mysql. Vous pouvez interroger la table des codes temporels à partir de Cloud SQL dans la console Cloud de Confiance . Lorsque votre instance subit une modification du LDD ou du schéma, l'intégration interroge la table d'horodatage pour identifier les composants récemment modifiés, puis charge les dernières mises à jour du schéma dans Knowledge Catalog en quasi-temps réel. Dans de rares cas, par exemple en cas d'instabilité du réseau, il est possible que Knowledge Catalog manque une mise à jour. Bien que cela soit rare, toutes les modifications qui ont été manquées finissent par être cohérentes, généralement sous 24 heures. Pour en savoir plus sur les scénarios pouvant entraîner des modifications manquées, consultez la section Limites sur cette page.

Lorsque vous consultez les requêtes exécutées dans une instance, vous voyez celles qui sont compatibles avec l'intégration de Knowledge Catalog. Vous pouvez identifier ces requêtes grâce au commentaire --Dataplex qu'elles incluent. Pour afficher les requêtes d'une instance, consultez Afficher les requêtes actives.

Vous pouvez désactiver l'intégration et la réactiver ultérieurement en suivant les instructions de la section Mettre à jour l'instance.

1 fois par jour

L'intégration à Knowledge Catalog peut être activée pour les instances qui répondent à l'un des critères suivants :

1. Date de création : avant le 18 avril 2026
2. Version : version de Cloud SQL pour MySQL antérieure à 8.0
3. Architecture réseau : ancienne architecture réseau

Si votre instance a été créée après le 18 avril 2026, l'intégration à Knowledge Catalog est activée par défaut. Pour les instances créées avant le 18 avril 2026, vous pouvez activer l'intégration de Knowledge Catalog sur une instance Cloud SQL existante .

Une fois que vous avez activé l'intégration à Knowledge Catalog, les métadonnées des instances qui répondent à l'un de ces critères sont généralement actualisées dans Knowledge Catalog environ une fois par jour. Vous pouvez désactiver l'intégration de Knowledge Catalog et la réactiver si nécessaire.

Avant de commencer

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

2. Verify that billing is enabled for your Cloud de Confiance project.

3. Activez l'API Dataplex pour le projet.

   Activer l'API Dataplex

4. 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 composants Cloud SQL. Pour en savoir plus, consultez Rôles et autorisations IAM requis pour Knowledge Catalog.

Rôles et autorisations IAM requis pour Knowledge Catalog

Cloud SQL utilise l'autorisation cloudsql.schemas.view pour fournir l'accès aux métadonnées dans Knowledge Catalog.

Pour accorder cette autorisation, créez un rôle personnalisé qui l'inclut ou utilisez l'un des rôles prédéfinis qui la possèdent.

Pour en savoir plus, consultez Rôles IAM prédéfinis Cloud SQL.

Créer une instance avec l'intégration Knowledge Catalog activée

Les nouvelles instances sont intégrées à Knowledge Catalog par défaut. Pour créer une instance avec l'intégration de Knowledge Catalog activée, il vous suffit de créer une instance. Pour créer une instance avec Knowledge Catalog intégré en temps quasi réel, votre nouvelle instance doit répondre à tous les critères suivants :

1. Date de création : à partir du 18 avril 2026

2. Version : Cloud SQL pour MySQL version 8.0 ou ultérieure
3. Architecture réseau : nouvelle architecture réseau

Si vous souhaitez activer le catalogue de connaissances en temps quasi réel pour une nouvelle instance avec une version de base de données antérieure ou l'ancienne architecture réseau, vous pouvez cloner l'instance ou la restaurer à partir d'une sauvegarde vers une nouvelle instance.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

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

$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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

Activer l'intégration de Knowledge Catalog sur une instance Cloud SQL existante

1. Date de création : avant le 18 avril 2026
2. Version : version de Cloud SQL pour MySQL antérieure à 8.0
3. Architecture réseau : ancienne architecture réseau

Vous pouvez également suivre les instructions de mise à jour de cette section pour réactiver l'intégration de Knowledge Catalog sur une instance qui était auparavant intégrée à Knowledge Catalog en temps quasi réel. Une fois l'intégration réactivée, les données en temps quasi réel mettent jusqu'à 10 minutes à apparaître dans le catalogue de connaissances.

Pour activer ou réactiver l'intégration de Knowledge Catalog sur une instance Cloud SQL existante, utilisez l'une des procédures suivantes.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

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

$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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

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

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

Vérifier l'intégration de Knowledge Catalog sur votre instance Cloud SQL

Pour vérifier que l'intégration de Knowledge Catalog est activée sur votre instance, utilisez l'une des procédures suivantes.

gcloud sql instances describe INSTANCE_NAME

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

Désactiver l'intégration de Knowledge Catalog sur votre instance Cloud SQL

Pour désactiver l'intégration de Knowledge Catalog à votre instance Cloud SQL, utilisez l'une des procédures suivantes. La désactivation de l'intégration de Knowledge Catalog sur une instance intégrée en temps quasi réel prend jusqu'à 10 minutes.

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

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

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

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

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

Enrichir les éléments Cloud SQL avec 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 Knowledge 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 éléments Cloud SQL. L'association de certains aspects aux éléments Cloud SQL 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 les associer à Cloud SQL, consultez Gérer les aspects et enrichir les métadonnées.

Rechercher des composants Cloud SQL

Utilisez la page de recherche Knowledge Catalog dans la console Cloud de Confiance pour rechercher des éléments Cloud SQL.

1. Accédez à la page Rechercher du catalogue de connaissances.

   Accéder à la recherche

2. Dans Choisir une plate-forme de recherche, sélectionnez Catalogue de connaissances.

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

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

   • Base de données
   • Service
   • Table
   • Afficher

Utiliser des requêtes pour effectuer des recherches

Vous pouvez également utiliser le champ de recherche de Knowledge Catalog pour effectuer des requêtes de recherche. Pour afficher tous les composants Cloud SQL, saisissez system=Cloud_SQL.

Vous pouvez ensuite saisir des mots clés spécifiques. Par exemple, pour afficher toutes les bases de données Cloud SQL, procédez comme suit :

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL 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 Knowledge Catalog.

Vous pouvez saisir directement des requêtes de recherche pour des ressources Cloud SQL 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 QUERY_STRING par une chaîne de requête basée sur le moteur Cloud SQL et le type d'élément que vous souhaitez interroger. Utilisez le tableau suivant pour identifier la chaîne de requête appropriée.

Voici un exemple de requête :

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

Filtrer les composants Cloud SQL par dialecte Cloud SQL

Par défaut, Knowledge Catalog affiche tous les éléments Cloud SQL. Pour filtrer les éléments pour Cloud SQL pour MySQL, Cloud SQL pour PostgreSQL ou SQL Server uniquement, procédez comme suit :

1. Dans le panneau Aspects, cliquez sur le menu Ajouter d'autres types d'aspects.

2. Sélectionnez Accès SQL.

3. Cliquez sur OK.

4. Cliquez sur le bouton de modification de l'aspect playlist_add . Sur la page Accès SQL, procédez comme suit :

   • Dans le champ Dialecte, sélectionnez MySQL pour filtrer les composants Cloud SQL pour MySQL.
   • (Facultatif) Sélectionnez le champ Version, puis saisissez une version spécifique de Cloud SQL pour MySQL.

5. Cliquez sur Appliquer. Knowledge Catalog n'affiche que les éléments Cloud SQL pour MySQL.

Rechercher par type d'aspect

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

1. Dans le panneau Aspects, cliquez sur le menu Ajouter d'autres types d'aspects.

2. (Facultatif) Sélectionnez Accès SQL pour filtrer les résultats par dialecte Cloud SQL. Pour en savoir plus, consultez la procédure précédente, Filtrer les composants Cloud SQL par dialecte Cloud SQL.

3. Sélectionnez un ou plusieurs des types d'aspects suivants pour limiter les résultats de recherche à ce type.

   • Base de données Cloud SQL
   • Instance Cloud SQL
   • Vue Cloud SQL
   • Schéma Cloud SQL
   • Table Cloud SQL

4. Cliquez sur OK.

5. Dans la table des résultats, cliquez sur le nom d'un élément pour en afficher les métadonnées.

6. Facultatif : Améliorez ou affichez vos éléments. Choisissez l'une des options suivantes :

   • Dans Présentation, cliquez sur Ajouter pour ajouter une description en texte enrichi de l'élément.
   • Dans Aspects, cliquez sur Ajouter pour associer un aspect à l'élément.
   • Pour une instance, pour afficher les bases de données des membres, 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 l'instance 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.

Exemple de workflow : afficher le détail d'une instance aux colonnes

Dans cet exemple de workflow, vous commencez par rechercher une instance Cloud SQL, puis vous affichez une base de données membre, puis une table de cette base de données, et enfin les colonnes de la table.

1. Accédez à la page Rechercher du catalogue de connaissances.

   Accéder à la recherche

2. Pour l'option Choisir une plate-forme de recherche, sélectionnez Catalogue de connaissances.

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

4. Sélectionnez le nom d'une instance.

5. Sur la page Informations sur Cloud SQL, cliquez sur l'onglet Liste d'entrées, puis sur Afficher toutes les entrées enfants dans la recherche. Knowledge Catalog affiche les bases de données de l'instance.

6. Sur la page Informations sur la base de données Cloud SQL, cliquez sur l'onglet Liste d'entrées, puis sur Afficher les entrées enfants dans la recherche. Knowledge Catalog affiche les tables de la base de données.

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

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

Ce workflow montre comment afficher le détail d'une instance dans une table. Vous pouvez accéder directement à une liste de tables en saisissant system=Cloud_SQL AND type=Table dans le champ de recherche.

Tarifs

Le stockage des métadonnées techniques Cloud SQL dans Knowledge Catalog est sans frais. La tarification standard de Knowledge 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 des tarifs du catalogue de connaissances.

Utilisation des ressources

Lorsque l'intégration de Knowledge Catalog est activée, Knowledge Catalog extrait régulièrement les données de vos instances. Le processus d'extraction nécessite une certaine utilisation du processeur. Les instances intégrées à Knowledge Catalog en temps quasi réel et les autres instances créées après le 18 avril 2026 ont généralement un impact minimal sur l'utilisation du processeur. Pour la plupart des instances créées avant le 18 avril 2026, y compris toutes celles créées avant le 19 mars 2026, l'utilisation du processeur peut être plus élevée. Cela est particulièrement visible pour les instances avec des types de machines plus petits, par exemple les machines à cœur partagé et avec des schémas plus volumineux (10 000 tables ou plus), qui peuvent utiliser jusqu'à 40 % de leur processeur pendant le processus d'extraction.

Limites

Cette section regroupe les limites d'utilisation de Cloud SQL et de Knowledge Catalog.

• Pour les instances créées avant le 18 avril 2026, l'intégration de Knowledge Catalog avec Cloud SQL est désactivée pour toute instance qui limite l'accès aux ressources en raison de l'enregistrement de ressources dans Assured Workloads.

• Après avoir activé Knowledge Catalog sur une instance, l'affichage de vos ressources Cloud SQL dans Knowledge Catalog peut prendre entre 2 et 48 heures, selon la taille de machine, la version et le type du moteur Cloud SQL que vous utilisez. Cette limite ne s'applique pas lorsque votre instance est mise à jour en temps quasi réel, comme décrit dans Temps quasi réel.

• Les instances que vous configurez pour la haute disponibilité ne seront pas automatiquement activées avec le catalogue de connaissances lors de leur création. Si vous activez la haute disponibilité pour une instance sur laquelle Knowledge Catalog est déjà activé, Knowledge Catalog reste activé, sauf si vous le désactivez.

• Lorsque vous supprimez une base de données, une table ou une vue Cloud SQL pour MySQL, puis que vous recréez cette base de données, cette table ou cette vue portant le nom précédent, toutes les entrées Knowledge Catalog existantes appartenant à la base de données, à la table ou à la vue d'origine restent dans Knowledge Catalog. Lorsque vous effectuez les mêmes opérations de suppression et de recréation sur une base de données Cloud SQL pour PostgreSQL ou SQL Server, les entrées sont supprimées du catalogue de connaissances, ce qui est le comportement attendu.
• Lorsque vous effectuez une opération TRUNCATE sur une base de données Cloud SQL pour MySQL, toutes les entrées Knowledge Catalog sont supprimées de la base de données.

• Lorsqu'une base de données est renommée, seule la mise à jour de la base de données est disponible dans Knowledge Catalog en temps quasi réel. Le mappage sous-jacent de la base de données et de toutes les tables correspondantes sera cohérent à terme dans Knowledge Catalog.
• L'intégration du catalogue de connaissances en temps quasi réel n'est pas compatible avec les instances pour lesquelles VPC Service Controls est activé.
• Une instance peut supprimer des messages, ce qui peut entraîner une cohérence éventuelle des données dans le catalogue de connaissances. Si des messages sont supprimés, les mises à jour manquées deviendront visibles dans le catalogue de connaissances. Voici quelques cas où une instance peut supprimer des messages :
  • Instances qui présentent un taux élevé de DDL sur une courte période.
  • Instances clonées à partir d'une instance existante.
  • Instances restaurées à partir d'une sauvegarde.
  • Instances à court de mémoire.
  • Instances en cours de redémarrage ou dont les bases de données sont en cours de redémarrage.
  • Instances qui rencontrent des problèmes de réseau ou une interruption du processus de synchronisation avec Knowledge Catalog.

Étapes suivantes

• À propos de la gestion des métadonnées dans Knowledge Catalog
• Rôles Knowledge Catalog Identity and Access Management