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. Il permet de télécharger des fichiers SQL vers les référentiels Git ou d'installer des scripts SQL directement à partir des référentiels de code cloud. Ce package vous permet également d'utiliser un référentiel de code cloud pour gérer les versions de code des scripts SQL et pour installer ou appliquer des patches au code d'application à partir des référentiels Git.

Concepts

Système de contrôle de version Git : Git est un logiciel de suivi des modifications dans n'importe quel ensemble de fichiers, généralement utilisé pour coordonner le travail entre les programmeurs en développant de manière collaborative du code source pendant le développement de logiciels. Ses objectifs incluent la vitesse, l'intégrité des données et la prise en charge des workflows distribués et non linéaires.
Git Repository : 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 si nécessaire.

Architecture

Le package DBMS_CLOUD_REPO fournit quatre domaines de fonctionnalités :

Initialisation du référentiel avec le descripteur de référentiel de code cloud générique
- Initialisation d'un référentiel de code GitHub
- Initialiser 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
- Etablissement de listes de référentiels
- Supprimez un référentiel
Opérations de gestion de fichiers de référentiel
- Téléchargez un fichier vers le référentiel de code à partir d'Oracle Database.
- Téléchargez un fichier du référentiel de code vers Oracle Database.
- Supprimez des fichiers du référentiel de code.
- Répertoriez les fichiers du référentiel de code.
Opérations d'installation SQL
- Exportez le DDL de métadonnées d'objet de base de données vers le référentiel.
- Installez les instructions SQL à partir d'un fichier du référentiel de code dans Oracle Database.
- Installez les instructions SQL à partir d'un tampon.

Structures de données DBMS_CLOUD_REPO

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

Objet JSON REPO

Un objet DBMS_CLOUD_REPO REPO est un objet JSON opaque qui représente un 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 fonctions DBMS_CLOUD_REPO sont compatibles multicloud. Vous n'avez pas à modifier de code lorsque vous migrez 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 identificateur 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 du référentiel DBMS_CLOUD_REPO

Affiche les sous-programmes des 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, tel que pris en charge par le référentiel de code cloud.

DBMS_CLOUD_REPO - Opérations de gestion des branches du référentiel

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

Sous-programme	Description
Procédure CREATE_BRANCH	Cette procédure crée une branche dans un référentiel de code cloud identifié par l'argument de descripteur `repo`.
Procédure DELETE_BRANCH	Cette procédure supprime un branchement 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 du référentiel de code cloud identifiées par l'argument descripteur `repo`.
Fonction LIST_COMMITS	Cette fonction répertorie toutes les validations d'une branche Cloud Code Repository identifiée par l'argument de descripteur `repo`.
Procédure MERGE_BRANCH	Cette procédure fusionne un branchement Cloud Code Repository dans un autre branchement spécifié dans un référentiel Cloud Code 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 vous 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 éventuellement accéder au contenu du 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 répertoire ou le téléchargement du contenu d'un objet CLOB vers le fichier référentiel.

Opérations d'installation SQL DBMS_CLOUD_REPO

Répertorie les sous-programmes des 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 LDD d'un objet de base de données vers le référentiel de code cloud identifié par l'argument de descripteur `repo`.
Procédure EXPORT_SCHEMA	Cette procédure exporte les métadonnées de tous les objets d'un schéma vers un branchement de référentiel de code cloud identifié par l'argument de descripteur `repo`.
Procédure INSTALL_FILE	Cette procédure installe les instructions SQL à partir d'un fichier du référentiel de code cloud identifié par l'argument de descripteur `repo`.
Procédure INSTALL_SQL	Cette procédure installe les instructions SQL à partir d'un tampon donné en entrée.