Documentation sur Oracle Cloud Infrastructure

Ensemble DBMS_CLOUD_MIGRATION

L'ensemble DBMS_CLOUD_MIGRATION facilite la traduction du code SQL d'une version SQL non Oracle vers Oracle SQL.

Rubrique parent : Informations de référence sur les ensembles fournis avec Autonomous AI Database

Sommaire des sous-programmes DBMS_CLOUD_MIGRATION

Ce tableau résume les sous-programmes inclus dans l'ensemble DBMS_CLOUD_MIGRATION.

Sous-programme Description

MIGRATE_SQL Procédure et fonction

MIGRATE_SQL facilite la traduction des énoncés SQL écrits en langage SQL non Oracle vers Oracle SQL. Les variantes SQL prises en charge sont PostgreSQL, MySQL et SQL Server.

MIGRATE_FILE Procédure

Cette procédure convertit en entrée un fichier contenant des instructions SQL provenant d'une base de données source spécifique et les convertit en instructions SQL Oracle.

ENABLE_TRANSLATION Procédure

Cette procédure permet la traduction SQL en temps réel et l'exécution d'énoncés SQL non Oracle dans une base de données autonome d'IA. Les variantes SQL prises en charge sont PostgreSQL, MySQL et SQL Server.

DISABLE_TRANSLATION Procédure

Cette procédure désactive la traduction du langage SQL.
  • MIGRATE_SQL Procédure et fonction
    La commande MIGRATE_SQL facilite la traduction des énoncés SQL écrits en SQL non Oracle vers Oracle SQL. Cette procédure est surchargée et a des variantes de fonction et de procédure.
  • Procédure MIGRATE_FILE
    MIGRATE_FILE prend en entrée un fichier contenant les énoncés SQL d'une base de données source spécifiée et les traduit en SQL Oracle.
  • Procédure ENABLE_TRANSLATION
    La procédure ENABLE_TRANSLATION permet la traduction SQL en temps réel et l'exécution d'énoncés SQL non Oracle dans votre base de données d'IA autonome.
  • Procédure DISABLE_TRANSLATION
    La procédure DISABLE_TRANSLATION désactive la traduction en langage SQL. Une erreur est retournée si la traduction de la langue SQL n'est pas activée pour votre session.

Rubrique parent : Ensemble DBMS_CLOUD_MIGRATION

MIGRATE_SQL Procédure et fonction

MIGRATE_SQL facilite la traduction des énoncés SQL écrits en langage SQL non Oracle vers Oracle SQL. Cette procédure est surchargée et a des variantes de fonction et de procédure.

Syntaxe 

DBMS_CLOUD_MIGRATION.MIGRATE_SQL (
   original_sql  IN  CLOB,
   output_sql    OUT CLOB,
   source_db     IN  VARCHAR2);

DBMS_CLOUD_MIGRATION.MIGRATE_SQL (
   original_sql  IN  CLOB,
   source_db     IN  VARCHAR2);
RETURN CLOB;

Paramètres

Paramètre Description

original_sql

Spécifie l'énoncé SQL initial dans la base de données source qui doit être traduit dans Oracle SQL.

Ce paramètre est obligatoire.

output_sql

Retourne l'énoncé SQL traduit.

Ce paramètre est obligatoire.

source_db

Spécifie le nom de la base de données source. Les valeurs valides pour ce paramètre sont POSTGRES, MYSQL, SQLSERVER.

Ce paramètre est obligatoire.

Valeurs retournées

Le formulaire de fonction DBMS_CLOUD_MIGRATION.MIGRATE_SQL retourne une valeur CLOB qui contient la version Oracle SQL traduite de l'entrée ORIGINAL_SQL.

Notes d'utilisation

Exemples

Formulaire de procédure de DBMS_CLOUD_MIGRATION.MIGRATE_SQL pour traduire l'énoncé PostgreSQL en SQL Oracle : 

BEGIN
  DBMS_CLOUD_MIGRATION.MIGRATE_SQL(      
    original_sql => 'SELECT e.employee_id, e.last_name, e.salary FROM employees AS e;',
    output_sql   => output_variable,
    source_db    => 'POSTGRES');
END;        
/

Formulaire de fonction de DBMS_CLOUD_MIGRATION.MIGRATE_SQL pour traduire l'énoncé PostgreSQL en SQL Oracle : 

SELECT DBMS_CLOUD_MIGRATION.MIGRATE_SQL
    ('CREATE TABLE IF NOT EXISTS cars (brand VARCHAR(255), model VARCHAR(255), year INT)', 'POSTGRES') AS output 
    FROM DUAL;

OUTPUT
------------------------------------------------------------------------------
create table cars (brand VARCHAR2(255), model VARCHAR2(255), year NUMBER(10);

MIGRATE_FILE Procédure

MIGRATE_FILE prend en entrée un fichier contenant les énoncés SQL d'une base de données source spécifiée et les traduit en SQL Oracle.

Syntaxe 

DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
    credential_name  IN VARCHAR2,
    location_uri     IN VARCHAR2,
    target_uri       IN VARCHAR2 DEFAULT NULL,
    source_db        IN VARCHAR2,
    params           IN CLOB

Paramètres

Paramètre Description

credential_name

Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage.

Ce paramètre est obligatoire.

Facultativement, les données d'identification que vous utilisez pour accéder à votre magasin d'objets en nuage peuvent être définies en configurant des politiques et des rôles. Pour plus d'informations, voir Configurer les politiques et les rôles pour accéder aux ressources.

location_uri

URI du fichier source. Le format de l'URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour des détails, voir Formats d'URI DBMS_CLOUD.

Ce paramètre est obligatoire.

target_uri

URI du fichier cible, où le fichier traduit doit être stocké. Si vous n'indiquez pas de valeur pour ce paramètre, le fichier traduit est stocké au même emplacement que le fichier source.

Le format de l'URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour des détails, voir Formats d'URI DBMS_CLOUD.

source_db

Spécifie la langue de la base de données source. Les valeurs valides pour ce paramètre sont POSTGRES, MYSQL, SQLSERVER.

Ce paramètre est obligatoire.
params

Spécifie les paramètres supplémentaires qui peuvent être transmis au format JSON.

Notes d'utilisation

  • Pour exécuter DBMS_CLOUD_MIGRATION.MIGRATE_FILE, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_MIGRATION.

  • Le paramètre credential_name spécifie les données d'identification permettant d'accéder à l'URI du service de stockage d'objets en nuage. L'utilisateur qui exécute DBMS_CLOUD_MIGRATION.MIGRATE_FILE.doit disposer du privilège EXECUTE pour l'objet de données d'identification utilisé pour accéder à l'URI du service de stockage d'objets. Autrement dit, les données d'identification que vous spécifiez avec le paramètre credential_name.

Exemple 

BEGIN
 DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
     credential_name => 'OBJ_STORE_CRED',
     location_uri    => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files/postgrestest.sql',
     source_db       => 'POSTGRES'
    );
END;
/

Le paramètre credential_name spécifie les données d'identification permettant d'accéder à l'URI du service de stockage d'objets en nuage.

location_uri est l'URI du fichier source. Le format de l'URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour plus d'informations, voir Formats d'URI DBMS_CLOUD.

Dans cet exemple, namespace-string est l'espace de noms du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

ENABLE_TRANSLATION Procédure

La procédure ENABLE_TRANSLATION permet la traduction SQL en temps réel et l'exécution d'énoncés SQL non Oracle dans votre base de données d'intelligence artificielle autonome.

Syntaxe

Paramètres

DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION (
   source_db  IN  VARCHAR2);
Paramètre Description

source_db

Spécifie la langue de la base de données source. Les valeurs valides pour ce paramètre sont POSTGRES, MYSQL, SQLSERVER.

Ce paramètre est obligatoire.

Note d'utilisation

  • Pour exécuter DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_MIGRATION.

Exemple 

BEGIN
  DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION (source_db => 'POSTGRES');
END;        
/

DISABLE_TRANSLATION Procédure

La procédure DISABLE_TRANSLATION désactive la traduction du langage SQL. Une erreur est retournée si la traduction de la langue SQL n'est pas activée pour votre session.

Syntaxe 

DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION();

Note d'utilisation

  • Pour exécuter DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_MIGRATION.

Exemple 

BEGIN
  DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION();
END;        
/