SQL Serverで記述されたSQL文をOracle SQLに変換し、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));

Autonomous DatabaseでSQL Server文を対話形式で変換および実行できます。

1. SQLクライアントを使用してAutonomous Databaseに接続します。

   詳細は、Autonomous Databaseへの接続を参照してください。

   ノート
   
   DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATIONは、データベース・アクションではサポートされておらず、Oracle APEX Serviceではサポートされていません。
2. DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATIONを実行して、セッションでリアルタイムSQL変換を有効にします。SQLSERVERパラメータを使用して、Microsoft SQL Serverから変換します。

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

   次の問合せを使用して、セッションのSQL翻訳言語を確認します。

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

   詳細は、ENABLE_TRANSLATIONプロシージャを参照してください。

3. SQL Server SQLステートメントを入力します。たとえば:

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

   これにより、SQL ServerのCREATE TABLE文が自動的に変換および実行されます。

   DESCコマンドを使用して確認できます。たとえば:

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

   MOVIE表が作成され、各列のデータ型がOracleデータ型に自動的に変換されます。
4. データをMOVIE表に挿入します。たとえば:

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

   MOVIE表を問い合せて、データの挿入を確認します。たとえば:

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

5. INVENTORY表を作成します。

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

   このステップは、DESCコマンドを使用して確認できます。たとえば:

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

   INVENTORY表が作成され、各列のデータ型がOracleデータ型に自動的に変換されます。
6. データをINVENTORY表に挿入します。たとえば:

   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.

   INVENTORYを問い合せて、データの挿入を確認します。たとえば:

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

7. 表MOVIEおよび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
   

   この例では、movie表およびinventory表でLEFT OUTER JOINを実行します。問合せは、最初にOracle SQLに変換されてから、セッションで実行されます。

8. DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATIONプロシージャを使用して、セッションのリアルタイムSQL言語変換を無効にします。

   BEGIN
    DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
   END;
   /

   SQL言語変換がセッションで有効になっていない場合は、エラーが返されます。

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

SQL Server文を含むファイルをOracle SQL文を含むファイルに移行できます。

1. Autonomous Databaseインスタンスに接続します。

   詳細は、Autonomous Databaseへの接続を参照してください。

2. リソース・プリンシパルを使用するか、資格証明オブジェクトを作成して、クラウド・オブジェクト・ストレージへのアクセスを構成します。

   このステップでは、移行するファイルを配置するクラウド・オブジェクト・ストレージにアクセスできます:

   • リソース・プリンシパルを使用したクラウド・オブジェクト・ストレージへのアクセス:

     リソース・プリンシパルを使用してOracle Cloud Infrastructure Object Storageにアクセスするためのポリシーおよびロールを定義します。詳細は、リソース・プリンシパルを使用したOracle Cloud InfrastructureリソースへのアクセスおよびDBMS_CLOUDでのリソース・プリンシパルの使用を参照してください。

     ファイルが別のベンダーのクラウド・オブジェクト・ストレージに存在する場合は、リソースにアクセスするための適切なポリシーおよびロールを定義します。詳細は、リソースにアクセスするためのポリシーとロールの構成を参照してください。

   • クラウドのオブジェクト・ストレージにアクセスするための資格証明を作成します:

     クラウド・オブジェクト・ストレージにアクセスするための資格証明を作成できます。

     たとえば:

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

     詳細は、CREATE_CREDENTIALプロシージャに関する項を参照してください。

3. オプションで、オブジェクト・ストレージ内のファイルをリストできます。たとえば:

   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
   

   または、リソース・プリンシパルOCI$RESOURCE_PRINCIPALのかわりに資格証明を作成する場合は、credential_nameパラメータに資格証明名を指定します。

   詳細は、LIST_OBJECTSファンクションを参照してください。

4. DBMS_CLOUD_MIGRATION.MIGRATE_FILEを実行して、SQL Serverファイルを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;
   /

   credential_nameパラメータは、クラウドのオブジェクト・ストレージURIにアクセスするための資格証明を指定します。DBMS_CLOUD_MIGRATION.MIGRATE_FILEを実行するユーザーには、オブジェクト・ストレージURIへのアクセスに使用される資格証明オブジェクトに対するEXECUTE権限が必要です。つまり、credential_nameパラメータで指定する資格証明です。リソース・プリンシパルのかわりに資格証明を使用する場合は、credential_nameパラメータで資格証明名を指定します。

   location_uriパラメータは、ソース・ファイルURIを指定します。URIの形式は、使用しているCloud Object Storageサービスによって異なります。詳細は、DBMS_CLOUD URI Formatsを参照してください。

   source_dbパラメータは、データベース言語としてSQL Serverを指定します。値SQLSERVERを使用して、SQL ServerファイルをOracle SQLに変換します。

   このコマンドを実行すると、SQL Serverファイルmssqltest.sqlがOracle SQLに変換され、original_filename_oracle.sqlという名前の新しいファイルが生成されます。

   この例では、入力ファイルmssqltest.sqlでDBMS_CLOUD_MIGRATION.MIGRATE_FILEを実行すると、mssqltest_oracle.sqlが生成されます。変換ステップの後、プロシージャはmssqltest_oracle.sqlをオブジェクト・ストレージにアップロードします。

   オプションで、target_uriパラメータを使用して、翻訳済ファイルがアップロードされる場所を指定します。このパラメータのデフォルト値はNULLです。つまり、変換されたファイルは、location_uriパラメータで指定された場所と同じ場所にアップロードされます。

   詳細は、MIGRATE_FILEプロシージャを参照してください。

5. 出力ファイルが生成されたことを確認します。

   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
   

   または、リソース・プリンシパルOCI$RESOURCE_PRINCIPALのかわりに資格証明を作成する場合は、credential_nameパラメータに資格証明名を指定します。

   詳細は、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;

この項では、SQL文をSQL ServerからOracle SQLに移行する際の制限事項について説明します。