Gestion et stockage de fichiers dans un référentiel de code cloud avec Autonomous Database

Le package DBMS_CLOUD_REPO fournit une interface unique pour accéder à un référentiel de code cloud à partir d'Autonomous Database.

Les routines d'initialisation DBMS_CLOUD_REPO initialisent un référentiel de code cloud. Après avoir obtenu un descripteur de référentiel de code cloud, vous l'utilisez pour accéder au référentiel de code cloud.

1. Créez des informations d'identification pour accéder au référentiel de code cloud.

   Pour plus d'informations sur la création d'informations d'identification, reportez-vous à Procédure CREATE_CREDENTIAL.

2. Selon le référentiel, GitHub, Azure Repos ou AWS CodeCommit, appelez DBMS_CLOUD_REPO.INIT_REPO avec les paramètres du référentiel particulier pour obtenir un descripteur de référentiel.

   Les exemples suivants fournissent des exemples pour chaque référentiel de code cloud pris en charge.

   • GitHub Initialisation :

     DEFINE repo_name='test_repo';
     DEFINE cred_name='GITHUB_CRED';
     VAR repo clob
     BEGIN
       :repo := DBMS_CLOUD_REPO.INIT_REPO(
                     params => JSON_OBJECT('provider' value 'github',
                                           'repo_name' value '&repo_name',
                                           'credential_name' value '&cred_name',
                                           'owner'           value '<myuser>')
               );
     END;
     /
     

   • Initialisation du référentiel Azure :

     DEFINE repo_name='test_repo';
     DEFINE cred_name='AZURE_REPO_CRED';
     VAR repo clob
     BEGIN
       :repo := DBMS_CLOUD_REPO.INIT_REPO(
                     params => JSON_OBJECT('provider' value 'azure',
                                           'repo_name' value '&repo_name',
                                           'credential_name' value '&cred_name',
                                           'organization' value '<myorg>',
                                           'project' value '<myproject>')
               );
     END;
     /

   • Initialisation AWS CodeCommit :

     DEFINE repo_name='test_repo';
     DEFINE cred_name='AWS_REPO_CRED';
     VAR repo clob
     BEGIN
       :repo := DBMS_CLOUD_REPO.INIT_REPO(
                     params => JSON_OBJECT('provider' value 'aws',
                                           'repo_name' value '&repo_name',
                                           'credential_name' value '&cred_name',
                                           'region' value 'us-east-1')
               );
     END;
     /

Les routines de gestion DBMS_CLOUD_REPO vous permettent de gérer un référentiel de code cloud en créant, répertoriant, mettant à jour ou supprimant un référentiel.

1. Pour créer un référentiel, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.CREATE_REPOSITORY(
           repo => :repo,
           description => 'test repo'
     );
   END;
   /

2. Pour mettre à jour un référentiel, procédez comme suit :

   
   VAR repo clob
   DEFINE repo_name='test_repo';
   BEGIN
     DBMS_CLOUD_REPO.UPDATE_REPOSITORY(
           repo => :repo,
           new_name => '&repo_name' || '_new'
     );
   END;
   /

3. Pour répertorier les référentiels, procédez comme suit :

   col id format a30
   col name format a10
   col description format a15
   select id, name, bytes, private, description from
     DBMS_CLOUD_REPO.LIST_REPOSITORIES(:repo);
   

4. Pour supprimer un référentiel, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.DELETE_REPOSITORY(
           repo => :repo
     );
   END;
   /

Les routines de gestion DBMS_CLOUD_REPO vous permettent de gérer les branches du référentiel de code cloud en créant, répertoriant, fusionnant ou supprimant des branches dans un référentiel.

1. Pour créer une branche dans un référentiel de code cloud :

   BEGIN
     DBMS_CLOUD_REPO.CREATE_BRANCH (
       repo            => l_repo,
       branch_name     => 'test_branch',
       parent_branch   => 'main'
       );
   END;
   /

2. Pour supprimer une branche d'un référentiel de code cloud :

   BEGIN
     DBMS_CLOUD_REPO.DELETE_BRANCH (
         repo        => l_repo,
         branch_name => 'test_branch'
     );
   END;
   /

3. Pour fusionner un branchement dans un autre branchement d'un référentiel de code cloud :

   BEGIN
     DBMS_CLOUD_REPO.MERGE_BRANCH (
       repo               => l_repo,
       branch_name        => 'test_branch',
       target_branch_name => 'main'
       );
   END;
   /

4. Pour répertorier les branches dans un référentiel de code cloud, procédez comme suit :

   
   SELECT * FROM DBMS_CLOUD_REPO.LIST_BRANCHES (repo => l_repo);
   

5. Vous pouvez répertorier les validations dans une branche du référentiel de code cloud en fonction des éléments suivants :

   • Référentiel

   • Agence

   • Chemin d'accès du branchement

   • SHA/commit_id

     Remarque
     
     SHA est une chaîne de somme de contrôle de 40 caractères composée de caractères hexadécimaux (0–9 et a–f).

   Pour répertorier les validations basées sur le référentiel :

   SELECT * FROM DBMS_CLOUD_REPO.LIST_COMMITS (
       repo => :repo);

   Pour répertorier les validations basées sur le référentiel, commit_id et le chemin de fichier du branchement :

   SELECT * FROM DBMS_CLOUD_REPO.LIST_COMMITS (
       repo        => l_repo,
       commit_id   => '66dd2b23b74cd0afabd11af66c6aa9c550540ba6',
       file_path   => 'sub_dir/test11.sql'

   Pour répertorier les validations basées sur le référentiel et le chemin d'accès du branchement, procédez comme suit :

   SELECT * FROM DBMS_CLOUD_REPO.LIST_COMMITS (
       repo        => :repo, 
       branch_name => 'branch1');

   Pour répertorier les validations basées sur le référentiel, branch_name et le chemin de fichier du branchement :

   SELECT * FROM DBMS_CLOUD_REPO.LIST_COMMITS (
       repo         => :repo, 
       branch_name  => 'branch1',
       file_path    => 'sub_dir/test11.sql');

   Pour répertorier les validations basées sur le référentiel et commit_id du branchement, procédez comme suit :

   SELECT * FROM DBMS_CLOUD_REPO.LIST_COMMITS (
       repo => :repo,
       commit_id =>'66dd2b23b74cd0afabd11af66c6aa9c550540ba6');

La routine de gestion DBMS_CLOUD_REPO vous permet d'exporter les métadonnées des objets d'un schéma vers la branche Cloud Code Repository. Vous pouvez filtrer votre liste en fonction des noms d'objet ou des types d'objet.

BEGIN
  DBMS_CLOUD_REPO.EXPORT_SCHEMA(
    repo          => l_repo,
    schema_name   => 'USER1',
    file_path     => 'myschema_ddl.sql'
    filter_list   =>
        to_clob('[    
             { "match_type":"equal",
                 "type":"table"
             },
             { "match_type":"not_equal",
                 "type":"view"
             },
             { "match_type":"in",
                 "type":"table",
                 "name": " ''EMPLOYEE_SALARY'',''EMPLOYEE_ADDRESS'' "
             },
             { "match_type":"equal",
                 "type":"sequence",
                 "name": "EMPLOYEE_RECORD_SEQ"
             },
             { "match_type":"like",
                 "type":"table",
                 "name": "%OFFICE%"
             }    
        ]'
     );
  );
END;
/

Les opérations de fichier DBMS_CLOUD_REPO vous permettent de créer, d'obtenir, de répertorier, de mettre à jour ou de supprimer des fichiers dans un référentiel de code cloud.

1. Pour obtenir un fichier :

   
   SELECT DBMS_CLOUD_REPO.GET_FILE(repo => :repo, file_path => 'test1.sql')
   

2. Pour créer un fichier, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.PUT_FILE(
           repo => :repo,
           file_path => 'test1.sql',
           contents => UTL_RAW.cast_to_raw('create table t1 (x varchar2(30))' || CHR(10) || '/')
     );
   END;
   /

3. Pour mettre à jour un fichier :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.PUT_FILE(
           repo => :repo,
           file_path => 'test1.sql',
           contents => UTL_RAW.cast_to_raw('create table t2 (x varchar2(30))' || CHR(10) || '/')
     );
   END;
   /

4. Pour répertorier les fichiers :

   SELECT id, name, bytes, url FROM DBMS_CLOUD_REPO.LIST_FILES(repo => :repo);
   

5. Pour supprimer un fichier, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.DELETE_FILE(
           repo => :repo,
           file_path => 'test1.sql'
     );
   END;
   /

Les opérations d'installation SQL DBMS_CLOUD_REPO vous permettent de stocker et de télécharger des scripts SQL à partir d'un référentiel de code cloud.

1. Pour télécharger des métadonnées LDD vers un référentiel de code cloud, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.EXPORT_OBJECT(
           repo => :repo,
           object_type => 'PACKAGE',
           object_name => 'MYPACK',
           file_path   => 'mypack.sql'
     );
   END;
   /

2. Pour installer des instructions SQL à partir d'un fichier :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.INSTALL_FILE(
           repo => :repo,
           file_path     => 'test3.sql',
           stop_on_error => FALSE
     );
   END;
   /

3. Pour installer des instructions SQL à partir d'un tampon, procédez comme suit :

   VAR repo clob
   BEGIN
     DBMS_CLOUD_REPO.INSTALL_SQL(
           repo => :repo,
           content   => 'create table t1 (x varchar2(30))' || CHR(10) || '/',
           stop_on_error => FALSE
     );
   END;
   /