Administra tus recursos de AlloyDB con Knowledge Catalog

Nota: La integración de Knowledge Catalog con AlloyDB ahora está habilitada de forma predeterminada para todos los clústeres de AlloyDB nuevos.

La integración de Knowledge Catalog está habilitada de forma predeterminada para todos los clústeres nuevos de AlloyDB, lo que te permite buscar y administrar tus recursos de AlloyDB para PostgreSQL con Knowledge Catalog, una plataforma que te permite almacenar, administrar y acceder a metadatos. Esta integración te ayuda a descubrir y comprender tus metadatos de AlloyDB, lo que admite los siguientes casos de uso:

• Análisis: Comprende las dependencias y evalúa la idoneidad para varios casos de uso.
• Administración de cambios: Realiza un seguimiento de los cambios en los metadatos y adminístralos de manera eficaz.
• Evolución del esquema: Supervisa y planifica las modificaciones del esquema.

Knowledge Catalog recupera de forma automática los siguientes metadatos de clústeres, instancias, bases de datos, tablas, columnas y vistas de AlloyDB:

• Nombre
• Ubicación (región)
• Etiquetas (para clústeres e instancias)
• Integración de Dataplex habilitada (para clústeres)
• Versión de la base de datos
• Recuento de CPU de la máquina (para instancias)
• Tipo de disponibilidad (para instancias)
• Charset (para bases de datos)
• Intercalación (para bases de datos)
• Propietario
• Descripción (para tablas, vistas, columnas y claves externas)
• Tipo (para clústeres, instancias y máquinas)
• Columnas
  • Tipo de datos
  • Modo
• Clave primaria
• Claves externas
  • Tabla referenciada
  • Asignaciones de columnas
• Fecha/hora de creación
• Hora de la última modificación

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

Nota: Knowledge Catalog se refiere a los recursos en AlloyDB y en otros servicios de Google Cloud como recursos. En este documento, los recursos de AlloyDB (clústeres, instancias, bases de datos, tablas, esquemas y vistas) se denominan recursos de AlloyDB. Los recursos también se refieren a los recursos y sus metadatos de Knowledge Catalog.

Tipos de descubrimiento de metadatos

El descubrimiento de metadatos de Knowledge Catalog es un proceso automatizado que analiza las fuentes de datos conectadas, como AlloyDB, para identificar los recursos de datos, como tablas, vistas y bases de datos. Luego, Knowledge Catalog extrae los metadatos técnicos de los recursos, como esquemas, descripciones y ubicaciones, y los agrega a Knowledge Catalog.

Este proceso sincroniza los metadatos casi en tiempo real, lo que mantiene el catálogo sincronizado con los sistemas de origen. En el caso de AlloyDB, los metadatos del clúster y de la instancia se descubren de forma predeterminada. El descubrimiento de metadatos de bases de datos, esquemas, tablas y vistas está habilitado de forma predeterminada en los clústeres nuevos. En el caso de los clústeres creados antes de que se implementara este valor predeterminado (26 de febrero de 2026), habilita la integración de forma manual.

Búsqueda por palabras clave y búsqueda en lenguaje natural

Knowledge Catalog admite búsquedas por palabras clave y en lenguaje natural.

• La búsqueda por palabras clave te ayuda a encontrar recursos con palabras clave específicas, filtros y una sintaxis definida. Por ejemplo, para ver todas las bases de datos de AlloyDB, ingresa system=AlloyDB AND type=Database.
• La búsqueda en lenguaje natural usa la IA para comprender las consultas semánticas. Te ayuda a encontrar recursos con un lenguaje cotidiano, lo que elimina la necesidad de una sintaxis compleja. Por ejemplo, ingresa una consulta como List all AlloyDB tables related to sales.

Para obtener más información, consulta Sintaxis de búsqueda para Knowledge Catalog.

Ejemplo: Descubre un esquema de base de datos de AlloyDB

Para comprender el proceso de descubrimiento de metadatos, considera el ejemplo de un clúster de AlloyDB llamado user-data-cluster con la integración de Knowledge Catalog habilitada. Dentro de la instancia principal de este clúster, existe una base de datos llamada profiles, que contiene una tabla customers (id, email, signup_date) y una vista active_users (id, email).

Debido a que AlloyDB se sincroniza casi en tiempo real con Knowledge Catalog, están disponibles los siguientes recursos:

• Clústeres
• Columnas
• Bases de datos
• Instancias
• Tablas
• Vistas

Una vez que se complete el descubrimiento, busca estos recursos (la tabla customers y active_users) en la página de Knowledge Catalog de la consola de Google Cloud o con la API. Luego, visualiza sus esquemas y enriquécelos con metadatos empresariales o de operaciones adicionales.

Enriquece los metadatos con aspectos

Los tipos de aspecto son recursos reutilizables que sirven como plantillas para los aspectos. Los tipos de aspecto ayudan a evitar la duplicación de trabajo y la creación de aspectos incompletos. Crea los tipos de aspectos necesarios con Knowledge Catalog.

Después de crear tipos de aspectos personalizados, adjunta aspectos a tus recursos de AlloyDB. Adjuntar aspectos a los recursos de AlloyDB te permite hacer lo siguiente:

• Agregar metadatos empresariales a los activos.
• Busca activos por metadatos empresariales y otros metadatos personalizados.

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

Flujo de trabajo de descubrimiento de metadatos

De forma predeterminada, los recursos de clústeres y de instancias se transfieren y se pueden descubrir. Para transferir y descubrir recursos de bases de datos, esquemas, tablas y vistas, sigue estos pasos:

1. Habilita la integración de Knowledge Catalog para tu clúster de AlloyDB con la API de AlloyDB si aún no está habilitada. Este paso es obligatorio para los clústeres creados antes del 26 de febrero de 2026.

2. Busca tus recursos de AlloyDB con la página de búsqueda de Knowledge Catalog en la consola de Google Cloud . Para obtener más información, consulta Busca recursos en Knowledge Catalog.

3. Para agregar más contexto a tus recursos de AlloyDB, adjunta aspectos a tus recursos. Los aspectos son entradas de metadatos personalizadas que ayudan con la administración y el análisis de datos. Por ejemplo, usa un aspecto para etiquetar una columna que contenga información de identificación personal (PII). Para obtener más información, consulta Administra aspectos y enriquece los metadatos.

4. Navega por tus recursos de AlloyDB siguiendo esta jerarquía: Clúster > Base de datos > Esquema > Tabla o vista > Columna. Esta jerarquía proporciona una vista detallada de tu panorama de datos. Para obtener más información, consulta Busca recursos en Knowledge Catalog.

Antes de comenzar

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

3. Habilita la API de Dataplex para el proyecto.

   Habilitar la API de Dataplex

4. Comprueba los permisos.

   Debes tener roles y permisos específicos de Identity and Access Management (IAM) para buscar y adjuntar entradas a los recursos de AlloyDB. Para obtener más información, consulta Roles y permisos de IAM obligatorios para Knowledge Catalog.

Roles de IAM obligatorios

En esta sección, se describen los roles y los permisos necesarios para buscar recursos y acceder a los resultados de la búsqueda.

Roles necesarios para acceder a los resultados de la búsqueda

Para buscar y ver los metadatos de AlloyDB en Knowledge Catalog, las principales necesitan permisos para ver los recursos de AlloyDB, incluido el permiso dataplex.projects.search.

Para otorgar estos permisos a las principales, como usuarios, grupos o cuentas de servicio, asígnales el rol de IAM de Visualizador de AlloyDB (roles/alloydb.viewer) en el proyecto que contiene los recursos de AlloyDB.

Operación de Knowledge Catalog	Recurso de AlloyDB	Roles o permisos requeridos
Busca recursos de AlloyDB	Clúster	alloydb.clusters.get
	Columnas	alloydb.databases.get
	Instancia	alloydb.instances.get
	Base de datos	alloydb.databases.get
	Tablas	alloydb.databases.get
	Vistas	alloydb.databases.get

Precaución: Si otorgas el rol roles/alloydb.viewer a nivel del proyecto, las principales con este rol pueden ver los metadatos de todas las instancias de AlloyDB del proyecto.

Si no quieres usar el rol predefinido de visualizador de AlloyDB, asigna un rol personalizado que incluya los permisos alloydb.clusters.get, alloydb.instances.get y alloydb.databases.get.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso. Para obtener más información sobre los roles de IAM de AlloyDB, consulta Roles y permisos de IAM para AlloyDB.

Roles necesarios para buscar entradas

Debes tener al menos uno de los siguientes roles de IAM en el proyecto que se usa para la búsqueda:

• Administrador de Dataplex Catalog (roles/dataplex.catalogAdmin)
• Editor del catálogo de Dataplex (roles/dataplex.catalogEditor)
• Visualizador del catálogo de Dataplex (roles/dataplex.catalogViewer)

Los permisos en los resultados de la búsqueda se verifican independientemente del proyecto seleccionado. Para obtener más información, consulta Busca recursos de datos con Knowledge Catalog.

Actualización de los datos de integración de Knowledge Catalog

De forma predeterminada, Knowledge Catalog transfiere y descubre recursos de clústeres y de instancias, y la actualización de sus metadatos es casi en tiempo real.

La integración de Knowledge Catalog para los recursos de base de datos, esquema, tabla y vista está habilitada de forma predeterminada cuando creas un clúster de AlloyDB nuevo. Para evitar que se sincronicen estos metadatos, inhabilita la integración.

Cuando habilitas la integración, se activa la exportación de metadatos de AlloyDB, como bases de datos, esquemas y tablas, a buckets de Cloud Storage para la sincronización periódica o a temas de Pub/Sub para la sincronización casi en tiempo real, lo que los pone a disposición de Knowledge Catalog. Esta función solo se aplica a los clústeres principales. Los clústeres secundarios que se usan para la replicación entre regiones no admiten la integración de Knowledge Catalog para los metadatos de bases de datos, esquemas, tablas y vistas.

Nota: Los metadatos a nivel de recurso, como los metadatos de clústeres y de instancias, siempre están habilitados y no se pueden inhabilitar.

La actualización de los metadatos de estos recursos depende de cuándo se creó o restableció el clúster:

• Casi en tiempo real: Los clústeres creados o restablecidos a partir del 3 de abril de 2026 sincronizan los metadatos con Knowledge Catalog casi en tiempo real. Las actualizaciones están disponibles en Knowledge Catalog en un plazo de hasta 5 minutos. Por lo general, el proceso de extracción tarda unos segundos.

• Cada pocas horas: Los clústeres creados o restablecidos entre el 26 de febrero de 2026 y el 3 de abril de 2026 actualizan los metadatos en Knowledge Catalog cada pocas horas. Las actualizaciones están disponibles en Knowledge Catalog en un plazo de hasta 48 horas. Por lo general, el proceso de extracción tarda unos minutos, pero el tiempo de finalización depende del tamaño de la CPU y del recuento de tablas.

Nota: Para actualizar los clústeres de cada pocas horas a una sincronización casi en tiempo real, comunícate con el equipo de asistencia de Google Cloud .

Crea AlloyDB con la integración de Knowledge Catalog inhabilitada

Puedes controlar esta integración cuando creas o actualizas un clúster con Google Cloud CLI o la API de AlloyDB:

gcloud

Usa el comando gcloud alloydb clusters create para crear un clúster de AlloyDB. Si omites la marca --enable-dataplex-integration, la integración de Knowledge Catalog se habilita de forma predeterminada para los metadatos de la base de datos, el esquema, la tabla y la vista. Para ver una lista completa de los parámetros de esta llamada, consulta gcloud alloydb clusters create. Para obtener información sobre la configuración del clúster, consulta Visualiza la configuración del clúster y de la instancia.

No incluyas información sensible o de identificación personal en el ID del clúster, ya que este podría ser visible en varios contextos operativos, como registros del sistema, paneles de supervisión y comunicaciones de asistencia. No es necesario que incluyas el ID del proyecto en el nombre del clúster. El sistema incluye esto de forma automática cuando es apropiado, por ejemplo, en los archivos de registro.

Para inhabilitar la integración de Knowledge Catalog en los recursos de base de datos, esquema, tabla y vista, incluye la marca --no-enable-dataplex-integration:

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

Realiza los siguientes reemplazos:

• CLUSTER_ID: Es el ID del clúster que creas. El ID del clúster debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• PASSWORD: Es la contraseña que usas para el usuario postgres predeterminado.
• REGION: Es el ID de la región del clúster.

REST

Usa el método POST para crear un clúster de AlloyDB. Si omites el dataplexConfig de la solicitud, la integración de Knowledge Catalog se habilita de forma predeterminada para los metadatos de la base de datos, el esquema, la tabla y la vista. Para obtener una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.create. Para obtener información sobre la configuración del clúster, consulta Visualiza la configuración del clúster y de la instancia.

No incluyas información sensible o de identificación personal en el ID del clúster, ya que este podría ser visible en varios contextos operativos, como registros del sistema, paneles de supervisión y comunicaciones de asistencia. No es necesario que incluyas el ID del proyecto en el nombre del clúster. El sistema incluye esto de forma automática cuando es apropiado, por ejemplo, en los archivos de registro.

Para inhabilitar la integración de Knowledge Catalog en los recursos de base de datos, esquema, tabla y vista, incluye "dataplexConfig": { "enabled": false } en el cuerpo de la solicitud:

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

Realiza los siguientes reemplazos:

• DATABASE_VERSION: Es la cadena de enumeración de la versión de la base de datos, por ejemplo, POSTGRES_16.
• INITIAL_USERNAME: Es el nombre de usuario que usas para el usuario de postgres predeterminado.
• INITIAL_USER_PASSWORD: Es la contraseña que usas para el usuario postgres predeterminado.

Usa el siguiente método HTTP y la siguiente URL:

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

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster que creas. El ID del clúster debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.

Para enviar tu solicitud, usa una de las siguientes opciones:

curl (Linux, macOS o Cloud Shell)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

    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)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Recibirás una respuesta JSON similar a la siguiente:

Respuesta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Habilita la integración de Knowledge Catalog para tu clúster de AlloyDB

Para habilitar la integración de Knowledge Catalog en un clúster existente, usa uno de los siguientes procedimientos:

gcloud

Para habilitar la integración de Knowledge Catalog en un clúster existente, usa el comando gcloud alloydb clusters update con la marca --enable-dataplex-integration.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

Realiza los siguientes reemplazos:

• CLUSTER_ID: el nombre del clúster
• REGION: Es el ID de la región del clúster.

REST

Para actualizar campos específicos de un clúster existente, usa el método PATCH en projects.locations.clusters resource.

Usa el siguiente método HTTP y la siguiente URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: el nombre del clúster

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, usa una de las siguientes opciones:

curl (Linux, macOS o Cloud Shell)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

    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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"
      

PowerShell (Windows)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Recibirás una respuesta JSON similar a la siguiente:

Respuesta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Verifica la integración de Knowledge Catalog en tu clúster de AlloyDB

Para verificar que la integración de Knowledge Catalog esté habilitada en un clúster existente, usa uno de los siguientes procedimientos:

gcloud

Para verificar que la integración de Knowledge Catalog esté habilitada en un clúster existente, usa el comando gcloud alloydb clusters describe.

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

Realiza los siguientes reemplazos:

• CLUSTER_ID: Es el ID del clúster.
• REGION: Es el ID de la región del clúster.

El resultado incluye la sección dataplexConfig en formato YAML. Si enabled es true, la integración de Knowledge Catalog está habilitada:

dataplexConfig:
  enabled: true

REST

Para verificar que la integración de Knowledge Catalog esté habilitada en un clúster existente, usa el método GET.

Usa el siguiente método HTTP y la siguiente URL:

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

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster.

Para enviar tu solicitud, usa una de las siguientes opciones:

curl (Linux, macOS o Cloud Shell)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

PowerShell (Windows)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Recibirás una respuesta JSON para todo el proto de clúster, que incluye el mensaje dataplexConfig:

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

Nota: Si la integración de Knowledge Catalog está inhabilitada en el clúster, la API devuelve "dataplexConfig": {} porque proto3 omite los campos con valores predeterminados.

Desactiva la integración de Knowledge Catalog en tu clúster de AlloyDB

Cuando inhabilitas la integración de Knowledge Catalog en tu clúster de AlloyDB, solo están disponibles los metadatos del clúster y de la instancia.

gcloud

Usa el comando gcloud alloydb clusters update con la marca --no-enable-dataplex-integration para desactivar la integración.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

Realiza los siguientes reemplazos:

• CLUSTER_ID: Es el ID del clúster.
• REGION: Es el ID de la región del clúster.

REST

Usa el siguiente ejemplo para desactivar la integración.

Usa el siguiente método HTTP y la siguiente URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster.

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"
      

PowerShell (Windows)

En el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o usando Cloud Shell, que accede automáticamente a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Recibirás una respuesta JSON similar a la siguiente:

Respuesta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-01-16T02:32:12.281Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Enriquece recursos de AlloyDB con aspectos

Los tipos de aspecto son recursos reutilizables que sirven como plantillas para aspectos. Los tipos de aspecto ayudan a evitar la duplicación de trabajo y la creación de aspectos incompletos. Crea los tipos de aspectos necesarios con Knowledge Catalog.

Después de crear tipos de aspectos personalizados, adjunta aspectos a tus recursos de AlloyDB. Adjuntar aspectos a los recursos de AlloyDB proporciona las siguientes funciones:

• 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 AlloyDB, consulta Administra aspectos y enriquece los metadatos.

Busca recursos de AlloyDB

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

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

4. Es opcional. En Alias de tipo, filtra los resultados de la búsqueda a un tipo específico de recurso de AlloyDB seleccionando uno o más de los siguientes alias de tipo:

   • Base de datos
   • Esquema de base de datos
   • Clúster
   • Instancia
   • Servicio
   • Tabla
   • Ver
   Nota: Service es un alias de tipo para una instancia de AlloyDB.

Usa consultas para realizar búsquedas de palabras clave

Usa el campo de búsqueda en Knowledge Catalog para realizar búsquedas por palabras clave. Por ejemplo, ingresa system=AlloyDB AND type=Database para ver todas las bases de datos de AlloyDB.

Para obtener más información, consulta Sintaxis de búsqueda para Knowledge Catalog.

Para ver todos los recursos de AlloyDB, ingresa system=AlloyDB.

Luego, ingresa palabras clave específicas. Por ejemplo, para ver todas las bases de datos de AlloyDB, haz lo siguiente:

system=AlloyDB AND type=Database

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

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

Puedes ingresar búsquedas de forma directa para recursos específicos de AlloyDB 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 lo siguiente:

• QUERY_STRING: Usa la siguiente lista para identificar una cadena de consulta según el tipo de recurso de AlloyDB que deseas consultar:

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

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

type="projects/dataplex-types/locations/global/entryTypes/alloydb-cluster"

Busca por tipo de aspecto

Knowledge Catalog incluye algunos tipos de aspectos integrados que te ayudan a realizar búsquedas.

Para buscar por tipo de aspecto, sigue estos pasos:

1. En el panel Aspectos, haz clic en el menú Agregar más tipos de aspectos.
2. Es opcional. Selecciona Acceso a AlloyDB para filtrar los resultados por dialecto de AlloyDB.
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 AlloyDB
   • Clúster de AlloyDB
   • Instancia de AlloyDB
   • Vista de AlloyDB
   • Esquema de AlloyDB
   • Tabla de AlloyDB
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 mejorar o visualizar tus recursos de las siguientes maneras:
   • Para agregar una descripción de texto enriquecido del recurso, haz clic en Agregar en Descripción general.
   • Para adjuntar un aspecto al recurso, haz clic en Agregar en Aspectos.
   • Para ver las bases de datos de miembros de una instancia, 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, el clúster no tiene bases de datos.
   • Visualiza todos los detalles del recurso en Información de las entradas. Haz clic en el nombre de la entrada para desglosar las entradas adicionales.

Búsqueda en lenguaje natural en AlloyDB

La búsqueda en lenguaje natural usa la IA para comprender las consultas semánticas. Te ayuda a encontrar recursos con un lenguaje cotidiano, lo que elimina la necesidad de una sintaxis compleja. Por ejemplo, ingresa consultas como List all AlloyDB tables related to sales.

Para obtener más información, consulta Sintaxis de búsqueda para Knowledge Catalog.

Búsqueda de sintaxis en AlloyDB

La búsqueda por palabras clave te ayuda a encontrar recursos con palabras clave específicas, filtros y una sintaxis definida. Por ejemplo, ingresa system=AlloyDB AND type=Database para ver todas las bases de datos de AlloyDB.

Para obtener más información, consulta Sintaxis de búsqueda para Knowledge Catalog.

Flujo de trabajo de ejemplo: desglosar de clúster a columnas

Para desglosar desde el clúster hasta las columnas, sigue estos pasos:

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, AlloyDB. También puedes ingresar system=AlloyDB en el campo de búsqueda.

4. Selecciona un nombre para el clúster.

5. En la página Detalles de AlloyDB, 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 del clúster.

   Nota: Si no aparece la pestaña Lista de entradas, regresa a la página Buscar y elige un clúster diferente.

6. En la página Detalles de la base de datos de AlloyDB, 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 el clúster.

7. Selecciona un nombre de tabla y, luego, en la página Detalles de la tabla de AlloyDB, 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.

Precios

No se aplican cargos por almacenar metadatos técnicos de AlloyDB 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 de Knowledge Catalog.

Uso de recursos

Knowledge Catalog extrae metadatos de tus clústeres de AlloyDB de forma periódica. Este proceso de extracción consume recursos de CPU en tu clúster. Por lo general, el uso de CPU es mínimo. Por ejemplo, los clústeres con tipos de máquinas más pequeños (como n2-highmem-2-icelake) que administran esquemas grandes (como aquellos con 100,000 tablas o más) podrían experimentar un aumento del uso de CPU de hasta un 5% durante la extracción.

Limitaciones

• La integración admite un máximo de un millón de tablas por base de datos y un promedio de 150 columnas por tabla. Si se supera alguno de estos límites, no se extraerán los metadatos de los recursos, como bases de datos, esquemas, tablas y vistas. En Knowledge Catalog, solo están disponibles los metadatos de clústeres y de instancias.
• Cuando se crea un clúster por primera vez, la sincronización inicial de todos los metadatos con Knowledge Catalog puede tardar hasta 48 horas. Después de la sincronización inicial, las actualizaciones posteriores están disponibles casi en tiempo real.
• En caso de que se produzca una alta tasa de cambios de metadatos (más de 100 cambios de DDL por segundo) en tu base de datos, la sincronización de metadatos casi en tiempo real con Knowledge Catalog podría pausarse hasta 30 minutos antes de reanudarse.
• En caso de que se pierda alguna actualización debido a una alta tasa de cambios en los metadatos, problemas de red o cuando se interrumpa el proceso de sincronización, con el tiempo se volverán visibles en Knowledge Catalog en un plazo de 48 horas.
• Cuando una instancia no existe o no se está ejecutando, los metadatos pueden tardar 7 días en borrarse.
• 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 respectivas se actualizarán en Knowledge Catalog en un plazo de 48 horas.

¿Qué sigue?

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