Migrer des applications des bases de données SQL Server vers Autonomous Database

Vous pouvez convertir les instructions SQL écrites dans SQL Server en instructions Oracle SQL et les exécuter sur Autonomous Database.

SET SERVEROUTPUT ON
   declare output_sql_result CLOB;
BEGIN
  DBMS_CLOUD_MIGRATION.MIGRATE_SQL(      
    original_sql => 'CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));',
    output_sql   => output_sql_result,
    source_db    => 'SQLSERVER');
    DBMS_OUTPUT.PUT_LINE (output_sql_result);
END;        
/

Output
–-------------------------------------------------------------
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));

SELECT DBMS_CLOUD_MIGRATION.MIGRATE_SQL(
     'CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));','SQLSERVER') AS OUTPUT 
     FROM DUAL;

OUTPUT
------------------------------------------------------------------------------
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));

Vous pouvez traduire et exécuter des instructions SQL Server de manière interactive dans votre instance Autonomous Database.

1. Connexion à votre instance Autonomous Database à l'aide d'un client SQL.

   Pour plus d'informations, reportez-vous à Connexion à Autonomous Database.

   Remarque
   
   DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION n'est pas pris en charge dans Database Actions et n'est pas pris en charge avec le service Oracle APEX.
2. Exécutez DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION pour activer la conversion SQL en temps réel dans votre session. Utilisez le paramètre SQLSERVER pour convertir à partir de Microsoft SQL Server.

   BEGIN
    DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION('SQLSERVER');
   END;
   /

   Utilisez la requête suivante pour vérifier le langage de traduction SQL de votre session :

   SELECT SYS_CONTEXT('USERENV','SQL_TRANSLATION_PROFILE_NAME') FROM DUAL;

   Pour plus d'informations, reportez-vous à Procédure ENABLE_TRANSLATION.

3. Entrez des instructions SQL SQL Server. Par exemple :

   CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));
   
   Table [dbo].[movie] created.

   Cette opération traduit et exécute automatiquement l'instruction SQL Server CREATE TABLE.

   Vous pouvez effectuer la vérification à l'aide de la commande DESC. Par exemple :

   DESC movie;
   
   Name        Null?     Type          
   -------     -----     ------------- 
   FILM_ID               NUMBER(38)    
   TITLE                 VARCHAR2(255)

   La table MOVIE est créée et les types de données de chacune des colonnes sont automatiquement convertis en types de données Oracle.
4. Insérez des données dans la table MOVIE. Par exemple :

   INSERT INTO movie([film_id], [title]) VALUES (123, 'Tangled');
   
   1 row inserted.
   
   INSERT INTO movie([film_id], [title]) VALUES (234, 'Frozen');
   
   1 row inserted.

   Vérifiez l'insertion des données en interrogeant la table MOVIE. Par exemple :

   SELECT * FROM movie;
   
   FILM_ID  TITLE
   –------- –--------
   123	 Tangled
   234	 Frozen
   

5. Créez une table INVENTORY :

   CREATE TABLE [dbo].[inventory] ([film_id] [int], [title] [inventory_id](20));
   
   
   Table INVENTORY created.

   Vous pouvez vérifier cette étape à l'aide de la commande DESC. Par exemple :

   DESC inventory;
   
   Name        Null?     Type          
   -------     -----     ------------- 
   FILM_ID               NUMBER(38)    
   INVENTORY_ID          NUMBER(38)

   La table INVENTORY est créée et les types de données de chacune des colonnes sont automatiquement convertis en types de données Oracle.
6. Insérez des données dans la table INVENTORY. Par exemple :

   INSERT INTO inventory([film_id], [inventory_id]) VALUES (123, 223);
   
   1 row inserted.
   
   INSERT INTO inventory(film_id, inventory_id) VALUES (234, 334);
   
   1 row inserted.

   Vérifiez l'insertion des données en interrogeant INVENTORY. Par exemple :

   SELECT * FROM inventory;
   
   FILM_ID  INVENTORY_ID
   –------- –------------
   123	 223
   234	 334

7. Effectuez une jointure externe gauche sur les tables MOVIE et INVENTORY :

   SELECT m.film_id, m.title, inventory.inventory_id 
       FROM movie AS m LEFT JOIN inventory 
       ON inventory.film_id = m.film_id;
   
     FILM_ID  TITLE       INVENTORY_ID
   ---------- ---------- ------------
          234 Frozen      334
          123 Tangled     223
   

   Cet exemple effectue une opération LEFT OUTER JOIN sur les tables movie et inventory. La requête est d'abord convertie en code SQL Oracle, puis exécutée dans votre session.

8. Utilisez la procédure DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION pour désactiver la traduction SQL en temps réel pour votre session.

   BEGIN
    DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
   END;
   /

   Une erreur est renvoyée si la traduction SQL n'est pas activée pour votre session.

   Reportez-vous à Procédure DISABLE_TRANSLATION

SELECT v.* 
    FROM v$mapped_sql v, dba_objects o
    WHERE v.sql_translation_profile_id = o.object_id
        AND o.object_name = 'SQLSERVER'
        AND o.object_type = 'TRANSLATION PROFILE';

Vous pouvez migrer un fichier contenant des instructions SQL Server vers un fichier contenant des instructions Oracle SQL.

1. Connectez-vous à votre instance Autonomous Database.

   Pour plus d'informations, reportez-vous à Connexion à Autonomous Database.

2. Configurez l'accès à Cloud Object Storage à l'aide d'un principal de ressource ou en créant un objet d'informations d'identification.

   Cette étape permet d'accéder au stockage d'objets cloud dans lequel vous placez les fichiers que vous migrez :

   • Utilisez un principal de ressource pour accéder à Cloud Object Storage :

     Définir des stratégies et des rôles pour accéder à Oracle Cloud Infrastructure Object Storage avec un principal de ressource. Pour plus d'informations, reportez-vous à Utilisation du principal d'une ressource pour accéder aux ressourcesOracle Cloud Infrastructure et à Utilisation du principal d'une ressource avec DBMS_CLOUD.

     Si vos fichiers résident dans le stockage d'objets cloud d'un autre fournisseur, définissez les stratégies et les rôles appropriés pour accéder à la ressource. Pour plus d'informations, reportez-vous à Configuration de stratégies et de rôles pour accéder aux ressources.

   • Créez des informations d'identification pour accéder au stockage d'objet cloud :

     Vous pouvez créer des informations d'identification pour accéder à Cloud Object Storage.

     Par exemple :

     BEGIN
       DBMS_CLOUD.CREATE_CREDENTIAL (
         credential_name => 'OBJ_STORE_CRED',
         username        => 'user1@example.com',
         password        => 'password'
       );
     END;
     /
     

     Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL.

3. Vous pouvez éventuellement répertorier les fichiers dans Object Storage. Par exemple :

   VAR function_list CLOB;
   SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS
      (credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
   
   OBJECT_NAME
   ---------------------
   mssqltest.sql
   

   Si vous créez des informations d'identification au lieu du principal de ressource, OCI$RESOURCE_PRINCIPAL, indiquez le nom des informations d'identification dans le paramètre credential_name.

   Pour plus d'informations, reportez-vous à Fonction LIST_OBJECTS.

4. Exécutez DBMS_CLOUD_MIGRATION.MIGRATE_FILE pour migrer le fichier SQL Server vers Oracle SQL :

   BEGIN
    DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
        credential_name => 'OCI$RESOURCE_PRINCIPAL',
        location_uri    => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files/mssqltest.sql',
        source_db       => 'SQLSERVER'
       );
   END;
   /

   Le paramètre credential_name indique les informations d'identification permettant d'accéder à l'URI de stockage d'objet cloud. L'utilisateur qui exécute DBMS_CLOUD_MIGRATION.MIGRATE_FILE doit disposer du privilège EXECUTE pour l'objet d'informations d'identification utilisé pour accéder à l'URI Object Storage. Autrement dit, informations d'identification que vous indiquez avec le paramètre credential_name. Si vous utilisez des informations d'identification au lieu d'un principal de ressource, indiquez le nom des informations d'identification dans le paramètre credential_name.

   Le paramètre location_uri indique l'URI du fichier source. Le format de l'URI dépend du service Cloud Object Storage que vous utilisez. Pour plus d'informations, reportez-vous à la section DBMS_CLOUD URI Formats.

   Le paramètre source_db indique SQL Server comme langage de base de données. Utilisez la valeur SQLSERVER pour convertir les fichiers SQL Server en fichiers Oracle SQL.

   L'exécution de cette commande convertit le fichier SQL Server mssqltest.sql en fichier Oracle SQL et génère un nouveau fichier nommé original_filename_oracle.sql.

   Pour cet exemple, l'exécution de DBMS_CLOUD_MIGRATION.MIGRATE_FILE avec le fichier d'entrée mssqltest.sql génère mssqltest_oracle.sql. Après l'étape de traduction, la procédure télécharge mssqltest_oracle.sql vers Object Storage.

   Vous pouvez éventuellement utiliser le paramètre target_uri pour indiquer l'emplacement de téléchargement du fichier traduit. La valeur par défaut de ce paramètre est NULL, ce qui signifie que le fichier traduit est téléchargé vers le même emplacement que celui indiqué dans le paramètre location_uri.

   Pour plus d'informations, reportez-vous à Procédure MIGRATE_FILE.

5. Vérifiez que le fichier de sortie a été généré.

   SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS (
       credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
   
   OBJECT_NAME
   ---------------------
   mssqltest.sql
   mssqltest_oracle.sql
   

   Si vous créez des informations d'identification au lieu du principal de ressource, OCI$RESOURCE_PRINCIPAL, indiquez le nom des informations d'identification dans le paramètre credential_name.

   Pour plus d'informations, reportez-vous à Fonction LIST_OBJECTS.

SELECT UTL_RAW.CAST_TO_VARCHAR2 (DBMS_CLOUD.GET_OBJECT(
   credential_name => 'OCI$RESOURCE_PRINCIPAL', 
   object_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files')) 
FROM dual;

UTL_RAW.CAST_TO_VARCHAR2(DBMS_CLOUD.GET_OBJECT(CREDENTIAL_NAME=>'CRED1',OBJECT_U
--------------------------------------------------------------------------------
DROP TABLE movie;
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));
 
INSERT INTO movie (film_id, title) VALUES (123, 'Tangled');
INSERT INTO movie (film_id, title) VALUES (234, 'Frozen');
 
CREATE TABLE inventory(film_id NUMBER(10), inventory_id NUMBER(10));
INSERT INTO inventory(film_id, inventory_id) VALUES (123, 223);
INSERT INTO inventory(film_id, inventory_id) VALUES (234, 334);
 
SELECT * FROM movie;
SELECT * FROM inventory;
SELECT m.film_id, m.title, inventory_id FROM movie m LEFT JOIN inventory ON inventory.film_id = m.film_id;

Cette section récapitule les limites de migration des instructions SQL de SQL Server vers Oracle SQL.