Acerca de DBMS_CLOUD_REPO

El paquete DBMS_CLOUD_REPO proporciona un fácil acceso a los archivos de los repositorios de código en la nube (Git), incluidos: GitHub, AWS CodeCommit y Azure Repos.

Este paquete es una interfaz única para acceder a repositorios de código multinube y le permite cargar archivos SQL en repositorios de Git o instalar scripts SQL directamente desde repositorios de código en la nube. Este paquete también le permite utilizar un repositorio de código en la nube para gestionar versiones de código para scripts SQL e instalar o aplicar parches al código de aplicación desde repositorios de Git.

Conceptos

Sistema de control de versiones de Git: Git es un software para realizar un seguimiento de los cambios en cualquier conjunto de archivos, que generalmente se utiliza para coordinar el trabajo entre los programadores que desarrollan código fuente en colaboración durante el desarrollo de software. Sus objetivos incluyen la velocidad, la integridad de los datos y el soporte para flujos de trabajo distribuidos y no lineales.
Git Repository: Un repositorio Git es un almacenamiento virtual de su proyecto. Le permite guardar versiones de su código, a las que puede acceder cuando sea necesario.

Arquitectura

El paquete DBMS_CLOUD_REPO proporciona cuatro áreas de funciones:

Inicialización de repositorio con manejador de repositorio de código de nube genérico
- Inicialización de un repositorio de código de GitHub
- Inicialización de un repositorio de código CodeCommit de AWS
- Inicialización de un repositorio de código de repositorio de Azure
Operaciones de Gestión de Repositorios
- Cree un repositorio
- Actualice un repositorio
- Enumerar repositorios
- Suprima un repositorio
Operaciones de gestión de archivos de repositorio
- Cargue un archivo en el repositorio de código desde Oracle Database.
- Descargue un archivo del repositorio de código en Oracle Database.
- Suprima archivos del repositorio de código.
- Mostrar archivos del repositorio de código.
Operaciones de instalación de SQL
- Exportar DDL de metadatos de objetos de base de datos al repositorio.
- Instale sentencias SQL desde un archivo en Code Repository en Oracle Database.
- Instalar sentencias SQL desde un buffer.

Estructuras de datos DBMS_CLOUD_REPO

El paquete DBMS_CLOUD_REPO define los tipos de registro y un tipo de objeto JSON genérico repo.

Objeto JSON de REPO

Un DBMS_CLOUD_REPO REPO es un objeto JSON opaco que representa un repositorio de código en la nube de un proveedor de nube específico. Un objeto REPO se puede transferir a diferentes API DBMS_CLOUD_REPO. Este objeto opaco garantiza que los procedimientos y las funciones de DBMS_CLOUD_REPO sean compatibles con varias nubes; no tiene que cambiar ningún código al migrar de un proveedor de repositorio de código en la nube a otro repositorio de código en la nube.

Operaciones de Inicialización DBMS_CLOUD_REPO

Muestra los subprogramas para las operaciones de inicialización en el paquete DBMS_CLOUD_REPO.

Subprograma	Descripción
Función INIT_AWS_REPO	Esta función inicializa un identificador de repositorio de AWS y devuelve un tipo opaco.
Función INIT_AZURE_REPO	Esta función inicializa un identificador de repositorio de Azure y devuelve un tipo opaco.
Función INIT_GITHUB_REPO	Esta función inicializa un identificador de repositorio de GitHub y devuelve un tipo opaco.
Función INIT_REPO	Esta función inicializa un identificador de repositorio de código en la nube y devuelve un objeto JSON opaco.

DBMS_CLOUD_REPO Operaciones de gestión de repositorios

Muestra los subprogramas para las operaciones de gestión del repositorio en el paquete DBMS_CLOUD_REPO.

Subprograma	Descripción
Procedimiento CREATE_REPOSITORY	Este procedimiento crea un repositorio de código en la nube identificado por el argumento de manejador `repo`.
Procedimiento DELETE_REPOSITORY	Este procedimiento suprime el repositorio de código en la nube identificado por el argumento de manejador `repo`.
Función LIST_REPOSITORIES	Esta función muestra todos los repositorios de código en la nube identificados por el argumento de manejador `repo`.
Procedimiento UPDATE_REPOSITORY	Este procedimiento actualiza un repositorio de código en la nube identificado por el argumento de identificador `repo`. El procedimiento admite la actualización del nombre, la descripción o el estado de visibilidad privada, tal como lo admite el repositorio de Cloud Code.

DBMS_CLOUD_REPO Repositorio Operaciones de gestión de sucursales

Muestra los subprogramas para las operaciones de gestión de ramas del repositorio en el paquete DBMS_CLOUD_REPO.

Subprograma	Descripción
Procedimiento CREATE_BRANCH	Este procedimiento crea una rama en un repositorio de código en la nube identificado por el argumento de manejador `repo`.
Procedimiento DELETE_BRANCH	Este procedimiento suprime una rama en un repositorio de código en la nube identificado por el argumento de manejador `repo`.
Función LIST_BRANCHES	Esta función muestra todas las ramas del repositorio de código en la nube identificadas por el argumento de manejador `repo`.
Función LIST_COMMITS	Esta función muestra todas las confirmaciones de una rama del repositorio de código en la nube identificada por el argumento de manejador `repo`.
Procedimiento MERGE_BRANCH	Este procedimiento fusiona una rama del repositorio de código en la nube en otra rama especificada en un repositorio de código en la nube identificado por el argumento de manejador `repo`.

Operaciones de archivo DBMS_CLOUD_REPO

Muestra los subprogramas para las operaciones de archivo en el paquete DBMS_CLOUD_REPO.

Subprograma	Descripción
Procedimiento DELETE_FILE	Este procedimiento suprime un archivo del repositorio de código de nube identificado por el argumento de manejador `repo`.
Procedimiento y función GET_FILE	La función descarga el contenido de un archivo del repositorio de Cloud Code. El procedimiento permite descargar el contenido de un archivo del repositorio de Cloud Code y guardar el archivo en un directorio.
Función LIST_FILES	Esta función descarga un archivo del repositorio de Cloud Code. Opcionalmente, se puede acceder al contenido del archivo desde una rama, etiqueta o nombre de confirmación específicos. Por defecto, se accede al archivo desde la rama de repositorio por defecto.
Procedimiento PUT_FILE	Este procedimiento carga un archivo en el repositorio de código de nube identificado por el argumento de manejador `repo`. El procedimiento se sobrecarga para admitir la carga de un archivo desde un objeto de directorio o la carga del contenido de un CLOB en el archivo de repositorio.

Operaciones de instalación SQL de DBMS_CLOUD_REPO

Muestra los subprogramas de las operaciones de instalación de SQL en el paquete DBMS_CLOUD_REPO.

Subprograma	Descripción
Procedimiento EXPORT_OBJECT	Este procedimiento carga los metadatos DDL de un objeto de base de datos en el repositorio de código en la nube identificado por el argumento de manejador `repo`.
Procedimiento EXPORT_SCHEMA	Este procedimiento exporta metadatos de todos los objetos de un esquema a una rama del repositorio de código en la nube identificada por el argumento de manejador `repo`.
Procedimiento INSTALL_FILE	Este procedimiento instala sentencias SQL de un archivo en el repositorio de código en la nube identificado por el argumento de manejador `repo`.
Procedimiento INSTALL_SQL	Este procedimiento instala sentencias SQL de un buffer proporcionado como entrada.