Über DBMS_CLOUD_REPO

Das Package DBMS_CLOUD_REPO bietet einfachen Zugriff auf Dateien in Cloud-Code-(Git-)Repositorys, einschließlich GitHub, AWS CodeCommit und Azure Repos.

Dieses Package ist eine einzelne Schnittstelle für den Zugriff auf Multicloud-Code-Repositorys und ermöglicht Ihnen, SQL-Dateien in Git-Repositorys hochzuladen oder SQL-Skripte direkt aus Cloud-Code-Repositorys zu installieren. Mit diesem Package können Sie außerdem mit einem Cloud-Code-Repository Codeversionen für SQL-Skripte verwalten und Anwendungscode aus Git-Repositorys installieren oder patchen.

Konzepte

  • Git-Versionskontrollsystem: Git ist eine Software zur Verfolgung von Änderungen in einem beliebigen Set von Dateien. In der Regel wird sie verwendet, um die Arbeit zwischen Programmierern zu koordinieren, die während der Softwareentwicklung gemeinsam Quellcode entwickeln. Ihre Ziele umfassen unter anderem Geschwindigkeit, Datenintegrität und Unterstützung für verteilte, nichtlineare Workflows.

  • Git-Repository: Ein Git-Repository ist ein virtueller Speicher Ihres Projekts. Damit können Sie Versionen Ihres Codes speichern, auf die Sie bei Bedarf zugreifen können.

Architektur

Das Package DBMS_CLOUD_REPO enthält vier Funktionsbereiche:
  • Repository-Initialisierung mit generischem Cloud-Code-Repository-Handle

    • GitHub-Code-Repository initialisieren

    • AWS CodeCommit-Code-Repository initialisieren

    • Azure Repos-Code-Repository initialisieren

  • Repository-Verwaltungsvorgänge

    • Repository erstellen

    • Repository aktualisieren

    • Repositorys auflisten

    • Repository löschen

  • Repository-Dateiverwaltungsvorgänge

    • Datei aus Oracle Database in das Code-Repository hochladen

    • Datei aus dem Code-Repository in Oracle Database herunterladen

    • Dateien aus dem Code-Repository löschen

    • Dateien aus dem Code-Repository auflisten

  • SQL-Installationsvorgänge

    • Datenbankobjekt-Metadaten-DDL in Repository exportieren
    • SQL-Anweisungen aus einer Datei im Code-Repository in Oracle Database installieren

    • SQL-Anweisungen aus einem Puffer installieren

DBMS_CLOUD_REPO - Datenstrukturen

Das Package DBMS_CLOUD_REPO definiert Datensatztypen und den generischen JSON-Objekttyp repo.

REPO-JSON-Objekt

Ein REPO-Objekt in DBMS_CLOUD_REPO ist ein nicht transparentes JSON-Objekt, das ein Cloud-Code-Repository eines bestimmten Cloud-Providers darstellt. Ein REPO-Objekt kann an verschiedene DBMS_CLOUD_REPO-APIs übergeben werden. Dieses nicht transparente Objekt stellt sicher, dass DBMS_CLOUD_REPO-Prozeduren und -Funktionen mit Multicloud-Computing kompatibel sind. Sie müssen keinen Code ändern, wenn Sie von einem Cloud-Code-Repository-Provider zu einem anderen Cloud-Code-Repository migrieren.

DBMS_CLOUD_REPO - Initialisierungsvorgänge

Listet die Unterprogramme für Initialisierungsvorgänge im Package DBMS_CLOUD_REPO auf.

Unterprogramm Beschreibung

Funktion INIT_AWS_REPO

Diese Funktion initialisiert ein Handle für ein AWS-Repository und gibt einen nicht transparenten Typ zurück.

Funktion INIT_AZURE_REPO

Diese Funktion initialisiert ein Handle für ein Azure-Repository und gibt einen nicht transparenten Typ zurück.

Funktion INIT_GITHUB_REPO

Diese Funktion initialisiert ein Handle für ein GitHub-Repository und gibt einen nicht transparenten Typ zurück.

Funktion INIT_REPO

Diese Funktion initialisiert ein Handle für ein Cloud-Code-Repository und gibt ein nicht transparentes JSON-Objekt zurück.

DBMS_CLOUD_REPO - Repository-Verwaltungsvorgänge

Zeigt die Unterprogramme für Repository-Verwaltungsvorgänge im Package DBMS_CLOUD_REPO an.

Unterprogramm Beschreibung

Prozedur CREATE_REPOSITORY

Diese Prozedur erstellt ein Cloud-Code-Repository, das mit dem Handle-Argument repo identifiziert wird.

Prozedur DELETE_REPOSITORY

Diese Prozedur löscht das Cloud-Code-Repository, das durch das Handle-Argument repo identifiziert wird.

Funktion LIST_REPOSITORIES

Diese Funktion listet alle Cloud-Code-Repositorys auf, die mit dem Handle-Argument repo identifiziert werden.

Prozedur UPDATE_REPOSITORY

Diese Prozedur aktualisiert ein Cloud-Code-Repository, das mit dem Handle-Argument repo identifiziert wird. Die Prozedur unterstützt die Aktualisierung des Namens, der Beschreibung oder des privaten Sichtbarkeitsstatus, wie vom Cloud-Code-Repository unterstützt.

DBMS_CLOUD_REPO Repository-Verzweigungsverwaltungsvorgänge

Listet die Unterprogramme für Repository-Verzweigungsverwaltungsvorgänge im Package DBMS_CLOUD_REPO auf.

Unterprogramm Beschreibung

Prozedur CREATE_BRANCH

Diese Prozedur erstellt eine Verzweigung in einem Cloud-Code-Repository, die durch das Handle-argument repo identifiziert wird.

Prozedur DELETE_BRANCH

Diese Prozedur löscht eine Verzweigung in einem Cloud-Code-Repository, die durch das Handle-argument repo identifiziert wird.

Funktion LIST_BRANCHES

Diese Funktion listet alle Cloud-Code-Repository-Verzweigungen auf, die durch das Handle-Argument repo identifiziert werden.

Funktion LIST_COMMITS

Diese Funktion listet alle Commits in einer Cloud-Code-Repository-Verzweigung auf, die durch das Handle-argument repo identifiziert wird.

Prozedur MERGE_BRANCH

Diese Prozedur führt eine Cloud-Code-Repository-Verzweigung in einer anderen angegebenen Verzweigung in einem Cloud-Code-Repository zusammen, die durch das Handle-Argument repo identifiziert wird.

DBMS_CLOUD_REPO - Dateivorgänge

Listet die Unterprogramme für Dateivorgänge im Package DBMS_CLOUD_REPO auf.

Unterprogramm Beschreibung

Prozedur DELETE_FILE

Diese Prozedur löscht eine Datei aus dem Cloud-Code-Repository, das durch das Handle-Argument repo identifiziert wird.

Prozedur und Funktion GET_FILE

Die Funktion lädt den Inhalt einer Datei aus dem Cloud-Code-Repository herunter. Mit dieser Prozedur können Sie den Inhalt einer Datei aus dem Cloud-Code-Repository herunterladen und die Datei in einem Verzeichnis speichern.

Funktion LIST_FILES

Diese Funktion lädt eine Datei aus dem Cloud-Code-Repository herunter. Auf den Dateiinhalt können Sie optional über eine bestimmte Verzweigung, ein bestimmtes Tag oder einen bestimmten Commit-Namen zugreifen. Standardmäßig wird über die Standard-Repository-Verzweigung auf die Datei zugegriffen.

Prozedur PUT_FILE

Diese Prozedur lädt eine Datei in das Cloud-Code-Repository hoch, das durch das Handle-Argument repo identifiziert wird. Die Prozedur wird überladen, um entweder das Hochladen einer Datei aus einem Verzeichnisobjekt oder das Hochladen des Inhalts aus einem CLOB in die Repository-Datei zu unterstützen.

DBMS_CLOUD_REPO - SQL-Installationsvorgänge

Listet die Unterprogramme für SQL-Installationsvorgänge im Package DBMS_CLOUD_REPO auf.

Unterprogramm Beschreibung

Prozedur EXPORT_OBJECT

Diese Prozedur lädt die DDL-Metadaten eines Datenbankobjekts in das Cloud-Code-Repository hoch, das durch das Handle-Argument repo identifiziert wird.

Prozedur EXPORT_SCHEMA

Diese Prozedur exportiert Metadaten aller Objekte in einem Schema in eine Cloud-Code-Repository-Verzweigung, die durch das Handle-Argument repo identifiziert wird.

Prozedur INSTALL_FILE

Diese Prozedur installiert SQL-Anweisungen aus einer Datei im Cloud-Code-Repository, das durch das Handle-Argument repo identifiziert wird.

Prozedur INSTALL_SQL

Diese Prozedur installiert SQL-Anweisungen aus einem als Eingabe angegebenen Puffer.