Informazioni su DBMS_CLOUD_REPO

Il pacchetto DBMS_CLOUD_REPO fornisce un facile accesso ai file nei repository Cloud Code (Git), tra cui: GitHub, AWS CodeCommit e Azure Repos.

Questo pacchetto è una singola interfaccia per l'accesso ai repository di codici multicloud e consente di caricare file SQL nei repository Git o installare script SQL direttamente dai repository di codici cloud. Questo pacchetto consente inoltre di utilizzare un repository di codici cloud per gestire le versioni di codice per gli script SQL e per installare o applicare patch al codice dell'applicazione dai repository Git.

Nozioni fondamentali

  • Git Version Control System: Git è un software per tenere traccia delle modifiche in qualsiasi set di file, di solito utilizzato per coordinare il lavoro tra i programmatori che sviluppano in modo collaborativo il codice sorgente durante lo sviluppo del software. I suoi obiettivi includono velocità, integrità dei dati e supporto per flussi di lavoro distribuiti e non lineari.

  • Repository Git: un repository Git è una memorizzazione virtuale del progetto. Ti permette di salvare le versioni del tuo codice, a cui puoi accedere quando necessario.

Architettura

Il pacchetto DBMS_CLOUD_REPO include quattro aree di funzioni:
  • Inizializzazione del repository con gestione del repository di codici cloud generico

    • Inizializza un repository di codici GitHub

    • Inizializza un repository di codici AWS CodeCommit

    • Inizializza un repository di codici repository di Azure

  • Operazioni di gestione del repository

    • Creare un repository

    • Aggiornare un repository

    • Elenca i repository

    • Eliminare un repository

  • Operazioni di gestione file repository

    • Caricare un file nel repository di codici da Oracle Database.

    • Scaricare un file dal repository di codici in Oracle Database.

    • Elimina i file dal repository di codici.

    • Elenca i file dal repository di codici.

  • Operazioni di installazione SQL

    • Esporta DDL metadati oggetto database nel repository.
    • Installare le istruzioni SQL da un file nel repository di codici in Oracle Database.

    • Installare le istruzioni SQL da un buffer.

DBMS_CLOUD_REPO Strutture dati

Il package DBMS_CLOUD_REPO definisce i tipi di record e un tipo di oggetto JSON generico repo.

Oggetto JSON REPO

Un oggetto DBMS_CLOUD_REPO REPO è un oggetto JSON opaco che rappresenta un Cloud Code Repository di un provider cloud specifico. Un oggetto REPO può essere passato a interfacce API DBMS_CLOUD_REPO diverse. Questo oggetto opaco garantisce che le procedure e le funzioni di DBMS_CLOUD_REPO siano compatibili con il multicloud; non è necessario modificare alcun codice quando si esegue la migrazione da un provider di Cloud Code Repository a un altro Cloud Code Repository.

DBMS_CLOUD_REPO Operazioni di inizializzazione

Elenca i sottoprogrammi per le operazioni di inizializzazione all'interno del pacchetto DBMS_CLOUD_REPO.

Sottoprogramma Descrizione

Funzione INIT_AWS_REPO

Questa funzione inizializza un handle di repository AWS e restituisce un tipo opaco.

Funzione INIT_AZURE_REPO

Questa funzione inizializza un handle del repository di Azure e restituisce un tipo opaco.

Funzione INIT_GITHUB_REPO

Questa funzione inizializza un handle di repository GitHub e restituisce un tipo opaco.

Funzione INIT_REPO

Questa funzione inizializza un handle del repository di codici cloud e restituisce un oggetto JSON opaco.

DBMS_CLOUD_REPO Operazioni di gestione del repository

Mostra i sottoprogrammi per le operazioni di gestione del repository all'interno del pacchetto DBMS_CLOUD_REPO.

Sottoprogramma Descrizione

CREATE_REPOSITORY Procedura

Questa procedura crea un repository di codici cloud identificato dall'argomento handle repo.

DELETE_REPOSITORY Procedura

Questa procedura elimina il repository di codici cloud identificato dall'argomento handle repo.

Funzione LIST_REPOSITORIES

Questa funzione elenca tutti i repository di codici cloud identificati dall'argomento di gestione repo.

UPDATE_REPOSITORY Procedura

Questa procedura aggiorna un repository di codici cloud identificato dall'argomento handle repo. La procedura supporta l'aggiornamento del nome, della descrizione o dello stato di visibilità privata, come supportato dal repository Cloud Code.

DBMS_CLOUD_REPO Operazioni di gestione delle diramazioni del repository

Elenca i sottoprogrammi per le operazioni di gestione delle diramazioni del repository all'interno del pacchetto DBMS_CLOUD_REPO.

Sottoprogramma Descrizione

CREATE_BRANCH Procedura

Questa procedura crea una diramazione in un repository di codici cloud identificato dall'argomento handle repo.

DELETE_BRANCH Procedura

Questa procedura elimina una diramazione in un repository di codici cloud identificato dall'argomento handle repo.

Funzione LIST_BRANCHES

Questa funzione elenca tutte le diramazioni del repository di codici cloud identificate dall'argomento handle repo.

Funzione LIST_COMMITS

Questa funzione elenca tutti i commit in una diramazione del repository di codici cloud identificata dall'argomento handle repo.

MERGE_BRANCH Procedura

Questa procedura unisce una diramazione del repository di codici cloud in un'altra diramazione specificata in un repository di codici cloud identificato dall'argomento handle repo.

Operazioni file DBMS_CLOUD_REPO

Elenca i sottoprogrammi per le operazioni sui file nel pacchetto DBMS_CLOUD_REPO.

Sottoprogramma Descrizione

DELETE_FILE Procedura

Questa procedura elimina un file dal repository di codici cloud identificato dall'argomento handle repo.

GET_FILE Procedura e funzione

La funzione scarica il contenuto di un file dal repository Cloud Code. La procedura consente di scaricare il contenuto di un file dal repository Cloud Code e di salvare il file in una directory.

Funzione LIST_FILES

Questa funzione scarica un file dal repository Cloud Code. Facoltativamente, è possibile accedere al contenuto del file da una diramazione, un tag o un nome di commit specifici. Per impostazione predefinita, l'accesso al file viene eseguito dalla diramazione del repository predefinita.

PUT_FILE Procedura

Questa procedura carica un file nel repository di codici cloud identificato dall'argomento handle repo. La procedura è sovraccarica per supportare il caricamento di un file da un oggetto directory o il caricamento del contenuto da un oggetto CLOB nel file del repository.

DBMS_CLOUD_REPO Operazioni di installazione SQL

Elenca i sottoprogrammi per le operazioni di installazione SQL nel package DBMS_CLOUD_REPO.

Sottoprogramma Descrizione

EXPORT_OBJECT Procedura

Questa procedura carica i metadati DDL di un oggetto di database nel repository di codici cloud identificato dall'argomento handle repo.

EXPORT_SCHEMA Procedura

Questa procedura esporta i metadati di tutti gli oggetti in uno schema in una diramazione del repository di codici cloud identificata dall'argomento handle repo.

INSTALL_FILE Procedura

Questa procedura installa le istruzioni SQL da un file nel repository Cloud Code identificato dall'argomento handle repo.

INSTALL_SQL Procedura

Questa procedura installa le istruzioni SQL da un buffer fornito come input.