Documentación de Oracle Cloud Infrastructure

Paquete DBMS_CATALOG

El paquete DBMS_CATALOG incluye una amplia gama de subprogramas para la gestión de catálogos, agrupados por funcionalidad.

  • Montaje y desmontaje del catálogo:

    Puede agregar un nuevo catálogo a su base de datos de IA autónoma, ya sea montando una conexión existente (por ejemplo, un enlace de base de datos existente a una base de datos), o agregando una nueva conexión y registrando el sistema externo como un nuevo catálogo.

    Puede activar o desactivar un catálogo.
    Nota

    Los catálogos desactivados conservan los detalles de conexión y los metadatos actuales, pero no se actualizan y no se puede acceder a ellos desde interfaces de usuario o API.

    Elimine o desasocie un catálogo de su base de datos de IA autónoma.

  • Gestión de propiedades de catálogo:
    Los subprogramas que se mencionan aquí permiten recuperar y actualizar varias propiedades de catálogos, esquemas y tablas del sistema. En concreto, proporciona funciones para:

    • Obtener el valor de una propiedad para un catálogo, esquema o tabla, incluidas las opciones para manejar valores de texto grandes mediante el formato CLOB.

    • Actualice el valor de las propiedades de los catálogos, esquemas o tablas, con soporte para tipos de dato normales y CLOB.

  • Gestión de Credenciales:
    Un catálogo montado tendrá cero o más credenciales necesarias. Se trata de credenciales que se deben especificar para poder utilizar el catálogo. Los catálogos de icebergs, por ejemplo, suelen tener dos credenciales necesarias.
    • ICEBERG_CREDENTIAL: credencial utilizada para llamar a los puntos finales del catálogo REST de Iceberg. Normalmente se trata de una credencial de token de portador.
    • DATA_STORAGE_CREDENTIAL: credencial utilizada para acceder a los archivos Iceberg del cubo.
    Puede pensar en credencial necesaria como un parámetro que se debe especificar. Una credencial local es un objeto CREDENTIAL real en el esquema del usuario que desempeña el rol de una de las credenciales necesarias. Puede especificar las credenciales locales al montar el catálogo, utilizando argumentos como catalog_credential y data_storage_credential en DBMS_CATALOG.MOUNT_ICEBERG. También puede especificarlos más adelante llamando a SET_LOCAL_CREDENTIAL.
    BEGIN
  -- Create a new credential
  DBMS_CLOUD.CREATE_CREDENTIAL('BUCKET_CREDENTIAL', ...);

  -- Make the new credential play the role of the required 'DATA_STORAGE_CREDENTIAL'
  DBMS_CATALOG.SET_LOCAL_CREDENTIAL(
    catalog_name => 'iceberg_cat',
    required_credential => 'DATA_STORAGE_CREDENTIAL',
    local_credential => 'BUCKET_CREDENTIAL');
END;
    Puede ver la asignación actual entre las credenciales necesarias y locales con la función GET_LOCAL_CREDENTIAL_MAP.
    SELECT
   JSON_QUERY(dbms_catalog.get_local_credential_map('iceberg_cat'), '$' PRETTY)
FROM dual;
  2    3  
JSON_QUERY(DBMS_CATALOG.GET_LOCAL_CREDENTIAL_MAP('ICEBERG_CAT'),'$'PRETTY)
------------------------------------------------------------------------------------------------------------------------
{
  "DATA_STORAGE_CREDENTIAL" : "BUCKET_CREDENTIAL",
  "ICEBERG_CREDENTIAL" : "UNITY_CRED"
}
  • Gestión de entidades de catálogo:
    Los subprogramas que se muestran aquí hacen referencia a la gestión de varias entidades dentro de un catálogo, incluida la creación, recuperación y supresión de enlaces de almacenamiento, esquemas, tablas y otros objetos del catálogo. Proporciona funciones para:

    • Crear y borrar enlaces de almacenamiento en la nube enlazados a catálogos.

    • Crear y borrar tablas externas en catálogos.

    • Crear y borrar esquemas y su contenido.

    • Recupere listas de tablas, esquemas y otros objetos de catálogo con filtros opcionales.

  • Acceso a datos y almacenamiento en caché:
    Esta sección abarca funciones que gestionan la consulta de datos, la gestión de cursores de resultados y el control del almacenamiento en caché de metadatos en catálogos. Incluye capacidades para:

    • Generar sentencias SELECT para tablas lógicas con opciones personalizables.

    • Abra cursores para recuperar datos de tablas lógicas.

    • Vacíe y rellene previamente la caché de metadatos para que los catálogos mantengan los datos actualizados.

  • Sincronización y uso compartido:
    En esta sección se muestran los subprogramas, que describen las funciones que permiten la gestión y el mantenimiento de catálogos y esquemas consistentes y actualizados en diferentes sistemas o entornos. Proporciona las siguientes funcionalidades.
    • CREATE_SYNCHRONIZED_SCHEMAS: crea esquemas locales en la base de datos que se sincronizan con definiciones de catálogo remotas, lo que garantiza que el entorno local refleje el origen remoto.
    • DROP_SYNCHRONIZED_SCHEMAS: elimina uno o más esquemas que se han sincronizado previamente.
    • UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY: modifica las propiedades de los esquemas sincronizados, como el seguimiento de cambios o el comportamiento de sincronización, mediante la actualización de propiedades con nuevos valores en formato CLOB.
    • GRANT_TO_RECIPIENT & REVOKE_FROM_RECIPIENT: permite gestionar los permisos de acceso otorgando o revocando el acceso a los catálogos para destinatarios de recursos compartidos específicos, controlando quién puede ver o modificar los datos del catálogo.
    ​