Sobre o DBMS_CLOUD_REPO

O pacote DBMS_CLOUD_REPO fornece acesso fácil a arquivos em Repositórios de Código na Nuvem (Git), incluindo: GitHub, AWS CodeCommit e Azure Repos.

Esse pacote é uma interface única para acesso a repositórios de Código Multinuvem e permite fazer upload de arquivos SQL para repositórios Git ou instalar scripts SQL diretamente dos Repositórios de Código na Nuvem. Esse pacote também permite usar um Repositório de Código na Nuvem para gerenciar versões de código de scripts SQL e instalar ou corrigir com patch o código de aplicativo dos repositórios Git.

Conceitos

  • Sistema de Controle de Versão do Git: O Git é um software para rastrear alterações em qualquer conjunto de arquivos, geralmente usado para coordenar o trabalho entre os programadores, desenvolvendo colaborativamente o código-fonte durante o desenvolvimento do software. Suas metas incluem velocidade, integridade de dados e suporte para workflows distribuídos não lineares.

  • Repositório Git: É um armazenamento virtual do seu projeto. Ele permite salvar 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 de Repositório com Identificador de Repositório de Código na Nuvem Genérico

    • Inicializar um Repositório de Código GitHub

    • Inicializar um Repositório de Código AWS CodeCommit

    • Inicializar um Repositório de Código Azure Repos

  • 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 de Repositório

    • Faça upload de um arquivo do Oracle Database para o Repositório de Código.

    • Faça download de um arquivo do Repositório de Código para o Oracle Database.

    • Exclua arquivos do Repositório de Código.

    • Liste os arquivos do Repositório de Código.

  • Operações de Instalação SQL

    • Exporte DDL de metadados do objeto de Banco de Dados para o repositório.

    • Instale instruções SQL de um arquivo no Repositório de Código do Oracle Database.

    • Instale instruções SQL de um buffer.

Tópicos Relacionados

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

Um DBMS_CLOUD_REPO REPO é um objeto JSON opaco que representa um Repositório de Código na Nuvem de um provedor de nuvem específico. Um objeto REPO pode ser informado para diferentes APIs DBMS_CLOUD_REPO. Esse objeto opaco garante que os procedimentos e as funções DBMS_CLOUD_REPO sejam compatíveis com multinuvem; você não precisa alterar código algum ao migrar de um provedor de Repositório de Código na Nuvem para outro Repositório de Código na Nuvem.

Operações de Inicialização DBMS_CLOUD_REPO

Lista os subprogramas para operações de inicialização no 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

 Essa função inicializa um identificador de repositório GitHub e retorna um tipo opaco.

Função INIT_REPO

 Essa função inicializa um identificador de Repositório de Código na Nuvem 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

 Esse procedimento cria um Repositório de Código na Nuvem identificado pelo argumento de controle repo.

Procedimento DELETE_REPOSITORY

 Esse procedimento exclui o Repositório de Código na Nuvem identificado pelo argumento de controle repo.

Função LIST_REPOSITORIES

 Essa função lista todos os Repositórios de Código na Nuvem identificados pelo argumento de controle repo.

Procedimento UPDATE_REPOSITORY

 Esse procedimento atualiza um repositório de Código de Nuvem identificado pelo argumento de controle repo. O procedimento suporta a atualização do nome, da descrição ou do status de visibilidade privada, conforme suportado pelo repositório de Código de Nuvem.

DBMS_CLOUD_REPO Operações de Gerenciamento de Filiais do Repositório

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

Subprograma Descrição

Procedimento CREATE_BRANCH

 Esse procedimento cria uma ramificação em um Repositório de Código na Nuvem identificado pelo argumento de controle repo.

Procedimento DELETE_BRANCH

 Esse procedimento exclui uma ramificação em um Repositório de Código na Nuvem identificado pelo argumento de controle repo.

Função LIST_BRANCHES

 Essa função lista todas as ramificações do Repositório de Código da Nuvem identificadas pelo argumento de controle repo.

Função LIST_COMMITS

 Essa função lista todos os commits em uma ramificação do Repositório de Código da Nuvem identificada pelo argumento de controle repo.

Procedimento MERGE_BRANCH

 Esse procedimento mescla uma ramificação do Repositório de Código na Nuvem em outra ramificação especificada em um Repositório de Código na Nuvem identificado pelo argumento de controle repo.

Operações de Arquivo DBMS_CLOUD_REPO

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

Subprograma Descrição

Procedimento DELETE_FILE

 Esse procedimento exclui um arquivo do repositório de Código de Nuvem identificado pelo argumento de controle repo.

Procedimento e Função GET_FILE

 A função faz download do conteúdo de um arquivo do repositório de Código de Nuvem. O procedimento permite fazer download do conteúdo de um arquivo do repositório de Código de Nuvem e salvar o arquivo em um diretório.

Função LIST_FILES

 Essa função faz download de um arquivo do repositório de Código de Nuvem. Existe a opção de poder acessar o conteúdo do arquivo por um nome específico de ramificação, tag ou commit. Por padrão, o arquivo é acessado pela ramificação de repositório padrão.

Procedimento PUT_FILE

 Esse procedimento faz upload de um arquivo para o repositório de Código de Nuvem identificado pelo argumento de controle 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 do 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

 Esse procedimento faz upload dos metadados DDL de um objeto de banco de dados para o repositório de Código de Nuvem identificado pelo argumento de controle repo.

Procedimento EXPORT_SCHEMA

 Este procedimento exporta metadados de todos os objetos em um esquema para uma ramificação do Repositório de Código na Nuvem identificada pelo argumento de controle repo.

Procedimento INSTALL_FILE

 Esse procedimento instala instruções SQL de um arquivo no repositório de Código de Nuvem identificado pelo argumento de controle repo.

Procedimento INSTALL_SQL

 Esse procedimento instala instruções SQL de um buffer fornecido como entrada.