Anwendungen von SQL Server-Datenbanken in autonome KI-Datenbank migrieren
Sie können SQL-Anweisungen von SQL Server zu Oracle SQL migrieren und die Anweisungen in Autonomous AI Database ausführen.
SQL Server-Anweisungen in Oracle SQL übersetzen
Sie können in SQL Server geschriebene SQL-Anweisungen in Oracle SQL übersetzen und die übersetzten Anweisungen in Autonomous AI Database ausführen.
Mit DBMS_CLOUD_MIGRATION.MIGRATE_SQL können Sie eine SQL Server-Anweisung in Oracle SQL übersetzen. Es gibt Prozedur- und Funktionsvarianten von DBMS_CLOUD_MIGRATION.MIGRATE_SQL.
SQL Server-Anweisung mit der Prozedur MIGRATE_SQL in Oracle SQL migrieren
Im folgenden Beispiel wird die in SQL Server geschriebene SQL-Anweisung als Eingabe akzeptiert, die Anweisung in Oracle SQL übersetzt, die übersetzte SQL-Anweisung output_sql_result zugewiesen und das Ergebnis ausgegeben:
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));Der Parameter original_sql gibt die SQL Server-Anweisung an.
Der Parameter output_sql speichert die übersetzte SQL.
Der Parameter source_db gibt die SQL Server-Datenbank an.
Weitere Informationen finden Sie unter MIGRATE_SQL - Prozedur und Funktion.
SQL Server-Anweisung mit der Funktion MIGRATE_SQL zu Oracle SQL migrieren
Das folgende Beispiel zeigt die Funktion DBMS_CLOUD_MIGRATION.MIGRATE_SQL innerhalb einer SELECT-Anweisung. Die Funktionseingabe ist eine SQL Server-Anweisung, und die Funktion gibt die übersetzte Anweisung in Oracle SQL zurück:
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));Verwenden Sie den Parameter SQLSERVER, um aus Microsoft SQL Server zu übersetzen.
Weitere Informationen finden Sie unter MIGRATE_SQL - Prozedur und Funktion.
Hinweise zur Ausführung von DBMS_CLOUD_MIGRATION.MIGRATE_SQL:
-
Bei der Übersetzung kann ein Fehler auftreten, wenn die SQL-Eingabeanweisung in Oracle SQL nicht unterstützt wird. Weitere Informationen finden Sie unter Einschränkungen bei der Migration und Übersetzung von SQL Server-Anweisungen in Oracle SQL.
-
Die Unterprogramme
DBMS_CLOUD_MIGRATION.MIGRATE_SQLakzeptieren nur eine SQL-Anweisung als Eingabe. Pro Aufruf kann also nur eine einzelne SQL-Anweisung übersetzt werden.
SQL Server-Anweisungen in autonomer KI-Datenbank ausführen
Sie können SQL Server-Anweisungen interaktiv in Ihrer autonomen KI-Datenbank übersetzen und ausführen.
Verwenden Sie die Prozedur ENABLE_TRANSLATION, um die Echtzeitübersetzung von in SQL Server geschriebenen SQL-Anweisungen zu aktivieren. Nachdem Sie die Übersetzung in einer Session aktiviert haben, werden Nicht-Oracle-SQL-Anweisungen automatisch übersetzt und als Oracle-SQL-Anweisungen ausgeführt. Die Ergebnisse werden angezeigt.
Beispiel: Nachdem Sie die Übersetzung aktiviert haben, indem Sie ENABLE_TRANSLATION ausführen, können Sie in einer Session interaktiv Folgendes ausführen:
-
Tabellen erstellen. Beispiel: Erstellen Sie die Tabellen
MOVIEundINVENTORY. -
Daten in Tabellen einfügen
-
Abfragetabellen
-
JOIN-Vorgänge für Tabellen ausführen Beispiel: Sie können einen linken Outer Join für Tabellen ausführen.
So aktivieren Sie die Übersetzung mit SQL Server-Anweisungen und führen Befehle aus:
-
Stellen Sie mit einem SQL-Client eine Verbindung zu Ihrer autonomen KI-Datenbank her.
Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.
Hinweis
Hinweis:DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATIONwird in Database Actions nicht unterstützt und nicht mit dem Oracle APEX-Service unterstützt. - Führen Sie
DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATIONaus, um die Echtzeit-SQL-Übersetzung in Ihrer Session zu aktivieren. Verwenden Sie den ParameterSQLSERVER, 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 ENABLE_TRANSLATION Procedure.
-
SQL Server-SQL-Anweisungen eingeben Beispiel:
CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20)); Table [dbo].[movie] created.Dadurch wird die SQL Server-Anweisung
CREATE TABLEautomatisch übersetzt und ausgeführt.Sie können die Prüfung mit dem Befehl
DESCdurchführen. Beispiel:DESC movie; Name Null? Type ------- ----- ------------- FILM_ID NUMBER(38) TITLE VARCHAR2(255)Die Tabelle
MOVIEwird erstellt, und die Datentypen jeder Spalte werden automatisch in Oracle-Datentypen konvertiert. -
Daten in die Tabelle
MOVIEeinfügen. Beispiel: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
MOVIEabfragen. Beispiel:SELECT * FROM movie; FILM_ID TITLE -------- --------- 123 Tangled 234 Frozen -
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
DESCprüfen. Beispiel:DESC inventory; Name Null? Type ------- ----- ------------- FILM_ID NUMBER(38) INVENTORY_ID NUMBER(38)Die Tabelle
INVENTORYwird erstellt, und die Datentypen jeder Spalte werden automatisch in Oracle-Datentypen konvertiert. -
Daten in die Tabelle
INVENTORYeinfügen. Beispiel: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
INVENTORYabfragen. Beispiel:SELECT * FROM inventory; FILM_ID INVENTORY_ID -------- ------------- 123 223 234 334 -
Führen Sie einen linken Outer Join für die Tabellen
MOVIEundINVENTORYaus: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 223In diesem Beispiel wird eine
LEFT OUTER JOINfür die Tabellenmovieundinventoryausgeführt. Die Abfrage wird zuerst in Oracle SQL übersetzt und dann in der Session ausgeführt. -
Verwenden Sie die Prozedur
DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION, um die Echtzeit-SQL-Sprachübersetzung für Ihre Session zu deaktivieren.BEGIN DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION; END; /Dies gibt einen Fehler zurück, wenn die Übersetzung der SQL-Sprache für Ihre Session nicht aktiviert ist.
Sie können die View V$MAPPED_SQL abfragen, um die SQL Server-Anweisungen aufzulisten, die in Oracle SQL-Anweisungen übersetzt und im Speicher zugeordnet werden.
Beispiel:
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';Weitere Informationen finden Sie unter V$MAPPED_SQL.
SQL Server-Dateien zu Oracle SQL migrieren
Sie können eine Datei mit SQL Server-Anweisungen in eine Datei mit Oracle SQL-Anweisungen migrieren.
Die Prozedur DBMS_CLOUD_MIGRATION.MIGRATE_FILE übersetzt SQL-Anweisungen in eine SQL Server-Datei in Object Storage und generiert eine neue Datei mit Oracle SQL.
Als Voraussetzung müssen Sie eine oder mehrere SQL Server-Dateien mit der Erweiterung .sql in einen Speicherort in Object Storage hochladen. In den folgenden Beispielen wird die Datei mssqltest.sql verwendet, die in Object Storage hochgeladen wird. Weitere Informationen finden Sie unter Daten in Objektspeicher einfügen.
So migrieren Sie SQL Server-Dateien zu Oracle SQL:
-
Stellen Sie eine Verbindung zur autonomen KI-Datenbankinstanz her.
Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.
-
Konfigurieren Sie den Zugriff auf Cloud Object Storage mit einem Resource Principal oder durch Erstellen eines Zugangsdatenobjekts.
Dieser Schritt bietet Zugriff auf den Cloud Object Storage, in dem Sie die zu migrierenden Dateien ablegen:
-
Ressourcen-Principal für den Zugriff auf Cloud Object Storage verwenden:
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 Object Storage eines anderen Herstellers befinden, definieren Sie die entsprechenden Policys und Rollen für den Zugriff auf die Ressource. Weitere Informationen finden Sie unter Policys und Rollen zum 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.
Beispiel:
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.
-
-
Optional können Sie die Dateien in Object Storage auflisten. Beispiel:
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.sqlWenn Sie alternativ Zugangsdaten anstelle des Resource Principals
OCI$RESOURCE_PRINCIPALerstellen, geben Sie den Zugangsdatennamen im Parametercredential_namean.Weitere Informationen finden Sie unter Funktion LIST_OBJECTS.
-
Führen Sie
DBMS_CLOUD_MIGRATION.MIGRATE_FILEaus, 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_namegibt die Zugangsdaten für den Zugriff auf die Cloud-Objektspeicher-URI an. Der Benutzer, derDBMS_CLOUD_MIGRATION.MIGRATE_FILEausführt, muss die BerechtigungEXECUTEfür das Zugangsdatenobjekt haben, das für den Zugriff auf die Object Storage-URI verwendet wird. Das heißt, die Zugangsdaten, die Sie mit dem Parametercredential_nameangeben. Wenn Sie Zugangsdaten anstelle eines Resource Principals verwenden, geben Sie den Zugangsdatennamen im Parametercredential_namean.Der Parameter
location_urigibt die Quelldatei-URI an. Das Format der URI hängt vom verwendeten Cloud-Objektspeichersystem ab. Weitere Informationen finden Sie unter DBMS_CLOUD URI-Formate.Der Parameter
source_dbgibt SQL Server als Datenbanksprache an. Verwenden Sie den WertSQLSERVER, um SQL Server-Dateien in Oracle SQL zu übersetzen.Wenn Sie diesen Befehl ausführen, wird die SQL Server-Datei
mssqltest.sqlin Oracle SQL übersetzt und eine neue Datei mit dem Namen original_filename_oracle.sqlgeneriert.In diesem Beispiel generiert die Ausführung von
DBMS_CLOUD_MIGRATION.MIGRATE_FILEmit der Eingabedateimssqltest.sqlmssqltest_oracle.sql. Nach dem Übersetzungsschritt lädt die Prozedurmssqltest_oracle.sqlin Object Storage hoch.Verwenden Sie optional den Parameter
target_uri, um den Speicherort anzugeben, in den die übersetzte Datei hochgeladen wird. Der Standardwert für diesen Parameter istNULL. Das bedeutet, dass die übersetzte Datei an denselben Speicherort hochgeladen wird, wie im Parameterlocation_uriangegeben.Weitere Informationen finden Sie unter Prozedur MIGRATE_FILE.
-
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.sqlWenn Sie alternativ Zugangsdaten anstelle des Resource Principals
OCI$RESOURCE_PRINCIPALerstellen, geben Sie den Zugangsdatennamen im Parametercredential_namean.Weitere Informationen finden Sie unter Funktion LIST_OBJECTS.
Führen Sie die folgende Abfrage aus, um den Inhalt der Datei mssqltest_oracle.sql anzuzeigen:
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;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 GET_OBJECT-Prozedur und -Funktion.
Einschränkungen bei Migration und Übersetzung von SQL Server-Anweisungen in Oracle SQL
In diesem Abschnitt werden die Einschränkungen für die Migration von SQL-Anweisungen von SQL Server zu Oracle SQL zusammengefasst.
Die folgende Liste von SQL Server-Funktionen wird bei der Migration von SQL Server-Datenbank-Flavor zu Oracle SQL nicht unterstützt:
-
ISJSON() -
OPENJSON()