À propos de DBMS_CLOUD_REPO

L'ensemble DBMS_CLOUD_REPO fournit un accès facile aux fichiers des référentiels de code en nuage (Git), notamment GitHub, AWS CodeCommit et Azure Repos.

Cet ensemble est une interface unique pour l'accès aux référentiels de code multinuages, qui permet de charger des fichiers SQL dans les référentiels Git ou d'installer des scripts SQL directement à partir des référentiels de code en nuage. Cet ensemble permet également d'utiliser un référentiel de code en nuage pour gérer les versions de code des scripts SQL et pour installer et corriger du code d'application à partir des référentiels Git.

Concepts

  • Système de contrôle des versions Git : Git est un logiciel permettant d'effectuer le suivi des modifications apportées à un jeu de fichiers. Il est généralement utilisé pour coordonner le travail entre des programmeurs qui développent du code source en collaboration lors du développement de logiciels. Ses objectifs comprennent la vitesse, l'intégrité des données et la prise en charge des flux de travail distribués et non linéaires.

  • 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 lorsque vous en avez besoin.

Architecture

L'ensemble DBMS_CLOUD_REPO comprend quatre domaines fonctionnels :
  • Initialisation de référentiel avec descripteur de référentiel de code en nuage générique

    • Initialiser un référentiel de code GitHub

    • Initialiser un référentiel de code AWS CodeCommit

    • Initialiser un référentiel de code Azure Repos

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

    • Créer un référentiel

    • Mettre à jour un référentiel

    • Lister les référentiels

    • Supprimer un référentiel

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

    • Charger un fichier dans un référentiel de code à partir d'Oracle Database.

    • Télécharger un fichier à partir d'un référentiel de code dans Oracle Database.

    • Supprimer des fichiers d'un référentiel de code.

    • Lister les fichiers d'un référentiel de code.

  • Opérations d'installation SQL

    • Exporter le LDD des métadonnées d'objets de base de données dans le référentiel.
    • Installer des énoncés SQL à partir d'un fichier du référentiel de code dans Oracle Database.

    • Installer des énoncés SQL à partir d'une mémoire tampon.

Structures de données de DBMS_CLOUD_REPO

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

Objet JSON REPO

Un objet REPO de l'ensemble DBMS_CLOUD_REPO est un objet JSON opaque qui représente un référentiel de code en nuage d'un fournisseur de services infonuagiques spécifique. Un objet REPO peut être transmis à différentes API DBMS_CLOUD_REPO. Cet objet opaque garantit que les procédures et fonctions de DBMS_CLOUD_REPO sont compatibles entre plusieurs nuages; vous n'avez pas besoin de modifier le code lorsque vous migrez d'un fournisseur de référentiel de code en nuage vers un autre référentiel de code en nuage.

Opérations d'initialisation de DBMS_CLOUD_REPO

Liste les sous-programmes des opérations d'initialisation de l'ensemble DBMS_CLOUD_REPO.

Sous-programme Description

Fonction INIT_AWS_REPO

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

Fonction INIT_AZURE_REPO

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

Fonction INIT_GITHUB_REPO

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

Fonction INIT_REPO

Cette fonction initialise un descripteur de référentiel de code en nuage et retourne un objet JSON opaque.

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

Décrit les sous-programmes des opérations de gestion de référentiel de l'ensemble DBMS_CLOUD_REPO.

Sous-programme Description

Procédure CREATE_REPOSITORY

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

Procédure DELETE_REPOSITORY

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

Fonction LIST_REPOSITORIES

Cette fonction liste tous les référentiels de code en nuage identifiés par l'argument de descripteur repo.

Procédure UPDATE_REPOSITORY

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

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

Liste les sous-programmes des opérations de gestion des branches du référentiel de l'ensemble DBMS_CLOUD_REPO.

Sous-programme Description

Procédure CREATE_BRANCH

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

Procédure DELETE_BRANCH

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

Fonction LIST_BRANCHES

Cette fonction liste toutes les branches du référentiel de code en nuage identifiées par l'argument de descripteur repo.

Fonction LIST_COMMITS

Cette fonction liste toutes les validations dans une branche du référentiel de code en nuage identifiée par l'argument de descripteur repo.

Procédure MERGE_BRANCH

Cette procédure fusionne une branche du référentiel de code en nuage dans une autre branche spécifiée d'un référentiel de code en nuage identifié par l'argument de descripteur repo.

Opérations de fichier de DBMS_CLOUD_REPO

Liste les sous-programmes des opérations de fichier de l'ensemble DBMS_CLOUD_REPO.

Sous-programme Description

Procédure DELETE_FILE

Cette procédure supprime un fichier du référentiel de code en nuage 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 en nuage. La procédure permet de télécharger le contenu d'un fichier à partir du référentiel de code en nuage 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 en nuage. Le contenu du fichier est accessible à partir d'une branche, d'un marqueur ou d'un nom de validation spécifique. Par défaut, le fichier est accessible à partir de la branche du référentiel par défaut.

Procédure PUT_FILE

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

Opérations d'installation SQL de DBMS_CLOUD_REPO

Liste les sous-programmes des opérations d'installation SQL de l'ensemble DBMS_CLOUD_REPO.

Sous-programme Description

Procédure EXPORT_OBJECT

Cette procédure charge les métadonnées LDD d'un objet de base de données dans le référentiel de code en nuage 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 une branche du référentiel de code en nuage identifiée par l'argument de descripteur repo.

Procédure INSTALL_FILE

Cette procédure installe des énoncés SQL à partir d'un fichier du référentiel de code en nuage identifié par l'argument de descripteur repo.

Procédure INSTALL_SQL

Cette procédure installe des énoncés SQL à partir d'une mémoire tampon indiquée en entrée.