A propos de DBMS_CLOUD_REPO

Le package DBMS_CLOUD_REPO permet d'accéder facilement aux fichiers des référentiels de code cloud (Git), notamment GitHub, AWS CodeCommit et Azure Repos.

Ce package est une interface unique permettant d'accéder aux référentiels de code multicloud et vous permet de télécharger des fichiers SQL vers des référentiels Git ou d'installer des scripts SQL directement à partir de référentiels de code cloud. Ce package vous permet également d'utiliser un référentiel de code cloud afin de gérer les versions de code pour les scripts SQL, et d'installer un code d'application ou d'appliquer des patches à ce code à partir de référentiels Git.

Concepts

  • Système de contrôle des versions Git : Git est un logiciel qui permet de suivre les modifications apportées à un ensemble de fichiers. Il est généralement utilisé pour coordonner le travail des programmeurs qui développent de manière collaborative du code source lors du développement logiciel. Ses objectifs incluent la vitesse, l'intégrité des données et la prise en charge des workflows non linéaires et distribués.

  • Référentiel Git : un référentiel Git est un stockage virtuel de votre projet. Il vous permet d'enregistrer des versions de votre code, auxquelles vous pouvez accéder en cas de besoin.

Architecture

Le package DBMS_CLOUD_REPO fournit quatre types de fonctionnalité :
  • Initialisation de référentiel avec un descripteur de référentiel de code cloud générique

    • Initialisation d'un référentiel de code GitHub

    • Initialisation d'un référentiel de code AWS CodeCommit

    • Initialisation d'un référentiel de code Azure Repos

  • Opérations de gestion de référentiel

    • Créez un référentiel

    • Mettez à jour un référentiel

    • Répertorier les référentiels

    • Supprimez un référentiel

  • Opérations de gestion de fichiers de référentiel

    • Téléchargement d'un fichier vers un référentiel de code à partir d'Oracle Database

    • Téléchargement d'un fichier à partir d'un référentiel de code vers Oracle Database

    • Suppression de fichiers d'un référentiel de code

    • Etablissement de la liste des fichiers d'un référentiel de code

  • Opérations d'installation SQL

    • Export des métadonnées DDL d'objet de base de données vers un référentiel
    • Installation d'instructions SQL à partir d'un fichier du référentiel de code dans Oracle Database

    • Installation d'instructions SQL à partir d'un tampon

Structures de données DBMS_CLOUD_REPO

Le package DBMS_CLOUD_REPO définit les types d'enregistrement et un type d'objet JSON générique repo.

Objet JSON REPO

Pour DBMS_CLOUD_REPO, REPO est un objet JSON opaque qui représente le référentiel de code cloud d'un fournisseur cloud spécifique. Un objet REPO peut être transmis à différentes API DBMS_CLOUD_REPO. Cet objet opaque garantit que les procédures et les fonctions DBMS_CLOUD_REPO sont compatibles avec plusieurs clouds. Il n'est pas nécessaire de modifier le code lors de la migration d'un fournisseur de référentiel de code cloud vers un autre référentiel de code cloud.

Opérations d'initialisation DBMS_CLOUD_REPO

Répertorie les sous-programmes pour les opérations d'initialisation dans le package DBMS_CLOUD_REPO.

Sous-programme Description

Fonction INIT_AWS_REPO

Cette fonction initialise un descripteur de référentiel AWS et renvoie un type opaque.

Fonction INIT_AZURE_REPO

Cette fonction initialise un descripteur de référentiel Azure et renvoie un type opaque.

Fonction INIT_GITHUB_REPO

Cette fonction initialise un descripteur de référentiel GitHub et renvoie un type opaque.

Fonction INIT_REPO

Cette fonction initialise un descripteur de référentiel de code cloud et renvoie un objet JSON opaque.

Opérations de gestion de référentiel DBMS_CLOUD_REPO

Indique les sous-programmes pour les opérations de gestion de référentiel dans le package DBMS_CLOUD_REPO.

Sous-programme Description

Procédure CREATE_REPOSITORY

Cette procédure crée un référentiel de code cloud identifié par l'argument de descripteur repo.

Procédure DELETE_REPOSITORY

Cette procédure supprime le référentiel de code cloud identifié par l'argument de descripteur repo.

Fonction LIST_REPOSITORIES

Cette fonction répertorie tous les référentiels de code cloud identifiés par l'argument de descripteur repo.

Procédure UPDATE_REPOSITORY

Cette procédure met à jour un référentiel de code cloud identifié par l'argument de descripteur repo. La procédure prend en charge la mise à jour du nom, de la description ou du statut de visibilité privée, comme pris en charge par le référentiel de code cloud.

DBMS_CLOUD_REPO Opérations de gestion de branchement de référentiel

Répertorie les sous-programmes pour les opérations de gestion de branchement de référentiel dans le package DBMS_CLOUD_REPO.

Sous-programme Description

CREATE_BRANCH Procédure

Cette procédure crée une branche dans un référentiel de code cloud identifié par l'argument de descripteur repo.

DELETE_BRANCH Procédure

Cette procédure supprime une branche dans un référentiel de code cloud identifié par l'argument de descripteur repo.

Fonction LIST_BRANCHES

Cette fonction répertorie toutes les branches de référentiel de code cloud identifiées par l'argument de descripteur repo.

Fonction LIST_COMMITS

Cette fonction répertorie toutes les validations dans une branche de référentiel de code cloud identifiée par l'argument de descripteur repo.

MERGE_BRANCH Procédure

Cette procédure fusionne une branche de référentiel de code cloud dans une autre branche indiquée dans un référentiel de code cloud identifié par l'argument de descripteur repo.

Opérations de fichier DBMS_CLOUD_REPO

Répertorie les sous-programmes pour les opérations de fichier dans le package DBMS_CLOUD_REPO.

Sous-programme Description

Procédure DELETE_FILE

Cette procédure supprime un fichier du référentiel de code cloud identifié par l'argument de descripteur repo.

Procédure et fonction GET_FILE

La fonction télécharge le contenu d'un fichier à partir du référentiel de code cloud. La procédure permet de télécharger le contenu d'un fichier à partir du référentiel de code cloud et d'enregistrer le fichier dans un répertoire.

Fonction LIST_FILES

Cette fonction télécharge un fichier à partir du référentiel de code cloud. Vous pouvez également accéder au contenu d'un fichier à partir d'un branchement, d'une balise ou d'un nom de validation spécifique. Par défaut, le fichier est accessible à partir du branchement de référentiel par défaut.

Procédure PUT_FILE

Cette procédure télécharge un fichier vers le référentiel de code cloud identifié par l'argument de descripteur repo. La procédure est surchargée pour prendre en charge le téléchargement d'un fichier à partir d'un objet de répertoire ou le téléchargement du contenu d'un objet CLOB vers le fichier de référentiel.

Opérations d'installation SQL DBMS_CLOUD_REPO

Répertorie les sous-programmes pour les opérations d'installation SQL dans le package DBMS_CLOUD_REPO.

Sous-programme Description

Procédure EXPORT_OBJECT

Cette procédure télécharge les métadonnées DDL d'un objet de base de données vers le référentiel de code cloud identifié par l'argument de descripteur repo.

EXPORT_SCHEMA Procédure

Cette procédure exporte les métadonnées de tous les objets d'un schéma vers une branche de référentiel de code cloud identifiée par l'argument de descripteur repo.

Procédure INSTALL_FILE

Cette procédure installe des instructions SQL à partir d'un fichier dans le référentiel de code cloud identifié par l'argument de descripteur repo.

Procédure INSTALL_SQL

Cette procédure installe des instructions SQL à partir d'un tampon fourni en tant qu'entrée.