Sobre o DBMS_CLOUD_REPO

O pacote DBMS_CLOUD_REPO fornece acesso fácil a arquivos nos Repositórios do Cloud Code (Git), incluindo: GitHub, AWS CodeCommit e Azure Repos.

Este pacote é uma única interface para acesso a repositórios de Código Multicloud e permite que você faça upload de arquivos SQL para repositórios Git ou instale scripts SQL diretamente dos Repositórios de Código da Nuvem. Este pacote também permite que você use um Cloud Code Repository para gerenciar versões de código para scripts SQL e instalar ou aplicar patch ao código do aplicativo dos repositórios Git.

Conceitos

Sistema de Controle de Versão Git: Git é um software para rastrear alterações em qualquer conjunto de arquivos, geralmente usado para coordenar o trabalho entre programadores que desenvolvem de forma colaborativa o código-fonte durante o desenvolvimento do software. Seus objetivos incluem velocidade, integridade de dados e suporte para fluxos de trabalho distribuídos e não lineares.
Repositório Git: Um repositório Git é um armazenamento virtual do seu projeto. Ele permite que você salve versões do seu código, que você pode acessar quando necessário.

Arquitetura

O pacote DBMS_CLOUD_REPO fornece quatro áreas de recursos:

Inicialização do repositório com identificador genérico do repositório de código da nuvem
- Inicializar um Repositório de Código do GitHub
- Inicializar um repositório de código do AWS CodeCommit
- Inicializar um Repositório de Código de Repositório do Azure
Operações de Gerenciamento de Repositório
- Crie um repositório
- Atualizar um repositório
- Listar repositórios
- Excluir um repositório
Operações de Gerenciamento de Arquivos do Repositório
- Faça upload de um arquivo no Repositório de Código do Oracle Database.
- Faça download de um arquivo do Repositório de Código para o Oracle Database.
- Excluir arquivos do Repositório de Código.
- Listar arquivos do Repositório de Código.
Operações de Instalação SQL
- Exporte a DDL de metadados do objeto do Banco de Dados para o repositório.
- Instale instruções SQL de um arquivo no Repositório de Código no Oracle Database.
- Instale instruções SQL de um buffer.

Estruturas de Dados DBMS_CLOUD_REPO

O pacote DBMS_CLOUD_REPO define tipos de registro e um tipo de objeto JSON genérico repo.

Objeto JSON REPO

DBMS_CLOUD_REPO REPO é um objeto JSON opaco para representar um Repositório de Código da Nuvem de um provedor de nuvem específico. Um objeto REPO pode ser passado para diferentes APIs DBMS_CLOUD_REPO. Esse objeto opaco garante que os procedimentos e funções DBMS_CLOUD_REPO sejam compatíveis com várias nuvens; você não precisa alterar nenhum código ao migrar de um provedor do Cloud Code Repository para outro Cloud Code Repository.

Operações de Inicialização DBMS_CLOUD_REPO

Lista os subprogramas para operações de inicialização dentro do pacote DBMS_CLOUD_REPO.

Subprograma	Descrição
Função INIT_AWS_REPO	Essa função inicializa um identificador de repositório da AWS e retorna um tipo opaco.
Função INIT_AZURE_REPO	Essa função inicializa um identificador de repositório do Azure e retorna um tipo opaco.
Função INIT_GITHUB_REPO	Esta função inicializa um identificador de repositório GitHub e retorna um tipo opaco.
Função INIT_REPO	Essa função inicializa um handle do Cloud Code Repository e retorna um objeto JSON opaco.

Operações de Gerenciamento de Repositório DBMS_CLOUD_REPO

Mostra os subprogramas para operações de gerenciamento de repositório no pacote DBMS_CLOUD_REPO.

Subprograma	Descrição
Procedimento CREATE_REPOSITORY	Este procedimento cria um Cloud Code Repository identificado pelo argumento de manipulação `repo`.
Procedimento DELETE_REPOSITORY	Este procedimento exclui o Cloud Code Repository identificado pelo argumento de manipulação `repo`.
Função LIST_REPOSITORIES	Essa função lista todos os Repositórios de Código da Nuvem identificados pelo argumento de handle `repo`.
Procedimento UPDATE_REPOSITORY	Este procedimento atualiza um repositório do Cloud Code identificado pelo argumento de manipulação `repo`. O procedimento suporta a atualização do nome, da descrição ou do status de visibilidade privada, conforme suportado pelo repositório do Cloud Code.

Operações de Gerenciamento de Ramificação do Repositório DBMS_CLOUD_REPO

Lista os subprogramas para operações de gerenciamento de ramificações de repositório no pacote DBMS_CLOUD_REPO.

Subprograma	Descrição
Procedimento CREATE_BRANCH	Este procedimento cria uma ramificação em um Cloud Code Repository identificado pelo argumento de handle `repo`.
Procedimento DELETE_BRANCH	Este procedimento exclui uma ramificação em um Cloud Code Repository identificado pelo argumento de manipulação `repo`.
Função LIST_BRANCHES	Essa função lista todas as ramificações do Cloud Code Repository identificadas pelo argumento de manipulação `repo`.
Função LIST_COMMITS	Essa função lista todos os commits em uma ramificação do Cloud Code Repository identificada pelo argumento de manipulação `repo`.
Procedimento MERGE_BRANCH	Este procedimento mescla uma ramificação do Cloud Code Repository em outra ramificação especificada em um Cloud Code Repository identificado pelo argumento de manipulação `repo`.

Operações de Arquivo DBMS_CLOUD_REPO

Lista os subprogramas para operações de arquivo no pacote DBMS_CLOUD_REPO.

Subprograma	Descrição
Procedimento DELETE_FILE	Este procedimento exclui um arquivo do repositório do Cloud Code identificado pelo argumento de manipulação `repo`.
Procedimento e Função GET_FILE	A função faz download do conteúdo de um arquivo do repositório do Cloud Code. O procedimento permite que você faça download do conteúdo de um arquivo do repositório do Cloud Code e salve o arquivo em um diretório.
Função LIST_FILES	Esta função faz download de um arquivo do repositório do Cloud Code. Opcionalmente, o conteúdo do arquivo pode ser acessado de uma ramificação, tag ou nome de commit específico. Por padrão, o arquivo é acessado na ramificação do repositório padrão.
Procedimento PUT_FILE	Este procedimento faz upload de um arquivo para o repositório do Cloud Code identificado pelo argumento de manipulação `repo`. O procedimento é sobrecarregado para suportar o upload de um arquivo de um objeto de diretório ou o upload do conteúdo de um CLOB para o arquivo de repositório.

Operações de Instalação SQL DBMS_CLOUD_REPO

Lista os subprogramas para operações de instalação SQL dentro do pacote DBMS_CLOUD_REPO.

Subprograma	Descrição
Procedimento EXPORT_OBJECT	Este procedimento faz upload dos metadados DDL de um objeto de banco de dados para o repositório do Cloud Code identificado pelo argumento de manipulação `repo`.
Procedimento EXPORT_SCHEMA	Este procedimento exporta metadados de todos os objetos em um esquema para uma ramificação do Cloud Code Repository identificada pelo argumento de manipulação `repo`.
Procedimento INSTALL_FILE	Este procedimento instala instruções SQL de um arquivo no repositório do Cloud Code identificado pelo argumento de manipulação `repo`.
Procedimento INSTALL_SQL	Este procedimento instala instruções SQL de um buffer fornecido como entrada.