Sie können in SQL Server geschriebene SQL-Anweisungen in Oracle SQL übersetzen und die übersetzten Anweisungen in Autonomous Database ausführen.

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

Sie können SQL Server-Anweisungen interaktiv in Autonomous Database übersetzen und ausführen.

1. Stellen Sie mit einem SQL-Client eine Verbindung zu Autonomous Database her.

   Weitere Informationen finden Sie unter Verbindung zu Autonomous Database herstellen.

   Hinweis
   
   DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION wird in Database Actions nicht unterstützt und wird nicht mit dem Oracle APEX-Service unterstützt.
2. Führen Sie DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION aus, um die SQL-Übersetzung in Echtzeit in Ihrer Session zu aktivieren. Verwenden Sie den Parameter SQLSERVER, um aus Microsoft SQL Server zu übersetzen.

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

   Verwenden Sie die folgende Abfrage, um die SQL-Übersetzungssprache für Ihre Session zu prüfen:

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

   Weitere Informationen finden Sie unter Prozedur ENABLE_TRANSLATION.

3. SQL Server-SQL-Anweisungen eingeben Beispiele:

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

   Dadurch wird die SQL Server-Anweisung CREATE TABLE automatisch übersetzt und ausgeführt.

   Sie können dies mit dem Befehl DESC überprüfen. Beispiele:

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

   Die Tabelle MOVIE wird erstellt, und die Datentypen jeder Spalte werden automatisch in Oracle-Datentypen konvertiert.
4. Fügen Sie Daten in die Tabelle MOVIE ein. Beispiele:

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

   Prüfen Sie die Dateneinfügung, indem Sie die Tabelle MOVIE abfragen. Beispiele:

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

5. Erstellen Sie eine INVENTORY-Tabelle:

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

   Sie können diesen Schritt mit dem Befehl DESC prüfen. Beispiele:

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

   Die Tabelle INVENTORY wird erstellt, und die Datentypen jeder Spalte werden automatisch in Oracle-Datentypen konvertiert.
6. Fügen Sie Daten in die Tabelle INVENTORY ein. Beispiele:

   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.

   Prüfen Sie die Dateneinfügung, indem Sie INVENTORY abfragen. Beispiele:

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

7. Führen Sie einen linken Outer Join für die Tabellen MOVIE und INVENTORY aus:

   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
   

   In diesem Beispiel wird ein LEFT OUTER JOIN für die Tabellen movie und inventory ausgeführt. Die Abfrage wird zuerst in Oracle SQL übersetzt und dann in Ihrer Session ausgeführt.

8. Verwenden Sie die Prozedur DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION, um die SQL-Sprachübersetzung in Echtzeit für Ihre Session zu deaktivieren.

   BEGIN
    DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
   END;
   /

   Dies gibt einen Fehler zurück, wenn die SQL-Sprachübersetzung für Ihre Session nicht aktiviert ist.

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

Sie können eine Datei mit SQL Server-Anweisungen in eine Datei mit Oracle SQL-Anweisungen migrieren.

1. Melden Sie sich bei Ihrer Autonomous Database-Instanz an.

   Weitere Informationen finden Sie unter Verbindung zu Autonomous Database herstellen.

2. Konfigurieren Sie den Zugriff auf Cloud-Objektspeicher mit einem Resource Principal oder durch Erstellen eines Zugangsdatenobjekts.

   Dieser Schritt bietet Zugriff auf den Cloud-Objektspeicher, in dem Sie die zu migrierenden Dateien ablegen:

   • Mit einem Resource Principal auf Cloud Object Storage zugreifen:

     Definieren Sie Policys und Rollen für den Zugriff auf Oracle Cloud Infrastructure Object Storage mit einem Resource Principal. Weitere Informationen finden Sie unter Resource Principal für den Zugriff auf Oracle Cloud Infrastructure-Ressourcen verwenden und Resource Principal mit DBMS_CLOUD verwenden.

     Wenn sich Ihre Dateien im Cloud-Objektspeicher eines anderen Anbieters befinden, definieren Sie die entsprechenden Policys und Rollen für den Zugriff auf die Ressource. Weitere Informationen finden Sie unter Policys und Rollen für den Zugriff auf Ressourcen konfigurieren.

   • Erstellen Sie Zugangsdaten für den Zugriff auf Cloud Object Storage:

     Sie können Zugangsdaten für den Zugriff auf Cloud Object Storage erstellen.

     Beispiele:

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

     Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

3. Optional können Sie die Dateien in Object Storage auflisten. Beispiele:

   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
   

   Wenn Sie alternativ Zugangsdaten anstelle des Resource Principals OCI$RESOURCE_PRINCIPAL erstellen, geben Sie den Zugangsdatennamen im Parameter credential_name an.

   Weitere Informationen finden Sie unter Funktion LIST_OBJECTS.

4. Führen Sie DBMS_CLOUD_MIGRATION.MIGRATE_FILE aus, um die SQL Server-Datei in Oracle SQL zu migrieren:

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

   Der Parameter credential_name gibt die Zugangsdaten für den Zugriff auf die Cloud-Objektspeicher-URI an. Der Benutzer, der DBMS_CLOUD_MIGRATION.MIGRATE_FILE ausführt, muss über die Berechtigung EXECUTE für das Zugangsdatenobjekt verfügen, das für den Zugriff auf die Object Storage-URI verwendet wird. Das heißt, die Zugangsdaten, die Sie mit dem Parameter credential_name angeben. Wenn Sie Zugangsdaten anstelle eines Resource Principals verwenden, geben Sie den Zugangsdatennamen im Parameter credential_name an.

   Der Parameter location_uri gibt den URI der Quelldatei an. Das Format der URI ist vom verwendeten Cloud-Object Storage-Service abhängig. Weitere Informationen finden Sie unter DBMS_CLOUD URI-Formate.

   Der Parameter source_db gibt SQL Server als Datenbanksprache an. Verwenden Sie den Wert SQLSERVER, um SQL Server-Dateien in Oracle SQL zu übersetzen.

   Durch Ausführung dieses Befehls wird die SQL Server-Datei mssqltest.sql in Oracle SQL übersetzt und eine neue Datei mit dem Namen original_filename_oracle.sql generiert.

   In diesem Beispiel generiert die Ausführung von DBMS_CLOUD_MIGRATION.MIGRATE_FILE mit der Eingabedatei mssqltest.sql mssqltest_oracle.sql. Nach dem Übersetzungsschritt lädt die Prozedur mssqltest_oracle.sql in Object Storage hoch.

   Optional können Sie mit dem Parameter target_uri den Speicherort angeben, in den die übersetzte Datei hochgeladen wird. Der Standardwert für diesen Parameter ist NULL. Das bedeutet, dass die übersetzte Datei in denselben Speicherort hochgeladen wird, wie im Parameter location_uri angegeben.

   Weitere Informationen finden Sie unter Prozedur MIGRATE_FILE.

5. Prüfen Sie, ob die Ausgabedatei generiert wurde.

   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
   

   Wenn Sie alternativ Zugangsdaten anstelle des Resource Principals OCI$RESOURCE_PRINCIPAL erstellen, geben Sie den Zugangsdatennamen im Parameter credential_name an.

   Weitere Informationen finden Sie unter Funktion 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;

In diesem Abschnitt werden die Einschränkungen für die Migration von SQL-Anweisungen von SQL Server zu Oracle SQL zusammengefasst.