Administra tus recursos de Cloud SQL con Knowledge Catalog

En esta página, se explica cómo puedes buscar y administrar tus recursos de Cloud SQL con Knowledge Catalog.

Knowledge Catalog es una plataforma para almacenar, administrar y acceder a tus metadatos. Knowledge Catalog recupera automáticamente los siguientes metadatos de instancias, bases de datos, tablas, columnas y vistas de Cloud SQL:

• Nombre
• Ubicación (región)
• Fecha de creación y fecha de la última modificación
• Esquema (para tablas y vistas)
• Descripción
• Restricciones de clave primaria y externa

Knowledge Catalog recupera metadatos solo de instancias principales de Cloud SQL y no de réplicas de lectura ni de réplicas de servidores externos.

Puedes usar Knowledge Catalog para descubrir y comprender tus metadatos de Cloud SQL. Usa Knowledge Catalog para realizar las siguientes actividades:

• Detección de datos
• Clasificación
• Análisis, incluidas las dependencias y la idoneidad para un caso de uso
• Administración de cambios
• Transferencia de datos (canalizaciones)
• Evolución del esquema

Con Knowledge Catalog, puedes seleccionar los metadatos si adjuntas aspectos a las entradas de metadatos de Cloud SQL. Cada aspecto puede tener varios campos de metadatos y se puede basar en un tipo de aspecto predefinido o personalizado.

Por ejemplo, puedes adjuntar el siguiente aspecto a una columna que contiene un número de seguridad social, que es información de identificación personal (PII):

  pii:true
  pii_type:SSN

Para obtener más información sobre Knowledge Catalog, consulta Acerca de la administración de metadatos en Knowledge Catalog.

Actualidad de los datos de integración de Knowledge Catalog

La actualización esperada de los metadatos de tu instancia en Knowledge Catalog depende de la fecha de creación de la instancia y de la versión de la base de datos.

Casi en tiempo real

La integración con Knowledge Catalog está habilitada de forma predeterminada cuando se crea la instancia, si esta cumple con todos los siguientes criterios:

1. Fecha de creación: A partir del 18 de abril de 2026

2. Versión: Cloud SQL para MySQL 8.0 o versiones posteriores
3. Arquitectura de red: Nueva arquitectura de red

Si tu instancia no cumple con todos estos criterios, consulta Una vez al día.

Se crean instancias que cumplen con todos estos criterios y que contienen una tabla de marcas de tiempo para hacer un seguimiento de las horas de creación y actualización de tus recursos. La tabla de marcas de tiempo es la tabla resource_timestamps en la base de datos mysql. Se puede consultar la tabla de marcas de tiempo desde Cloud SQL en la consola de Cloud de Confiance . Cuando tu instancia tiene un cambio de DDL o de esquema, la integración consulta la tabla de marcas de tiempo para identificar los recursos que cambiaron recientemente y, luego, carga las actualizaciones de esquema más recientes en Knowledge Catalog casi en tiempo real. En casos excepcionales, por ejemplo, cuando hay inestabilidad en la red, es posible que Knowledge Catalog no registre una actualización. Si bien esto es poco frecuente, los cambios que se hayan omitido se vuelven coherentes con el tiempo, por lo general, en un plazo de 24 horas. Para obtener más información sobre las situaciones que pueden provocar que se pierdan cambios, consulta Limitaciones en esta página.

Cuando veas las consultas que se ejecutaron en una instancia, verás las que admiten la integración de Knowledge Catalog. Puedes identificar estas búsquedas por el comentario --Dataplex que incluyen. Para ver las consultas de una instancia, consulta Cómo ver las consultas activas.

Puedes desactivar la integración y volver a habilitarla más adelante siguiendo las instrucciones que se indican en Actualiza la instancia.

Una vez al día

La integración con Knowledge Catalog se puede habilitar para las instancias que cumplan cualquiera de los siguientes criterios:

1. Fecha de creación: Antes del 18 de abril de 2026
2. Versión: Cloud SQL para MySQL, versión anterior a la 8.0
3. Arquitectura de red: Arquitectura de red anterior

Si tu instancia se creó después del 18 de abril de 2026, la integración con Knowledge Catalog está habilitada de forma predeterminada. En el caso de las instancias creadas antes del 18 de abril de 2026, puedes habilitar la integración de Knowledge Catalog en una instancia de Cloud SQL existente .

Después de habilitar la integración con Knowledge Catalog, los metadatos de las instancias que cumplen con cualquiera de estos criterios suelen actualizarse en Knowledge Catalog aproximadamente una vez al día. Puedes desactivar la integración de Knowledge Catalog y volver a habilitarla según sea necesario.

Antes de comenzar

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. Habilita la API de Dataplex para el proyecto.

   Habilitar la API de Dataplex

4. Comprueba los permisos.

   Necesitas ciertos roles y permisos de Identity and Access Management (IAM) para buscar y adjuntar entradas a los recursos de Cloud SQL. Si deseas obtener más detalles, consulta Roles y permisos de IAM obligatorios para Knowledge Catalog.

Roles y permisos de IAM obligatorios para Knowledge Catalog

Cloud SQL usa el permiso cloudsql.schemas.view para proporcionar acceso a los metadatos en Knowledge Catalog.

Para proporcionar este permiso, crea un rol personalizada que incluya este permiso o usa una de las funciones predefinidas que tenga este permiso.

Para obtener más información, consulta Roles predefinidos de IAM de Cloud SQL.

Crea una instancia con la integración de Knowledge Catalog habilitada

Las instancias nuevas se integran con Knowledge Catalog de forma predeterminada. Para crear una instancia nueva con la integración de Knowledge Catalog habilitada, solo debes crear una instancia nueva. Para crear una instancia con Knowledge Catalog integrado en tiempo casi real, tu instancia nueva debe cumplir con todos los siguientes criterios:

1. Fecha de creación: A partir del 18 de abril de 2026

2. Versión: Cloud SQL para MySQL 8.0 o versiones posteriores
3. Arquitectura de red: Nueva arquitectura de red

Si quieres habilitar Knowledge Catalog casi en tiempo real para una instancia nueva con una versión de base de datos anterior o la arquitectura de red anterior, puedes clonar la instancia o restablecerla desde una copia de seguridad en una instancia nueva.

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"
}

Habilita la integración de Knowledge Catalog en una instancia de Cloud SQL existente

1. Fecha de creación: Antes del 18 de abril de 2026
2. Versión: Cloud SQL para MySQL, versión anterior a la 8.0
3. Arquitectura de red: Arquitectura de red anterior

También puedes seguir las instrucciones de actualización de esta sección para volver a habilitar la integración de Knowledge Catalog en una instancia que se integró anteriormente con Knowledge Catalog casi en tiempo real. Los datos casi en tiempo real tardan hasta 10 minutos en comenzar a aparecer en el Catálogo de conocimiento después de que se vuelve a habilitar la integración.

Para habilitar o volver a habilitar la integración de Knowledge Catalog en una instancia existente de Cloud SQL, usa uno de los siguientes procedimientos.

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"
}

Verifica la integración de Knowledge Catalog en tu instancia de Cloud SQL

Para verificar que la integración de Knowledge Catalog esté habilitada en tu instancia, usa uno de los siguientes procedimientos.

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

Desactiva la integración de Knowledge Catalog en tu instancia de Cloud SQL

Para desactivar la integración de Knowledge Catalog en tu instancia de Cloud SQL, usa uno de los siguientes procedimientos. Inhabilitar la integración de Knowledge Catalog en una instancia que se integra casi en tiempo real tarda hasta 10 minutos.

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"
}

Enriquece recursos de Cloud SQL con aspectos

Los tipos de aspecto son recursos reutilizables que puedes usar como plantillas para aspectos. Los tipos de aspecto te ayudan a evitar la duplicación de trabajo y los aspectos incompletos. Puedes usar Knowledge Catalog para crear los tipos de aspectos que necesitas.

Después de crear tipos de aspectos personalizados, puedes adjuntar aspectos a tus recursos de Cloud SQL. Adjuntar aspectos a los recursos de Cloud SQL te permite hacer lo siguiente:

• Agregar metadatos empresariales a los recursos
• Buscar recursos por metadatos empresariales y otros metadatos personalizados

Para obtener más información sobre cómo crear tipos de aspectos y adjuntar aspectos a Cloud SQL, consulta Administra aspectos y enriquece los metadatos.

Busca recursos de Cloud SQL

Usa la página de búsqueda de Knowledge Catalog en la Cloud de Confiance consola para buscar recursos de Cloud SQL.

1. Ve a la página Búsqueda de Knowledge Catalog.

   Ir a Búsqueda

2. En Elige una plataforma de búsqueda, selecciona Knowledge Catalog.

3. En el panel Filtros, haz clic en Sistemas y, luego, selecciona Cloud SQL.

4. Opcional. En Alias de tipo, puedes filtrar los resultados de la búsqueda a un tipo específico de recurso de Cloud SQL si seleccionas uno o más de los siguientes tipos de alias:

   • Base de datos
   • Servicio
   • Tabla
   • Ver

Usa consultas para realizar búsquedas

También puedes usar el campo de búsqueda en Knowledge Catalog para realizar búsquedas. Para ver todos los recursos de Cloud SQL, ingresa system=Cloud_SQL.

Luego, puedes ingresar palabras clave específicas. Por ejemplo, para ver todas las bases de datos de Cloud SQL, haz lo siguiente:

system=Cloud_SQL AND type=Database

Para ver todas las tablas de Cloud SQL, ingresa la siguiente consulta:

system=Cloud_SQL AND type=Table

También puedes usar paréntesis y los operadores lógicos AND y OR para expresiones complejas. Para obtener más información sobre las expresiones que puedes usar en el campo de búsqueda, consulta Sintaxis de búsqueda de Knowledge Catalog.

Puedes ingresar búsquedas de forma directa para recursos específicos de Cloud SQL en el campo de búsqueda. El formato de la cadena de consulta es el siguiente:

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

Reemplaza QUERY_STRING por una cadena de consulta basada en el motor de Cloud SQL y el tipo de recurso que deseas consultar. Usa la siguiente tabla para identificar la cadena de consulta adecuada.

Una consulta de ejemplo podría tener el siguiente aspecto:

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

Filtra recursos de Cloud SQL por dialecto de Cloud SQL

De forma predeterminada, Knowledge Catalog muestra todos los recursos de Cloud SQL. Si deseas filtrar los recursos solo para Cloud SQL para MySQL, Cloud SQL para PostgreSQL o SQL Server, sigue estos pasos.

1. En el panel Aspectos, haz clic en el menú Agregar más tipos de aspectos.

2. Selecciona Acceso a SQL.

3. Haz clic en Aceptar.

4. Haz clic en el botón de edición de aspecto playlist_add . En la página Acceso a SQL, haz lo siguiente:

   • En el campo Dialecto, selecciona MySQL para filtrar los elementos de Cloud SQL para MySQL.
   • Opcional. Selecciona el campo Versión y, luego, ingresa una versión específica de Cloud SQL para MySQL.

5. Haz clic en Aplicar. Knowledge Catalog solo muestra los recursos de Cloud SQL para MySQL.

Busca por tipo de aspecto

Knowledge Catalog incluye algunos tipos de aspectos integrados que puedes usar para realizar búsquedas.

1. En el panel Aspectos, haz clic en el menú Agregar más tipos de aspectos.

2. Opcional. Selecciona Acceso a SQL para filtrar los resultados por dialecto de Cloud SQL. Para obtener más información, consulta el procedimiento anterior, Filtra recursos de Cloud SQL por dialecto de Cloud SQL.

3. Selecciona uno o más de los siguientes tipos de aspecto para limitar los resultados de la búsqueda a ese tipo.

   • Base de datos de Cloud SQL
   • Instancia de Cloud SQL
   • Vista de Cloud SQL
   • Esquema de Cloud SQL
   • Tabla de Cloud SQL

4. Haz clic en Aceptar.

5. En la tabla de resultados, haz clic en el nombre de un recurso para ver sus metadatos.

6. Opcional: Mejora o visualiza tus recursos. Puedes realizar cualquiera de las siguientes acciones:

   • En Descripción general, haz clic en Agregar para agregar una descripción de texto enriquecido del recurso.
   • En Aspectos, haz clic en Agregar para adjuntar un aspecto al recurso.
   • Por ejemplo, para ver las bases de datos de miembros, haz clic en la pestaña Lista de entradas y, luego, en Mostrar todas las entradas secundarias en la búsqueda. Si la pestaña Lista de entrada no aparece, la instancia no tiene bases de datos.
   • En Información de las entradas, visualiza todos los detalles del recurso. Haz clic en el nombre de la entrada para desglosar las entradas adicionales.

Flujo de trabajo de ejemplo: desglosar de instancia a columnas

En este flujo de trabajo de ejemplo, primero debes buscar una instancia de Cloud SQL, ver una base de datos de miembro, ver una tabla en esa base de datos y, luego, visualizar las columnas en la tabla.

1. Ve a la página Búsqueda de Knowledge Catalog.

   Ir a Búsqueda

2. Para la opción Elige una plataforma de búsqueda, selecciona Knowledge Catalog.

3. En el panel Filtros, selecciona Sistemas y, luego, Cloud SQL. También puedes ingresar system=Cloud_SQL en el campo de búsqueda.

4. Selecciona un nombre de la instancia.

5. En la página Detalles de Cloud SQL, haz clic en la pestaña Lista de entradas y, luego, en Mostrar todas las entradas secundarias en la búsqueda. Knowledge Catalog muestra las bases de datos en la instancia.

6. En la página Detalles de la base de datos de Cloud SQL, haz clic en la pestaña Lista de entradas y, luego, en Ver entradas secundarias en la búsqueda. Knowledge Catalog muestra las tablas en la base de datos.

7. Selecciona un nombre de tabla y, luego, en la página Detalles de la tabla de Cloud SQL, haz clic en Esquema para ver las columnas de la tabla.

8. Opcional: Para agregar un tipo de aspecto a una columna, haz clic en el botón Agregar aspecto.

Este flujo de trabajo muestra el desglose de una instancia a una tabla. Puedes ir directamente a una lista de tablas si ingresas system=Cloud_SQL AND type=Table en el campo de búsqueda.

Precios

No se aplican cargos por almacenar metadatos técnicos de Cloud SQL en Knowledge Catalog. Los precios estándar de Knowledge Catalog se aplican a las llamadas a la API y al enriquecimiento adicional de metadatos empresariales. Para obtener más información, consulta la página de precios del Catálogo de conocimiento.

Uso de recursos

Mientras la integración de Knowledge Catalog esté habilitada, Knowledge Catalog extraerá datos de tus instancias de forma periódica. El proceso de extracción requiere una cierta cantidad de uso de CPU. Las instancias que se integran con Knowledge Catalog casi en tiempo real y otras instancias creadas después del 18 de abril de 2026 suelen tener un impacto mínimo en el uso de la CPU. En la mayoría de las instancias creadas antes del 18 de abril de 2026, incluidas todas las instancias creadas antes del 19 de marzo de 2026, el uso de CPU puede ser mayor. Esto se nota especialmente en las instancias con tipos de máquinas más pequeños, por ejemplo, máquinas que tienen núcleos compartidos y esquemas más grandes (10,000 tablas o más), que pueden usar hasta el 40% de su CPU durante el proceso de extracción.

Limitaciones

En esta sección, se enumeran las limitaciones en el uso de Cloud SQL y Knowledge Catalog.

• Para las instancias creadas antes del 18 de abril de 2026, la integración de Knowledge Catalog con Cloud SQL está desactivada para cualquier instancia que restrinja el acceso a los recursos debido a la inscripción de recursos en Assured Workloads.

• Después de habilitar Knowledge Catalog en una instancia, los recursos de Cloud SQL pueden tardar entre 2 y 48 horas en aparecer en Knowledge Catalog como recursos, según el tamaño de la máquina, la versión y el tipo de motor de Cloud SQL que uses. Esta limitación no se aplica cuando tu instancia se actualiza casi en tiempo real, como se describe en Casi en tiempo real.

• Las instancias que configures para alta disponibilidad (HA) no se habilitarán automáticamente con Knowledge Catalog cuando se creen. Si habilitas la alta disponibilidad para una instancia con Knowledge Catalog ya habilitado, Knowledge Catalog permanecerá habilitado, a menos que lo desactives.

• Cuando descartas una base de datos, una tabla o una vista de Cloud SQL para MySQL y, luego, vuelves a crear esa base de datos, tabla o vista con el nombre anterior, todas las entradas existentes de Knowledge Catalog que pertenecen a la base de datos original, la tabla o vista permanecen en Knowledge Catalog. Cuando realizas las mismas operaciones de descarte y recreación en una base de datos de Cloud SQL para PostgreSQL o SQL Server, las entradas se quitan de Knowledge Catalog, que es el comportamiento esperado.
• Cuando realizas una operación TRUNCATE en una base de datos de Cloud SQL para MySQL, todas las entradas de Knowledge Catalog se quitan de la base de datos.

• Cuando se cambia el nombre de una base de datos, solo la actualización de la base de datos está disponible en Knowledge Catalog casi en tiempo real. La asignación subyacente de la base de datos y todas las tablas correspondientes será coherente de forma eventual en Knowledge Catalog.
• No se admite la integración de Knowledge Catalog en tiempo casi real para las instancias en las que están habilitados los Controles del servicio de VPC.
• Una instancia puede descartar mensajes, lo que puede hacer que los datos del Catálogo de conocimiento solo sean coherentes de forma eventual. Si se descartan mensajes, las actualizaciones perdidas se harán visibles en el Catálogo de conocimiento con el tiempo. Los casos en los que una instancia podría descartar mensajes incluyen los siguientes:
  • Instancias que experimentan una alta tasa de DDL en un corto período.
  • Son instancias que son clones de una instancia existente.
  • Son las instancias que se restablecen a partir de una copia de seguridad.
  • Instancias que se están quedando sin memoria
  • Instancias que se están reiniciando o reiniciando sus bases de datos
  • Instancias que experimentan problemas de red o una interrupción del proceso de sincronización con Knowledge Catalog.

¿Qué sigue?

• Acerca de la administración de metadatos en Knowledge Catalog
• Roles de Identity and Access Management de Knowledge Catalog