Gérer et stocker des fichiers dans un référentiel de code en nuage avec Autonomous AI Database

L'ensemble DBMS_CLOUD_REPO fournit une interface unique pour accéder à un référentiel de code en nuage à partir d'une base de données d'IA autonome.

Les sous-programmes d'initialisation DBMS_CLOUD_REPO initialisent un référentiel de code en nuage. Une fois que vous avez obtenu un descripteur Cloud Code Repository, vous l'utilisez pour accéder au référentiel Cloud Code.

1. Créez des données d'identification pour accéder au référentiel de code en nuage.

   Voir Procédure CREATE_CREDENTIAL pour plus d'informations sur la création de données d'identification.

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 Cloud Code pris en charge.

   • Initialisation GitHub :

     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 des référentiels 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 d'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 sous-programmes de gestion DBMS_CLOUD_REPO vous permettent de gérer un référentiel de code en nuage en créant, répertoriant, mettant à jour ou supprimant un référentiel.

1. Pour créer un référentiel :

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

2. Pour mettre à jour un référentiel :

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

3. Pour lister les référentiels :

   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 :

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

Les sous-programmes de gestion DBMS_CLOUD_REPO vous permettent de gérer les branches du référentiel Cloud Code en créant, listant, fusionnant ou supprimant des branches dans un référentiel.

1. Pour créer une branche dans un référentiel Cloud Code :

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

2. Pour supprimer une branche dans un référentiel de code en nuage :

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

3. Pour fusionner une branche dans une autre branche d'un référentiel Cloud Code :

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

4. Pour lister les branches d'un référentiel Cloud Code :

   
   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 en nuage en fonction des éléments suivants :

   • référentiel

   • Branche

   • Chemin d'accès au fichier de la branche

   • SHA/commit_id

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

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

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

   Pour lister les validations basées sur le référentiel, commit_id et le chemin d'accès au fichier de la branche :

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

   Pour lister les validations en fonction du référentiel et du chemin d'accès au fichier de la branche :

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

   Pour lister les validations basées sur le référentiel, branch_name et le chemin d'accès au fichier de la branche :

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

   Pour lister les validations basées sur le référentiel et commit_id de la branche :

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

Le sous-programme de gestion DBMS_CLOUD_REPO vous permet d'exporter les métadonnées des objets d'un schéma vers la branche Référentiel de code en nuage. 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 lister, de mettre à jour ou de supprimer des fichiers dans un référentiel de code en nuage.

1. Pour obtenir un fichier :

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

2. Pour créer 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 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 lister les fichiers :

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

5. Pour supprimer un fichier :

   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 en nuage.

1. Pour charger des métadonnées LDD dans un référentiel de code en nuage :

   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'une mémoire tampon :

   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;
   /