Documentation Oracle Cloud Infrastructure

Package DBMS_CATALOG

Le package DBMS_CATALOG inclut un large éventail de sous-programmes de gestion de catalogue, regroupés par fonctionnalité.

  • Montage et démontage du catalogue :

    Vous pouvez ajouter un nouveau catalogue à votre base de données Autonomous AI, soit en montant une connexion existante (par exemple, un lien de base de données existant vers une base de données), soit en ajoutant une nouvelle connexion et en inscrivant le système externe en tant que nouveau catalogue.

    Un catalogue peut être activé ou désactivé.
    Remarque

    Les catalogues désactivés conservent les détails de connexion et les métadonnées en cours, mais ne sont pas mis à jour et ne sont pas accessibles à partir des interfaces utilisateur ou des API.

    Enlevez ou détachez un catalogue de votre base de données Autonomous AI.

  • Gestion des propriétés du catalogue :
    Les sous-programmes mentionnés ici vous permettent d'extraire et de mettre à jour diverses propriétés des catalogues, schémas et tables dans votre système. Plus précisément, il fournit des fonctions pour :

    • Obtenir la valeur d'une propriété pour un catalogue, un schéma ou une table, y compris les options permettant de gérer les valeurs de texte volumineuses via le format CLOB.

    • Mettez à jour la valeur des propriétés pour les catalogues, les schémas ou les tables, avec la prise en charge des types de données standard et CLOB.

  • Gestion des informations d'identification:
    Un catalogue monté n'aura aucune ou plusieurs informations d'identification requises. Il s'agit d'informations d'identification qui doivent être spécifiées pour que le catalogue puisse être utilisé. Les catalogues Iceberg, par exemple, disposent généralement de deux informations d'identification requises.
    • ICEBERG_CREDENTIAL : informations d'identification utilisées pour appeler les adresses de catalogue REST Iceberg. Il s'agit généralement d'informations d'identification de jeton de support.
    • DATA_STORAGE_CREDENTIAL : informations d'identification utilisées pour accéder aux fichiers Iceberg dans le bucket.
    Vous pouvez considérer les informations d'identification requises comme un paramètre à indiquer. Un informations d'identification locales est un objet CREDENTIAL réel dans le schéma de l'utilisateur qui joue le rôle de l'une des informations d'identification requises. Vous pouvez indiquer les informations d'identification locales lorsque vous montez le catalogue, à l'aide d'arguments tels que catalog_credential et data_storage_credential dans DBMS_CATALOG.MOUNT_ICEBERG. Vous pouvez également les spécifier ultérieurement en appelant 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;
    Vous pouvez voir le mappage en cours entre les informations d'identification obligatoires et locales avec la fonction 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"
}
  • Gestion des entités de catalogue :
    Les sous-programmes répertoriés ici font référence à la gestion de différentes entités au sein d'un catalogue, notamment la création, l'extraction et la suppression de liens de stockage, de schémas, de tables et d'autres objets de catalogue. Il fournit des fonctions pour :

    • Créez et supprimez des liens de stockage cloud liés aux catalogues.

    • Créer et supprimer des tables externes dans des catalogues.

    • Créez et supprimez des schémas et leur contenu.

    • Extraire des listes de tables, de schémas et d'autres objets de catalogue avec un filtrage facultatif.

  • Accès aux données et mise en cache :
    Cette section comprend des fonctions qui gèrent l'interrogation des données, la gestion des curseurs de résultats et le contrôle de la mise en cache des métadonnées dans les catalogues. Elle inclut les fonctionnalités suivantes :

    • Générer des instructions SELECT pour les tables logiques avec des options personnalisables.

    • Ouvrez des curseurs pour extraire des données de tables logiques.

    • Videz et préremplissez le cache de métadonnées pour les catalogues afin de maintenir les données à jour.

  • Synchronisation et partage :
    Cette section répertorie les sous-programmes qui décrivent les fonctionnalités permettant la gestion et la maintenance de catalogues et de schémas cohérents et à jour sur différents systèmes ou environnements. Il fournit les fonctionnalités suivantes :
    • CREATE_SYNCHRONIZED_SCHEMAS : crée des schémas locaux sur la base de données qui sont synchronisés avec les définitions de catalogue distant, garantissant ainsi que l'environnement local reflète la source distante.
    • DROP_SYNCHRONIZED_SCHEMAS: Enlève des schémas précédemment synchronisés.
    • UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY : modifie les propriétés des schémas synchronisés, telles que le suivi des modifications ou le comportement de synchronisation, en mettant à jour les propriétés avec de nouvelles valeurs au format CLOB.
    • GRANT_TO_RECIPIENT & REVOKE_FROM_RECIPIENT : permet de gérer les droits d'accès en accordant ou en révoquant l'accès aux catalogues pour des destinataires de partage spécifiques, en contrôlant qui peut visualiser ou modifier les données de catalogue.
    ​